Lodash 中文文档 (v3.10.1) - “Lang” 方法
Lodash 中文文檔 (v3.10.1) - “Lang” 方法
Translated by PeckZeg
Original Docs: Lodash v3.10.1 Docs
“Lang” 方法
_.clone(value, [isDeep], [customizer], [thisArg])
創建一個 value 的克隆。如果 isDeep 為 true，則嵌套對象也會被克隆，否則，其將被賦值為引用對象。如果指定了 customizer，那么其將被用來調用提供克隆的值。如果 customizer 返回 undefined，克隆過程將被方法本身代替。customizer 綁定 thisArg，并在執行時最多傳入三個參數：value, [index|key], [object]。
注意：該方法基于 結構化克隆算法。arguments 對象的可枚舉屬性和構造函數創建的對象不同于被源生 Object 克隆出的 Object。不可克隆的值如函數、DOM 結點、映射、結合 和弱映射將會返回空對象。
參數
value (*) : 待克隆的值
[isDeep] (boolean) : 指定是否深度克隆
[customizer] (Function) : 克隆值的定制器函數
[thisArg] (*) : customizer 綁定的 this
返回
(*) : 返回克隆的值
示例
var users = [{ 'user': 'barney' },{ 'user': 'fred' } ];var shallow = _.clone(users); shallow[0] === users[0]; // → truevar deep = _.clone(users, true); deep[0] === users[0]; // → false// 使用定制回調函數 var el = _.clone(document.body, function(value) {if (_.isElement(value)) {return value.cloneNode(false);} });el === document.body // → false el.nodeName // → BODY el.childNodes.length; // → 0_.cloneDeep(value, [customizer], [thisArg])
創建一個深度克隆對象。如果指定了 customizer，那么其將被用來調用提供克隆的值。如果 customizer 返回 undefined，克隆過程將被方法本身代替。customizer 綁定 thisArg，并在執行時最多傳入三個參數：value, [index|key], [object]。
注意：該方法基于 結構化克隆算法。arguments 對象的可枚舉屬性和構造函數創建的對象不同于被源生 Object 克隆出的 Object。不可克隆的值如函數、DOM 結點、映射、結合 和弱映射將會返回空對象。
參數
value (*) : 待深度克隆的值
[customizer] (Function) : 克隆值的定制器函數
[thisArg] (*) : customizer 綁定的 this
返回
(*) : 返回深度克隆值
示例
var users = [{ 'user': 'barney' },{ 'user': 'fred' } ];var deep = _.cloneDeep(users); deep[0] === users[0]; // → false// 使用定制器回調函數 var el = _.cloneDeep(document.body, function(value) {if (_.isElement(value)) {return value.cloneNode(true);} });el === document.body // → false el.nodeName // → BODY el.childNodes.length; // → 20_.gt(value, other)
檢查 value 是否大于 other。
參數
value (*) : 待比較的值
other (*) : 另一個待比較的值
返回
(boolean) : value 大于 other 時返回 true，否則返回 false
示例
_.gt(3, 1); // → true_.gt(3, 3); // → false_.gt(1, 3); // → false_.gte(value, other)
檢查 value 是否大于等于 other。
參數
value (*) : 待比較的值
other (*) : 另一個待比較的值
返回
(boolean) : value 大于等于 other 時返回 true，否則返回 false
示例
_.gte(3, 1); // → true_.gte(3, 3); // → true_.gte(1, 3); // → false_.isArguments(value)
檢查 value 是否被列為參數。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被列為參數則返回 true，否則返回 false
示例
_.isArguments(function() { return arguments; }()); // → true_.isArguments([1, 2, 3]); // → false_.isArray(value)
檢查 value 是否被列為數組對象。
參數
value (*) : 待檢查的值
返回
(boolean) : 如果 value 為正確的分類返回 true，否則則返回 false
示例
_.isArray([1, 2, 3]); // → true_.isArray(function() { return arguments; }()); // → false_.isBoolean(value)
檢查 value 是否被列為原始布爾值或布爾值對象。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被正確歸類時返回 true，否則返回 false
示例
_.isBoolean(false); // → true_.isBoolean(null); // → false_.isDate(value)
檢查 value 是否被列為 Date 對象。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被正確歸類時返回 true，否則返回 false
示例
_.isDate(new Date); // → true_.isDate('Mon April 23 2012'); // → false_.isElement(value)
檢查 value 是否為 DOM 元素。
參數
value (*) : 待檢查的值
返回
(boolean) : value 為 DOM 元素時返回 true，否則返回 false
示例
_.isElement(document.body); // → true_.isElement('<body>'); // → false_.isEmpty(value)
檢查 value 是否為空。除了 arguments 對象、數組、字符串或 類 jQuery 集合的 length 值大于 0 或者對象擁有可枚舉屬性時，其他情況會把值考慮為空。
參數
value (Array|Object|string) : 待檢查的值
返回
(boolean) : value 為空時返回 true，否則返回 false
示例
_.isEmpty(null); // → true_.isEmpty(true); // → true_.isEmpty(1); // → true_.isEmpty([1, 2, 3]); // → false_.isEmpty({ 'a': 1 }); // → false_.isEqual(value, other, [customizer], [thisArg])
在兩個值之間進行深度比較以確定它們是否相等。如果提供了 customizer，其將被用來執行比較兩個值。如果 customizer 返回 undefined，那么比較過程被方法本身代替。customizer 綁定 thisArg 并在執行時最多傳入三個值：value, other, index|key。
注意：該方法支持比較數組、布爾值、Date 對象，數值，Object 對象，正則表達式和字符串。對象間比較其自有值而非內置值。不支持比較函數和 DOM 結點。提供一個定制器函數用來擴展比較其他值的支持。
別名
_.eq
參數
value (*) : 待比較的值
other (*) : 另一個待比較的值
[customizer] (Function) : 定制比較值的函數
[thisArg] (*) : customizer 綁定的 this
返回
(boolean) : 如果值之間相等時返回 true，否則返回 false
示例
var object = { 'user': 'fred' }; var other = { 'user': 'fred' };object == other; // → false_.isEqual(object, other); // → true// using a customizer callback var array = ['hello', 'goodbye']; var other = ['hi', 'goodbye'];_.isEqual(array, other, function(value, other) {if (_.every([value, other], RegExp.prototype.test, /^h(?:i|ello)$/)) {return true;} }); // → true_.isError(value)
檢查值是否為 Error、 EvalError、 RangeError、 ReferenceError、 SyntaxError、 TypeError 或 URIError 對象。
參數
value (*) : 待檢查的值
返回
(boolean) : value 為錯誤對象時返回 true，否則返回 false
示例
_.isError(new Error); // → true_.isError(Error); // → false_.isFinite(value)
檢查 value 是否為原始無限數值。
注意：該方法基于 Number.isFinite。
參數
value (*) : 待檢查的值
返回
(boolean) : value 為無限數值返回 true，否則返回 false。
示例
_.isFinite(10); // → true_.isFinite('10'); // → false_.isFinite(true); // → false_.isFinite(Object(10)); // → false_.isFinite(Infinity); // → false_.isFunction(value)
檢查 value 是否被列為函數對象。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被正確歸類時返回 true，否則返回 false
示例
_.isFunction(_); // → true_.isFunction(/abc/); // → false_.isMatch(object, source, [customizer], [thisArg])
在 object 與 source 之間執行深度比較，以決定 object 是否包含相等的屬性值。如果提供了 customizer，其將被用來執行比較兩個值。如果 customizer 返回 undefined，那么比較過程被方法本身代替。customizer 綁定 thisArg 并在執行時最多傳入三個值：value, other, index|key。
注意：該方法支持比較數組的屬性、布爾值、Date 對象，數值、Object 對象，正則表達式和數值。不支持比較函數和 DOM 結點。提供一個定制器函數用來擴展比較其他值的支持。
參數
object (Object) : 待檢查的值
source (Object) : 待匹配的屬性值的對象
[customizer] (Function) : 定制比較值的函數
[thisArg] (*) : customizer 綁定的 this
返回
(boolean) : 如果 object 匹配返回 true，否則返回 false
示例
var object = { 'user': 'fred', 'age': 40 };_.isMatch(object, { 'age': 40 }); // → true_.isMatch(object, { 'age': 36 }); // → false// 使用定制器回調函數 var object = { 'greeting': 'hello' }; var source = { 'greeting': 'hi' };_.isMatch(object, source, function(value, other) {return _.every([value, other], RegExp.prototype.test, /^h(?:i|ello)$/) || undefined; }); // → true_.isNaN(value)
檢查 value 是否為 NaN（非數值）。
注意：該方法與 isNaN不同，對 undefined 和其他非數值都返回 true
參數
value (*) : 待檢查的值
返回
(boolean) : 如果 value 為 NaN 返回 true，否則返回 false
示例
_.isNaN(NaN); // → true_.isNaN(new Number(NaN)); // → trueisNaN(undefined); // → true_.isNaN(undefined); // → false_.isNative(value)
檢查 value 是否為原生函數。
參數
value (*) : 待檢查的值
返回
(boolean) : value 為原生函數時返回 true，否則返回 false
示例
_.isNative(Array.prototype.push); // → true_.isNative(_); // → false_.isNull(value)
檢查 value 是否為 null。
參數
value (*) : 待檢查的值
返回
(boolean) : value 為 null 時返回 true，否則返回 false
示例
_.isNull(null); // → true_.isNull(void 0); // → false_.isNumber(value)
檢查 value 是否被指定為 Number 字面量或對象。
注意：如果要排除被指定為數值的 Infinity、-Infinity 和 NaN，使用 _.isFinite 方法。
參數
value (*) : 待檢查的值
返回
(boolean) : value 正確被歸類時返回 true，否則返回 false
示例
_.isNumber(8.4); // → true_.isNumber(NaN); // → true_.isNumber('8.4'); // → false_.isObject(value)
檢查 value 是否為 Object 語言類型。（例：數組、函數、對象、正則表達式，new Number(0) 和 new String('')）
參數
value (*) : 待檢查的值
返回
(boolean) : value 為對象時返回 true，否則返回 false
示例
_.isObject({}); // → true_.isObject([1, 2, 3]); // → true_.isObject(1); // → false_.isPlainObject(value)
檢查 value 是否為一個純粹的對象，純粹的對象就是使用 Object 構造器創建的對象或一個 [[Prototype]] 為 null 的對象。
注意：該方法假定由 Object 構造器創建的對象沒有內置可枚舉屬性。
參數
value (*) : 待檢查的值
返回
(boolean) : value 是純粹的對象則返回 true，否則返回 false
示例
function Foo() {this.a = 1; }_.isPlainObject(new Foo); // → false_.isPlainObject([1, 2, 3]); // → false_.isPlainObject({ 'x': 0, 'y': 0 }); // → true_.isPlainObject(Object.create(null)); // → true_.isRegExp(value)
檢查 value 是否被指定為 RegExp 對象。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被正確歸類時返回 true，否則返回 false
示例
_.isRegExp(/abc/); // → true_.isRegExp('/abc/'); // → false_.isString(value)
檢查 value 是否被歸類為 String 字面量或對象。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被正確歸類時返回 true，否則返回 false
示例
_.isString('abc'); // → true_.isString(1); // → false_.isTypedArray(value)
檢查 value 是否被歸類為類型數組。
參數
value (*) : 待檢查的值
返回
(boolean) : value 被正確歸類時返回 true，否則返回 false
示例
_.isTypedArray(new Uint8Array); // → true_.isTypedArray([]); // → false_.isUndefined(value)
檢查 value 是否為 undefined。
參數
value (*) : 待檢查的值
返回
(boolean) : value 為 undefined 時返回 true，否則返回 false
示例
_.isUndefined(void 0); // → true_.isUndefined(null); // → false_.lt(value, other)
檢查 value 是否小于 other。
參數
value (*) : 待比較的值
other (*) : 另一個待比較的值
返回
(boolean) : value 比 other 小時返回 true，否則返回 false
示例
_.lt(1, 3); // → true_.lt(3, 3); // → false_.lt(3, 1); // → false_.lte(value, other)
檢查 value 是否小于等于 other。
參數
value (*) : 待比較的值
other (*) : 另一個待比較的值
返回
(boolean) : value 小于或等于other 時返回 true，否則返回 false
示例
_.lte(1, 3); // → true_.lte(3, 3); // → true_.lte(3, 1); // → false_.toArray(value)
將 value 轉換為數組。
參數
value _(*)_: 待轉換的值
返回
(Array) : 返回轉換后的數組
示例
(function() {return _.toArray(arguments).slice(1); }(1, 2, 3)); // → [2, 3]_.toPlainObject(value)
轉換 value 為純粹的對象，該方法會將 value 的內置可枚舉對象轉換為純粹的對象的自有屬性。
參數
value (*) : 待轉換的值
返回
(Object) : 返回已轉換的純粹的對象
示例
function Foo() {this.b = 2; }Foo.prototype.c = 3;_.assign({ 'a': 1 }, new Foo); // → { 'a': 1, 'b': 2 }_.assign({ 'a': 1 }, _.toPlainObject(new Foo)); // → { 'a': 1, 'b': 2, 'c': 3 } 《新程序員》：云原生和全面數字化實踐50位技術專家共同創作，文字、視頻、音頻交互閱讀總結
以上是生活随笔為你收集整理的Lodash 中文文档 (v3.10.1) - “Lang” 方法的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： JavaScript Array.pro
- 下一篇： 降低http请求次数