ut2 1.2.1 → 1.3.0

package/types/isElement.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否可能为 `DOM` 元素。
  *
  * @static
- * @alias module:Type.isElement
+ * @alias module:Language.isElement
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `DOM` 元素，返回 `true` ，否则返回 `false` 。

package/types/isEmpty.d.ts

@@ -6,7 +6,7 @@
  * 非上述类型值，都将被认为是空的。
  *
  * @static
- * @alias module:Type.isEmpty
+ * @alias module:Language.isEmpty
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为空，返回 `true` ，否则返回 `false` 。

package/types/isEqual.d.ts

@@ -0,0 +1,44 @@
+type Customizer = (objValue: any, othValue: any, key?: number | string | symbol, object?: any, other?: any, valueStack?: any[], otherStack?: any[]) => void | undefined | boolean;
+/**
+ * 深度比较两个值是否相等。
+ *
+ * 支持比较 `boolean` `number` `string` `symbol` `array` `array buffer` `date` `error` `map` `object` `regexp` `set` `typed array` 类型。对象只比较自身的属性，不包括继承和不可枚举的属性。
+ *
+ * 如果 `strictCheck=true` , 以下值不相等：
+ *
+ * 1. `0` `-0`
+ * 2. `typeof` 不同类型，如 `1` `Object(1)`
+ * 3. 无效日期对象，如 `new Date('')` `new Date('abc')`
+ *
+ * @static
+ * @alias module:Language.isEqual
+ * @since 1.3.0
+ * @param {*} value 要比较的值。
+ * @param {*} other 另一个要比较的值。
+ * @param {Function} [customizer] 自定义比较。
+ * @param {boolean} [strictCheck=false] 严格比较，默认 `false` 。
+ * @returns {boolean} 如果两个值相等，返回 `true` ，否则返回 `false` 。
+ * @example
+ *
+ * const value = { a: 1, b: -0 }
+ * const other = { a: 1, b: 0 }
+ *
+ * isEqual(value, other); // true
+ * value === other // false
+ *
+ * // 严格比较
+ * isEqual(value, other, undefined, true); // false
+ *
+ * // 自定义比较
+ * function customizer(value, other){
+ *   if(typeof value === 'string' && typeof other === 'string'){
+ *     return true;
+ *   }
+ * }
+ * isEqual('a', 'b', customizer); // true
+ * isEqual(['a'], ['b'], customizer); // true
+ * isEqual({foo: 'a'}, {foo: 'b'}, customizer); // true
+ *
+ */
+declare function isEqual(value: any, other: any, customizer?: Customizer, strictCheck?: boolean): boolean;
+export default isEqual;

package/types/isError.d.ts

@@ -4,7 +4,7 @@
  * 继承自 `Error` 的对象，如 `EvalError` `RangeError` `ReferenceError` `SyntaxError` `TypeError` `URIError` `AggregateError`，都将返回 `true` 。
  *
  * @static
- * @alias module:Type.isError
+ * @alias module:Language.isError
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `Error` 或 `DOMException` 对象，返回 `true` ，否则返回 `false` 。

package/types/isFinite.d.ts

@@ -4,7 +4,7 @@
  * 同 `Number.isFinite` 。
  *
  * @static
- * @alias module:Type.isFinite
+ * @alias module:Language.isFinite
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为有限数字，返回 `true` ，否则返回 `false` 。

package/types/isFunction.d.ts

@@ -4,7 +4,7 @@
  * `Function` `AsyncFunction` `GeneratorFunction` `Proxy` 都将返回 `true` 。
  *
  * @static
- * @alias module:Type.isFunction
+ * @alias module:Language.isFunction
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `Function` 对象，返回 `true` ，否则返回 `false` 。

package/types/isInteger.d.ts

@@ -4,7 +4,7 @@
  * 同 `Number.isInteger` 。
  *
  * @static
- * @alias module:Type.isInteger
+ * @alias module:Language.isInteger
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为整数，返回 `true` ，否则返回 `false` 。

package/types/isLength.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为有效的类数组长度。
  *
  * @static
