tools-for-js 1.4.0 → 1.4.1

package/README.md

@@ -62,4 +62,8 @@ import { API } from 'tools-for-js'
 | 随机颜色                                         | randomColor       |
 | 创建 UUID                                        | createUUID        |
 | 随机 MAC 地址                                    | randomMac         |
+| 随机索引                                         | randomIndex       |
+| 随机数组中的值                                   | randomEnum        |
+| 随机数组中的 n 个值                              | randomNumEnum     |
+| 随机指定范围的整数                               | randomIntRange    |
 | 待更新                                           | function          |

package/lib/index.js

@@ -195,6 +195,24 @@ Object.defineProperty(exports, "randomColor", {
     return _random.randomColor;
   }
 });
+Object.defineProperty(exports, "randomEnum", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomEnum;
+  }
+});
+Object.defineProperty(exports, "randomIndex", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomIndex;
+  }
+});
+Object.defineProperty(exports, "randomIntRange", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomIntRange;
+  }
+});
 Object.defineProperty(exports, "randomMac", {
   enumerable: true,
   get: function get() {
@@ -207,6 +225,12 @@ Object.defineProperty(exports, "randomNum", {
     return _random.randomNum;
   }
 });
+Object.defineProperty(exports, "randomNumEnum", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomNumEnum;
+  }
+});
 Object.defineProperty(exports, "replacePath", {
   enumerable: true,
   get: function get() {

package/lib/utils/random.js

@@ -5,7 +5,55 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.randomCode = exports.createUUID = void 0;
 exports.randomColor = randomColor;
-exports.randomNum = exports.randomMac = void 0;
+exports.randomNumEnum = exports.randomNum = exports.randomMac = exports.randomIntRange = exports.randomIndex = exports.randomEnum = void 0;
+/*******
+ * @description: 随机索引
+ * @author: 琴时
+ * @param {*} length [长度] [默认为10==>0~9]
+ * @return {*}
+ */
+var randomIndex = exports.randomIndex = function randomIndex() {
+  var length = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 10;
+  return Math.floor(Math.random() * length);
+};
+
+/*******
+ * @description: 创建UUID
+ * UUID(Universally Unique IDentifier) 全局唯一标识符。
+ * UUID是一种由算法生成的二进制长度为128位的数字标识符。
+ * UUID的格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”，
+ * 其中的 x 是 0-9 或 a-f 范围内的一个32位十六进制数。
+ * 在理想情况下，任何计算机和计算机集群都不会生成两个相同的UUID。
+ * @author: 琴时
+ * @param {String} symbol [分隔符] [默认为空]
+ * @return {String}
+ * @example: createUUID('-') // 生成UUID并使用[-]作为分隔符
+ */
+var createUUID = exports.createUUID = function createUUID() {
+  var symbol = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  var s = [];
+  var hexDigits = '0123456789abcdef';
+  for (var i = 0; i < 36; i++) {
+    s[i] = hexDigits.charAt(randomIndex(16));
+  }
+  s[14] = '4'; // bits 12-15 of 时间和版本字段设置为0010
+  s[19] = hexDigits.charAt(s[19] & 3 | 8); // bits 6-7 of the clock_seq_hi_and_reserved to 01
+  s[8] = s[13] = s[18] = s[23] = '-';
+  return s.join('').replace(/-/g, symbol);
+};
+
+/*******
+ * @description: 随机MAC地址
+ * @author: 琴时
+ * @return {String}
+ */
+var randomMac = exports.randomMac = function randomMac() {
+  return 'XX:XX:XX:XX:XX:XX'.replace(/X/g, function () {
+    var hexDigits = '0123456789ABCDEF';
+    return hexDigits.charAt(randomIndex(16));
+  });
+};
+
 /*******
  * @description: 随机数字
  * @author: 琴时
@@ -17,7 +65,7 @@ var randomNum = exports.randomNum = function randomNum() {
   var result = '';
   var decimalDigits = '0123456789';
   for (var i = 0; i < length; i++) {
-    var index = Math.floor(Math.random() * 10); //随机生成一位0~9的数
+    var index = randomIndex(10); //随机生成一位0~9的数
     result += decimalDigits.charAt(index);
   }
   return result;
@@ -37,7 +85,7 @@ var randomCode = exports.randomCode = function randomCode() {
   var capital = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
   var character = num + lower + capital;
   for (var i = 0; i < length; i++) {
-    var index = Math.floor(Math.random() * character.length); //随机生成一位0~61的数
+    var index = randomIndex(character.length); //随机生成一位0~61的数
     result += character.charAt(index);
   }
   return result;
@@ -54,7 +102,7 @@ function randomColor() {
   var hexDigits = '0123456789ABCDEF';
   var color = '#';
   for (var i = 0; i < 6; i++) {
-    var index = Math.floor(Math.random() * 16); //随机生成一位0~15的数
+    var index = randomIndex(16); //随机生成一位0~15的数
     color += hexDigits.charAt(index);
   }
   //如果生成的颜色和默认颜色重复了，则重新生成
@@ -63,38 +111,45 @@ function randomColor() {
 }
 
 /*******
- * @description: 创建UUID
- * UUID(Universally Unique IDentifier) 全局唯一标识符。
- * UUID是一种由算法生成的二进制长度为128位的数字标识符。
- * UUID的格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”，
- * 其中的 x 是 0-9 或 a-f 范围内的一个32位十六进制数。
- * 在理想情况下，任何计算机和计算机集群都不会生成两个相同的UUID。
+ * @description: 随机数组中的值
  * @author: 琴时
- * @param {String} symbol [分隔符] [默认为空]
- * @return {String}
- * @example: createUUID('-') // 生成UUID并使用[-]作为分隔符
+ * @param {Array} list
+ * @return {*}
  */
-var createUUID = exports.createUUID = function createUUID() {
-  var symbol = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '-';
-  var s = [];
-  var hexDigits = '0123456789abcdef';
-  for (var i = 0; i < 36; i++) {
-    s[i] = hexDigits.charAt(Math.floor(Math.random() * 16));
+var randomEnum = exports.randomEnum = function randomEnum() {
+  var list = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  return list[randomIndex(list.length)];
+};
+
+/*******
+ * @description: 随机数组中的n个值
+ * @author: 琴时
+ * @param {*} array
+ * @param {*} num
+ * @return {Array}
+ */
+var randomNumEnum = exports.randomNumEnum = function randomNumEnum(array, num) {
+  var shuffled = array.slice(0),
+    i = array.length,
+    min = i - num,
+    temp,
+    index;
+  while (i-- > min) {
+    index = Math.floor((i + 1) * Math.random());
+    temp = shuffled[index];
+    shuffled[index] = shuffled[i];
+    shuffled[i] = temp;
   }
-  s[14] = '4'; // bits 12-15 of 时间和版本字段设置为0010
-  s[19] = hexDigits.charAt(s[19] & 3 | 8); // bits 6-7 of the clock_seq_hi_and_reserved to 01
-  s[8] = s[13] = s[18] = s[23] = '-';
-  return s.join('').replace(/-/g, symbol);
+  return shuffled.slice(min);
 };
 
 /*******
- * @description: 随机MAC地址
+ * @description: 随机指定范围的整数
  * @author: 琴时
- * @return {String}
+ * @param {Number} min [最小值]
+ * @param {Number} max [最大值]
+ * @return {Number} 随机值
  */
-var randomMac = exports.randomMac = function randomMac() {
-  return 'XX:XX:XX:XX:XX:XX'.replace(/X/g, function () {
-    var hexDigits = '0123456789ABCDEF';
-    return hexDigits.charAt(Math.floor(Math.random() * 16));
-  });
+var randomIntRange = exports.randomIntRange = function randomIntRange(min, max) {
+  return randomIndex(max - min + 1) + min;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-for-js",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "基于babel构建的javascript工具库",
   "main": "lib/index.js",
   "scripts": {