a-js-tools 2.0.0-alpha.0 → 2.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright (c) <2024> <earthnut.dev>
+Copyright (c) <2024> <Mr.MudBean>
     
 Permission to use, copy, modify, and/or distribute this software for any  
 purpose with or without fee is hereby granted, provided that the above  
@@ -16,7 +16,7 @@ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 # MIT 许可证
 
-版权所有 (c) [2024] [花生亻]
+版权所有 (c) [2024] [泥豆君]
 
 特此免费授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人不受限制地处置该软件的权利，包括不受限制地使用、复制、修改、合并、发布、分发、再许可和/或出售该软件副本的权利，并允许向其提供该软件的人这样做，但须遵守以下条件：
 

package/README.md

@@ -1,6 +1,6 @@
 # 一点点 🤏 js 函数
 
-[![version](<https://img.shields.io/npm/v/a-js-tools.svg?logo=npm&logoColor=rgb(0,0,0)&label=版本号&labelColor=rgb(73,73,228)&color=rgb(0,0,0)>)](https://www.npmjs.com/package/a-js-tools) [![Coverage Status](<https://img.shields.io/coverallsCoverage/github/earthnutDev/a-js-tools?logo=coveralls&label=coveralls&labelColor=rgb(12, 244, 39)&color=rgb(0,0,0)>)](https://coveralls.io/github/earthnutDev/a-js-tools?branch=main) [![codecov](<https://img.shields.io/codecov/c/github/earthnutDev/a-js-tools/main?logo=codecov&label=codecov&labelColor=rgb(7, 245, 245)&color=rgb(0,0,0)>)](https://codecov.io/gh/earthnutDev/a-js-tools) [![issues 提交](<https://img.shields.io/badge/issues-提交-rgb(255,0,63)?logo=github>)](https://github.com/earthnutDev/a-js-tools/issues)
+[![version](<https://img.shields.io/npm/v/a-js-tools.svg?logo=npm&logoColor=rgb(0,0,0)&label=版本号&labelColor=rgb(73,73,228)&color=rgb(0,0,0)>)](https://www.npmjs.com/package/a-js-tools) [![issues 提交](<https://img.shields.io/badge/issues-提交-rgb(255,0,63)?logo=github>)](https://github.com/MrMudBean/a-js-tools/issues)
 一个纯函数的工具
 
 ## 安装
@@ -11,8 +11,8 @@ npm install --save a-js-tools
 
 ## 纯函数
 
-- `lmDebounce` 防抖函数
-- `lmThrottle` 节流函数
+- `debounce` 防抖函数
+- `throttle` 节流函数
 - `getRandomInt` 获取随机的整数
 - `getRandomFloat` 获取随机的浮点数
 - `getRandomString` 获取随机字符串
@@ -37,4 +37,4 @@ npm install --save a-js-tools
 
 ## 查看文档
 
-查看 [https://earthnut.dev/a-js-tools](https://earthnut.dev/a-js-tools)
+查看 [https://earthnut.dev/npm/a-js-tools](https://earthnut.dev/npm/a-js-tools)

package/{src/array/difference.cjs → cjs/array/difference.js}

@@ -34,10 +34,12 @@ var aTypeOfJs = require('a-type-of-js');
  *
  */
 function difference(a, b) {
-    if ([a, b].some(e => !aTypeOfJs.isArray(e)))
+    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b)) {
         throw new TypeError('参数需为数组');
-    if ([a, b].some(e => aTypeOfJs.isEmptyArray(e)))
+    }
+    if (aTypeOfJs.isEmptyArray(a) || aTypeOfJs.isEmptyArray(b)) {
         return a;
+    }
     /**  获取两个数组中长度较小的  */
     // 参数有顺序要求
     // const [shorter, longer] = a.length > b.length ? [b, a] : [a, b];

package/{src/array/index.cjs → cjs/array/index.js}

@@ -1,9 +1,9 @@
 'use strict';
 
-var intersection = require('./intersection.cjs');
-var union = require('./union.cjs');
-var difference = require('./difference.cjs');
-var symmetricDifference = require('./symmetricDifference.cjs');
+var intersection = require('./intersection.js');
+var union = require('./union.js');
+var difference = require('./difference.js');
+var symmetricDifference = require('./symmetricDifference.js');
 
 /**
  *

package/{src/array/intersection.cjs → cjs/array/intersection.js}

@@ -24,11 +24,13 @@ var aTypeOfJs = require('a-type-of-js');
  *
  */
 function intersection(a, b) {
-    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b))
+    if (!aTypeOfJs.isArray(a) || !aTypeOfJs.isArray(b)) {
         throw new TypeError('参数必须是数组类型数据');
+    }
     // 任意数组为空，则返回空数组
-    if ([a, b].some(e => aTypeOfJs.isEmptyArray(e)))
+    if (aTypeOfJs.isEmptyArray(a) || aTypeOfJs.isEmptyArray(b)) {
         return [];
+    }
     /**
      * 在实际运算中， new Set() 的 开销为 O(n) ,filter 的开销也为 O(n)
      *

package/{src/array/symmetricDifference.cjs → cjs/array/symmetricDifference.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 var aTypeOfJs = require('a-type-of-js');
-var difference = require('./difference.cjs');
+var difference = require('./difference.js');
 
 /**
  *

package/{src/className.cjs → cjs/className.js}

@@ -34,9 +34,9 @@ initial = false) {
     /**  转化首字符   */
     const toTransform = (_str, _dividingType) => _str.replace(new RegExp(`${template.test(_dividingType) ? `\\${_dividingType}` : _dividingType}([a-zA-Z])`, 'g'), (match, p1) => p1.toUpperCase());
     // 多分隔符转化
-    dividingType.split('').forEach((item) => {
-        result = toTransform(result, item);
-    });
+    dividingType
+        .split('')
+        .forEach((item) => (result = toTransform(result, item)));
     return initial
         ? result.replace(/^./, (match) => match.toUpperCase())
         : result;

package/{src/getRandomNumber.cjs → cjs/getRandomNumber.js}

@@ -13,7 +13,7 @@ var aTypeOfJs = require('a-type-of-js');
  *
  * 获取一个随机的整数类型
  *
- * 您可以传入两个参数并获取它们之间的任意数字
+ * 您可以传入两个参数并获取它们之间的任意数字，返回值<span style="color:#ff0;">*会包含端值*</span>
  *
  * 如果只传递一个参数，则如果提供的值为负数，则得到一个小于（或大于）该数字的整数
  *
@@ -35,12 +35,12 @@ function getRandomInt(max = 1, min = 0) {
     let _min = Math.ceil(Number(min)), 
     /**  获取最大值  */
     _max = Math.floor(Number(max));
-    /**  两值交换  */
-    if (_min > _max)
-        [_max, _min] = [_min, _max];
-    //**  两值相等时，直接返回最大值  */
+    //  两值相等时，直接返回最大值
     if (_max === _min)
         return _max;
+    //  两值交换
+    if (_min > _max)
+        [_max, _min] = [_min, _max];
     return Math.round(Math.random() * (_max - _min) + _min);
 }
 /**

package/{src/getRandomString.cjs → cjs/getRandomString.js}

@@ -1,7 +1,8 @@
 'use strict';
 
 var aTypeOfJs = require('a-type-of-js');
-var isNode = require('./isNode.cjs');
+var createConstructor = require('./object/createConstructor.js');
+var getRandomNumber = require('./getRandomNumber.js');
 
 /**
  * 获取随机字符串
@@ -38,9 +39,8 @@ function getRandomString(options) {
         (aTypeOfJs.isPlainObject(options) &&
             (!aTypeOfJs.isNumber(options.length) ||
                 options.length < 1 ||
-                !Number.isInteger(options.length)))) {
+                !Number.isInteger(options.length))))
         throw new TypeError('参数类型错误 ❌ (getRandomString)');
-    }
     const initOptions = {
         length: 32,
         chars: 'abcdefghijklmnopqrstuvwxyz',
@@ -52,40 +52,43 @@ function getRandomString(options) {
         includeSpecial: false,
     };
     /// 生成 UUID
-    if (initOptions.type === 'uuid') {
+    if (initOptions.type === 'uuid')
         return crypto.randomUUID();
-    }
-    if (aTypeOfJs.isNumber(options) && Number.isInteger(options) && options > 0) {
-        // 验证输入参数
-        Object.assign(initOptions, { length: options });
-    }
+    // 验证输入参数
+    if (aTypeOfJs.isNumber(options) && Number.isInteger(options) && options > 0)
+        createConstructor.ObjectAssign(initOptions, { length: options });
     if (aTypeOfJs.isPlainObject(options)) {
-        Object.assign(initOptions, options);
+        createConstructor.ObjectAssign(initOptions, options);
         initOptions.length = initOptions.length < 1 ? 32 : initOptions.length;
     }
     /**  生成随机字符串  */
     const templateCharsArr = initOptions.chars.split('');
     // 添加大写字母
-    if (initOptions.includeUppercaseLetters) {
+    if (initOptions.includeUppercaseLetters)
         interleaveString(templateCharsArr, initOptions.chars.toUpperCase());
-    }
     // 添加数字
-    if (initOptions.includeNumbers) {
+    if (initOptions.includeNumbers)
         interleaveString(templateCharsArr, initOptions.chars2);
-    }
     // 添加特殊字符
-    if (initOptions.includeSpecial) {
+    if (initOptions.includeSpecial)
         interleaveString(templateCharsArr, initOptions.chars3);
-    }
-    // 使用密码学安全的随机数生成器
-    const bytes = isNode.isBrowser() && window.crypto
-        ? window.crypto.getRandomValues(new Uint8Array(initOptions.length))
-        : global.crypto.getRandomValues(new Uint8Array(initOptions.length));
+    /** 结果字符串 */
     let result = '';
-    /**  获取最后的 chars 数据  */
-    const chars = templateCharsArr.join('');
-    // 循环遍历
-    bytes.forEach(byte => (result += chars.charAt(byte % chars.length)));
+    /** 混淆后的字符串 */
+    const str = templateCharsArr.join('');
+    /** 混淆后字符长度 */
+    const strLen = str.length;
+    if (globalThis && globalThis.crypto && globalThis.crypto.getRandomValues) {
+        // 使用密码学安全的随机数生成器
+        const bytes = globalThis.crypto.getRandomValues(new Uint8Array(initOptions.length));
+        /**  获取最后的 chars 数据  */
+        // 循环遍历
+        bytes.forEach(byte => (result += str[byte % strLen]));
+    }
+    else {
+        for (let i = 0; i < initOptions.length; i++)
+            result += str[getRandomNumber.getRandomInt(strLen - 1)];
+    }
     /**
      *
      *  字符串交叉函数
@@ -112,6 +115,11 @@ function getRandomString(options) {
             }
         }
     }
+    /// 结果字符串不包含字符
+    if (!/[a-zA-Z]/.test(result))
+        return String.fromCharCode(getRandomNumber.getRandomInt(97, 122)).concat(result.slice(1));
+    while (!/^[a-zA-Z]$/.test(result[0]))
+        result = result.slice(1) + result[0];
     return result;
 }
 

package/{index.cjs → cjs/index.js}

@@ -1,27 +1,28 @@
 'use strict';
 
-var createConstructor = require('./src/object/createConstructor.cjs');
-var getRandomNumber = require('./src/getRandomNumber.cjs');
-var className = require('./src/className.cjs');
-var getRandomString = require('./src/getRandomString.cjs');
-var performance = require('./src/performance.cjs');
-var escapeRegExp = require('./src/regexp/escapeRegExp.cjs');
-var autoEscapedRegExp = require('./src/regexp/autoEscapedRegExp.cjs');
-var isNode = require('./src/isNode.cjs');
-var index = require('./src/array/index.cjs');
-var sleep = require('./src/sleep.cjs');
-var intersection = require('./src/array/intersection.cjs');
-var union = require('./src/array/union.cjs');
-var difference = require('./src/array/difference.cjs');
-var symmetricDifference = require('./src/array/symmetricDifference.cjs');
+var className = require('./className.js');
+var createConstructor = require('./object/createConstructor.js');
+var getRandomNumber = require('./getRandomNumber.js');
+var getRandomString = require('./getRandomString.js');
+var performance = require('./performance.js');
+var escapeRegExp = require('./regexp/escapeRegExp.js');
+var autoEscapedRegExp = require('./regexp/autoEscapedRegExp.js');
+var isNode = require('./isNode.js');
+var index = require('./array/index.js');
+var sleep = require('./sleep.js');
+var intersection = require('./array/intersection.js');
+var union = require('./array/union.js');
+var difference = require('./array/difference.js');
+var symmetricDifference = require('./array/symmetricDifference.js');
 
 
 
+exports.toLowerCamelCase = className.toLowerCamelCase;
+exports.toSplitCase = className.toSplitCase;
+exports.ObjectAssign = createConstructor.ObjectAssign;
 exports.createConstructor = createConstructor.createConstructor;
 exports.getRandomFloat = getRandomNumber.getRandomFloat;
 exports.getRandomInt = getRandomNumber.getRandomInt;
-exports.toLowerCamelCase = className.toLowerCamelCase;
-exports.toSplitCase = className.toSplitCase;
 exports.getRandomString = getRandomString.getRandomString;
 exports.debounce = performance.debounce;
 exports.throttle = performance.throttle;

package/{src/isNode.cjs → cjs/isNode.js}

@@ -8,7 +8,11 @@ var aTypeOfJs = require('a-type-of-js');
  *
  */
 function isNode() {
-    return !aTypeOfJs.isUndefined(globalThis?.process?.versions?.node);
+    return !aTypeOfJs.isUndefined((globalThis &&
+        globalThis.process &&
+        globalThis.process.versions &&
+        globalThis.process.versions.node) ||
+        undefined);
 }
 /**
  *

package/{src/object/createConstructor.cjs → cjs/object/createConstructor.js}

@@ -38,7 +38,21 @@
  *
  */
 function createConstructor(constructor) {
+    constructor.prototype.apply = Function.apply;
+    constructor.prototype.bind = Function.bind;
+    constructor.prototype.call = Function.call;
+    constructor.prototype.length = Function.length;
+    // constructor.prototype.arguments = Function.arguments;
+    constructor.prototype.name = Function.name;
+    constructor.prototype.toString = Function.toString;
     return constructor;
 }
+/** 对象的 assign 用法 */
+function ObjectAssign(target, bar) {
+    const keys = Object.keys(bar);
+    keys.forEach(key => (target[key] = bar[key]));
+    return target;
+}
 
+exports.ObjectAssign = ObjectAssign;
 exports.createConstructor = createConstructor;

package/{src/performance.cjs → cjs/performance.js}

@@ -1,6 +1,8 @@
 'use strict';
 
 var aTypeOfJs = require('a-type-of-js');
+var isFunction = require('a-type-of-js/isFunction');
+var isNumber = require('a-type-of-js/isNumber');
 
 /**
  * 防抖和节流
@@ -13,7 +15,8 @@ var aTypeOfJs = require('a-type-of-js');
  *
  * 防抖
  *
- * @param options 使用参数
+ * @param   callback 回调函数
+ * @param   options    延迟时间（毫秒），默认 200 (ms) 或包含 this 的配置
  * @returns   返回的闭包函数
  * @example
  *
@@ -26,19 +29,17 @@ var aTypeOfJs = require('a-type-of-js');
  * }
  *
  */
-function debounce(options) {
-    if (aTypeOfJs.isFunction(options)) {
+function debounce(callback, options = 200) {
+    if (!isFunction.isFunction(callback))
+        throw new TypeError('callback must be a function');
+    if (isNumber.isNumber(options))
         options = {
-            callback: options,
-            delay: 200,
+            delay: options,
             this: null,
         };
-    }
-    if (!aTypeOfJs.isPlainObject(options) || !aTypeOfJs.isFunction(options.callback))
-        throw new TypeError('参数类型有误');
-    if (aTypeOfJs.isUndefined(options.delay))
-        options.delay = 200;
-    if (!isFinite(options.delay) || options.delay < 0)
+    if (aTypeOfJs.isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
         // 强制转换非数值
         options.delay = 200;
     /**  定时器返回的 id  */
@@ -53,60 +54,61 @@ function debounce(options) {
         clear();
         timeoutId = setTimeout(() => {
             try {
-                Reflect.apply(options.callback, options.this ?? null, args);
+                const _this = options && options.this ? options.this : null;
+                // 由于 Reflect.apply 并不能在 ES5 中使用，所以我们并不能保证能执行成功
+                callback.apply(_this, args);
+                // Reflect.apply(callback, options?.this ?? null, args);
             }
             catch (error) {
                 console.log('Debounce callback throw an error', error);
             }
-        }, Math.max(options.delay ?? 5, 5));
-    };
-    result.cancel = () => {
-        clear();
+        }, Math.max(options.delay || 5, 5));
     };
+    result.cancel = () => clear();
     return result;
 }
 /**
  *   节流
  *
- * @param options 使用的参数值
+ * @param callback   回调函数
+ * @param options      延迟时间（毫秒），默认 200 (ms) 或设置 this
  * @returns   返回的闭包函数
  */
-function throttle(options) {
-    if (aTypeOfJs.isFunction(options)) {
+function throttle(callback, options = 200) {
+    if (!isFunction.isFunction(callback))
+        throw new TypeError('callback must be a function');
+    if (isNumber.isNumber(options))
         options = {
-            callback: options,
-            delay: 200,
+            delay: options,
             this: null,
         };
-    }
-    if (!aTypeOfJs.isPlainObject(options) || !aTypeOfJs.isFunction(options.callback))
-        throw new TypeError('参数类型有误');
-    if (aTypeOfJs.isUndefined(options.delay))
-        options.delay = 200;
-    if (!isFinite(options.delay) || options.delay < 0)
+    if (aTypeOfJs.isUndefined(options.delay) ||
+        !isFinite(options.delay) ||
+        options.delay < 0)
         // 强制转换非数值
         options.delay = 200;
     /**  延迟控制插销   */
     let inThrottle = false;
     /**  延迟控制   */
     let timeoutId = null;
+    const delay = options && options.delay ? options.delay : 5;
     const throttled = (...args) => {
         if (inThrottle)
             return;
         try {
-            Reflect.apply(options.callback, options.this ?? null, args);
+            const _this = options && options.this ? options.this : null;
+            callback.apply(_this, args);
         }
         catch (error) {
-            console.error('Throttle callback throw an error', error);
+            console.error('Throttle 执行回调抛出问题', error);
         }
         inThrottle = true;
-        if (!aTypeOfJs.isNull(timeoutId)) {
+        if (!aTypeOfJs.isNull(timeoutId))
             clearTimeout(timeoutId);
-        }
         timeoutId = setTimeout(() => {
             inThrottle = false;
             timeoutId = null;
-        }, Math.max(options.delay ?? 5, 5));
+        }, Math.max(delay, 5));
     };
     throttled.cancel = () => {
         if (!aTypeOfJs.isNull(timeoutId)) {

package/{src/regexp/autoEscapedRegExp.cjs → cjs/regexp/autoEscapedRegExp.js}

@@ -1,8 +1,8 @@
 'use strict';
 
 var aTypeOfJs = require('a-type-of-js');
-var escapeRegExp = require('./escapeRegExp.cjs');
-var parse = require('./parse.cjs');
+var escapeRegExp = require('./escapeRegExp.js');
+var parse = require('./parse.js');
 
 /**
  *
@@ -35,14 +35,12 @@ var parse = require('./parse.cjs');
  *
  */
 function autoEscapedRegExp(pattern, options) {
-    if (!aTypeOfJs.isString(pattern)) {
+    if (!aTypeOfJs.isString(pattern))
         throw new TypeError('pattern must be a 字符串');
-    }
     pattern = escapeRegExp.escapeRegExp(pattern);
     /** 简单转化  */
-    if (aTypeOfJs.isUndefined(options)) {
+    if (aTypeOfJs.isUndefined(options))
         return new RegExp(pattern);
-    }
     options = parse.parse(options);
     return new RegExp(`${options.start ? '^' : ''}${pattern}${options.end ? '$' : ''}`, options.flags);
 }

package/{src/regexp/parse.cjs → cjs/regexp/parse.js}

@@ -15,19 +15,16 @@ function parse(options) {
         };
     }
     // 处理 flags
-    if (!aTypeOfJs.isString(options.flags)) {
+    if (!aTypeOfJs.isString(options.flags))
         options.flags = '';
-    }
     else {
         // 需求是保留字符串中的某一部分，使用
         const regexp = /[migsuy]/g;
         const matchResult = options.flags.match(regexp);
-        if (aTypeOfJs.isNull(matchResult)) {
+        if (aTypeOfJs.isNull(matchResult))
             options.flags = '';
-        }
-        else {
+        else
             options.flags = [...new Set(matchResult)].join('');
-        }
     }
     return options;
 }

package/{src/sleep.cjs → cjs/sleep.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var aTypeOfJs = require('a-type-of-js');
+var isNumber = require('a-type-of-js/isNumber');
 
 /**
  *
@@ -30,7 +30,7 @@ var aTypeOfJs = require('a-type-of-js');
 async function sleep(delay = 1000) {
     if (!isFinite(delay) || delay < 0)
         throw new TypeError('delay 应该是一个正常的数值');
-    if (aTypeOfJs.isZero(delay))
+    if (isNumber.isZero(delay))
         return Promise.resolve();
     return new Promise(resolve => setTimeout(resolve, delay));
 }

package/{src/array/difference.mjs → es/array/difference.js}

@@ -32,10 +32,12 @@ import { isArray, isEmptyArray } from 'a-type-of-js';
  *
  */
 function difference(a, b) {
-    if ([a, b].some(e => !isArray(e)))
+    if (!isArray(a) || !isArray(b)) {
         throw new TypeError('参数需为数组');
-    if ([a, b].some(e => isEmptyArray(e)))
+    }
+    if (isEmptyArray(a) || isEmptyArray(b)) {
         return a;
+    }
     /**  获取两个数组中长度较小的  */
     // 参数有顺序要求
     // const [shorter, longer] = a.length > b.length ? [b, a] : [a, b];

package/{src/array/index.mjs → es/array/index.js}

@@ -1,7 +1,7 @@
-import { intersection } from './intersection.mjs';
-import { union } from './union.mjs';
-import { difference } from './difference.mjs';
-import { symmetricDifference } from './symmetricDifference.mjs';
+import { intersection } from './intersection.js';
+import { union } from './union.js';
+import { difference } from './difference.js';
+import { symmetricDifference } from './symmetricDifference.js';
 
 /**
  *

package/{src/array/intersection.mjs → es/array/intersection.js}

@@ -22,11 +22,13 @@ import { isArray, isEmptyArray } from 'a-type-of-js';
  *
  */
 function intersection(a, b) {
-    if (!isArray(a) || !isArray(b))
+    if (!isArray(a) || !isArray(b)) {
         throw new TypeError('参数必须是数组类型数据');
+    }
     // 任意数组为空，则返回空数组
-    if ([a, b].some(e => isEmptyArray(e)))
+    if (isEmptyArray(a) || isEmptyArray(b)) {
         return [];
+    }
     /**
      * 在实际运算中， new Set() 的 开销为 O(n) ,filter 的开销也为 O(n)
      *

package/{src/array/symmetricDifference.mjs → es/array/symmetricDifference.js}

@@ -1,5 +1,5 @@
 import { isArray, isEmptyArray } from 'a-type-of-js';
-import { difference } from './difference.mjs';
+import { difference } from './difference.js';
 
 /**
  *

package/{src/className.mjs → es/className.js}

@@ -32,9 +32,9 @@ initial = false) {
     /**  转化首字符   */
     const toTransform = (_str, _dividingType) => _str.replace(new RegExp(`${template.test(_dividingType) ? `\\${_dividingType}` : _dividingType}([a-zA-Z])`, 'g'), (match, p1) => p1.toUpperCase());
     // 多分隔符转化
-    dividingType.split('').forEach((item) => {
-        result = toTransform(result, item);
-    });
+    dividingType
+        .split('')
+        .forEach((item) => (result = toTransform(result, item)));
     return initial
         ? result.replace(/^./, (match) => match.toUpperCase())
         : result;

package/{src/getRandomNumber.mjs → es/getRandomNumber.js}

@@ -11,7 +11,7 @@ import { isNaN, isNumber } from 'a-type-of-js';
  *
  * 获取一个随机的整数类型
  *
- * 您可以传入两个参数并获取它们之间的任意数字
+ * 您可以传入两个参数并获取它们之间的任意数字，返回值<span style="color:#ff0;">*会包含端值*</span>
  *
  * 如果只传递一个参数，则如果提供的值为负数，则得到一个小于（或大于）该数字的整数
  *
@@ -33,12 +33,12 @@ function getRandomInt(max = 1, min = 0) {
     let _min = Math.ceil(Number(min)), 
     /**  获取最大值  */
     _max = Math.floor(Number(max));
-    /**  两值交换  */
-    if (_min > _max)
-        [_max, _min] = [_min, _max];
-    //**  两值相等时，直接返回最大值  */
+    //  两值相等时，直接返回最大值
     if (_max === _min)
         return _max;
+    //  两值交换
+    if (_min > _max)
+        [_max, _min] = [_min, _max];
     return Math.round(Math.random() * (_max - _min) + _min);
 }
 /**