- * @alias module:Type.isLength
+ * @alias module:Language.isLength
  * @since 1.0.0
  * @see {@link https://tc39.es/ecma262/#sec-tolength | ToLength}
  * @param {*} value 要检查的值。

package/types/isMap.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `Map` 对象。
  *
  * @static
- * @alias module:Type.isMap
+ * @alias module:Language.isMap
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `Map` 对象，返回 `true` ，否则返回 `false` 。

package/types/isNaN.d.ts

@@ -4,7 +4,7 @@
  * 和 `Number.isNaN` 区别是 `new Number(NaN)` 也被认为是 `NaN`。
  *
  * @static
- * @alias module:Type.isNaN
+ * @alias module:Language.isNaN
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `NaN` ，返回 `true` ，否则返回 `false` 。

package/types/isNil.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `undefined` 或 `null` 。
  *
  * @static
- * @alias module:Type.isNil
+ * @alias module:Language.isNil
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `undefined` 或 `null` ，返回 `true` ，否则返回 `false` 。

package/types/isNull.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `null` 。
  *
  * @static
- * @alias module:Type.isNull
+ * @alias module:Language.isNull
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `null` ，返回 `true` ，否则返回 `false` 。

package/types/isNumber.d.ts

@@ -4,7 +4,7 @@
  * `Infinity` `-Infinity` `NaN` 都归类为数字。如果要排除，请使用 `isFinite` 方法。
  *
  * @static
- * @alias module:Type.isNumber
+ * @alias module:Language.isNumber
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为数字类型或对象，返回 `true` ，否则返回 `false` 。

package/types/isObject.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为对象。(例如，数组、函数、对象、正则表达式、new Number(0) 和 new String(''))。
  *
  * @static
- * @alias module:Type.isObject
+ * @alias module:Language.isObject
  * @since 1.0.0
  * @see {@link https://tc39.es/ecma262/#sec-ecmascript-language-types | language type}
  * @param {*} value 要检查的值。

package/types/isObjectLike.d.ts

@@ -4,7 +4,7 @@
  * 如果一个值不为 `null` 并且 `typeof` 结果为 `object`，则该值是类对象。
  *
  * @static
- * @alias module:Type.isObjectLike
+ * @alias module:Language.isObjectLike
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为类对象，返回 `true` ，否则返回 `false` 。

package/types/isPlainObject.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为普通对象，即由 `Object` 构造函数创建或 `[[Prototype]]` 为 `null` 的对象。
  *
  * @static
- * @alias module:Type.isPlainObject
+ * @alias module:Language.isPlainObject
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为普通对象，返回 `true` ，否则返回 `false` 。

package/types/isPromiseLike.d.ts

@@ -4,7 +4,7 @@
  * 如果一个对象包含 `then` 方法，它就是类似 `Promise` 对象。
  *
  * @static
- * @alias module:Type.isPromiseLike
+ * @alias module:Language.isPromiseLike
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值类似 `Promise` 对象，返回 `true` ，否则返回 `false` 。

package/types/isRegExp.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `RegExp` 对象。
  *
  * @static
- * @alias module:Type.isRegExp
+ * @alias module:Language.isRegExp
  * @since 1.0.0
  * @param {*} value 要检查的值
  * @returns {boolean} 如果值为 `RegExp` 对象，返回 `true` ，否则返回 `false` 。

package/types/isSafeInteger.d.ts

@@ -6,7 +6,7 @@
  * 如果一个整数是一个 `IEEE-754` 双精度数字，它不是四舍五入的不安全整数的结果，那么它就是安全的。安全整数范围为 `-(2^53 - 1)` 到 `2^53 - 1` 之间的整数，包含 `-(2^53 - 1)` 和 `2^53 - 1`。
  *
  * @static
- * @alias module:Type.isSafeInteger
+ * @alias module:Language.isSafeInteger
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为安全整数，返回 `true` ，否则返回 `false` 。

package/types/isSet.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `Set` 对象。
  *
  * @static
- * @alias module:Type.isSet
+ * @alias module:Language.isSet
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `Set` 对象，返回 `true` ，否则返回 `false` 。

package/types/isString.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为字符串类型或对象。
  *
  * @static
- * @alias module:Type.isString
+ * @alias module:Language.isString
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为字符串类型或对象，返回 `true` ，否则返回 `false` 。

package/types/isSymbol.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `Symbol` 类型或对象。
  *
  * @static
- * @alias module:Type.isSymbol
+ * @alias module:Language.isSymbol
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `Symbol` 类型或对象，返回 `true` ，否则返回 `false` 。

package/types/isTypedArray.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为类型化数组。
  *
  * @static
- * @alias module:Type.isTypedArray
+ * @alias module:Language.isTypedArray
  * @since 1.0.0
  * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Guide/Typed_arrays | Typed_arrays}
  * @param {*} value 要检查的值。

package/types/isUndefined.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `undefined` 。
  *
  * @static
- * @alias module:Type.isUndefined
+ * @alias module:Language.isUndefined
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `undefined` ，返回 `true` ，否则返回 `false` 。

package/types/isWeakMap.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `WeakMap` 对象。
  *
  * @static
- * @alias module:Type.isWeakMap
+ * @alias module:Language.isWeakMap
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `WeakMap` 对象，返回 `true` ，否则返回 `false` 。

package/types/isWeakSet.d.ts

@@ -2,7 +2,7 @@
  * 检查值是否为 `WeakSet` 对象。
  *
  * @static
- * @alias module:Type.isWeakSet
+ * @alias module:Language.isWeakSet
  * @since 1.0.0
  * @param {*} value 要检查的值。
  * @returns {boolean} 如果值为 `WeakSet` 对象，返回 `true` ，否则返回 `false` 。

package/types/union.d.ts

@@ -11,7 +11,7 @@
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
- * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
  * @returns {Array} 新的联合数组。
  * @example
  *

package/types/uniq.d.ts

@@ -10,7 +10,7 @@
  * @since 1.0.0
  * @param {Array} array 要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
- * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
  * @returns {Array} 去重后的新数组。
  * @example
  *

package/types/xor.d.ts

@@ -11,7 +11,7 @@
  * @param {Array} array 要检查的数组。
  * @param {Array} [other=[]] 另一个要检查的数组。
  * @param {Function | string} [iteratee] 迭代函数，调用每个元素。
- * @param {boolean} [strictCheck=false] 严格比较，区分 `+0` `-0`。
+ * @param {boolean} [strictCheck=false] 严格比较，区分 `0` `-0`，默认 `false` 。
  * @returns {Array} 过滤值后的新数组。
  * @example
  *

package/es/internals/sameValue.js

@@ -1,10 +0,0 @@
-import { objectIs } from './helpers.js';
-
-function sameValue(value, other) {
-    if (typeof objectIs === 'function') {
-        return objectIs(value, other);
-    }
-    return value === other ? value !== 0 || 1 / value === 1 / other : value != value && other != other;
-}
-
-export { sameValue as default };

package/lib/internals/sameValue.js

@@ -1,12 +0,0 @@
-'use strict';
-
-var helpers = require('./helpers.js');
-
-function sameValue(value, other) {
-    if (typeof helpers.objectIs === 'function') {
-        return helpers.objectIs(value, other);
-    }
-    return value === other ? value !== 0 || 1 / value === 1 / other : value != value && other != other;
-}
-
-module.exports = sameValue;

package/types/internals/sameValue.d.ts

@@ -1,12 +0,0 @@
-/**
- * 检查两个值是否相等。
- *
- * @private
- * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Equality_comparisons_and_sameness | JavaScript 中的相等性判断}
- * @see {@link https://tc39.es/ecma262/#sec-samevalue | SameValue}
- * @param {*} value 要比较的值。
- * @param {*} other 另一个要比较的值。
- * @returns {boolean} 如果两个值相等返回 `true`， 否则返回 `false` 。
- */
-declare function sameValue(value: any, other: any): boolean;
-export default sameValue;