当你细细琢磨一个 JavaScript 库(Underscore

2017-04-28 本文已影响36人 Transnet2014

对象

对象检索

获取对象所有键 _.keys(object)

获取object对象所有的属性名称。

_.keys({one: 1, two: 2, three: 3});
=> ["one", "two", "three"]

获取对象所有值 _.values(object)

返回object对象所有的属性值。

_.values({one: 1, two: 2, three: 3});
=> [1, 2, 3]

将对象转为二维数组 _.pairs(object)

把一个对象转变为一个[key, value]形式的数组。是 _.object() 的逆运算。

_.pairs({one: 1, two: 2, three: 3});
=> [["one", 1], ["two", 2], ["three", 3]]

键值互换 _.invert(object)

返回一个object副本，使其键（keys）和值（values）对换。对于这个操作，必须确保object里所有的值都是唯一的且可以序列号成字符串.

_.invert({Moe: "Moses", Larry: "Louis", Curly: "Jerome"});
=> {Moses: "Moe", Louis: "Larry", Jerome: "Curly"};

枚举对象的所有方法 _.functions(object)

别名： methods

返回一个对象里所有的方法名, 而且是已经排序的 — 也就是说, 对象里每个方法(属性值是一个函数)的名称.

_.functions(_);
=> ["all", "any", "bind", "bindAll", "clone", "compact", "compose" ...

对象拓展 _.extend(destination, *sources)

复制source对象中的所有属性覆盖到destination对象上，并且返回 destination 对象. 复制是按顺序的, 所以后面的对象属性会把前面的对象属性覆盖掉(如果有重复).

_.extend({name: 'moe'}, {age: 50});
=> {name: 'moe', age: 50}

这个功能类似于 ES5 提供的 Object.assign();

对象属性筛选 _.pick(object, *keys)

返回一个object副本，只过滤出keys(有效的键组成的数组)参数指定的属性值。或者接受一个判断函数，指定挑选哪个key。

_.pick({name: 'moe', age: 50, userid: 'moe1'}, 'name', 'age');
=> {name: 'moe', age: 50}
_.pick({name: 'moe', age: 50, userid: 'moe1'}, function(value, key, object) {
  return _.isNumber(value);
});
=> {age: 50}

omit_.omit(object, *keys)
返回一个object副本，只过滤出除去keys(有效的键组成的数组)参数指定的属性值。或者接受一个判断函数，指定忽略哪个key。

_.omit({name: 'moe', age: 50, userid: 'moe1'}, 'userid');
=> {name: 'moe', age: 50}
_.omit({name: 'moe', age: 50, userid: 'moe1'}, function(value, key, object) {
  return _.isNumber(value);
});
=> {name: 'moe', userid: 'moe1'}

defaults_.defaults(object, *defaults)
用defaults对象填充object 中的undefined属性。并且返回这个object。一旦这个属性被填充，再使用defaults方法将不会有任何效果。（感谢@一任风月忆秋年的拍砖）

var iceCream = {flavor: "chocolate"};
_.defaults(iceCream, {flavor: "vanilla", sprinkles: "lots"});
=> {flavor: "chocolate", sprinkles: "lots"}

clone_.clone(object)
创建一个浅复制（浅拷贝）的克隆object。任何嵌套的对象或数组都通过引用拷贝，不会复制。

_.clone({name: 'moe'});
=> {name: 'moe'};

tap_.tap(object, interceptor)
用 object作为参数来调用函数interceptor，然后返回object。这种方法的主要意图是作为函数链式调用的一环, 为了对此对象执行操作并返回对象本身。

_.chain([1,2,3,200])
  .filter(function(num) { return num % 2 == 0; })
  .tap(alert)
  .map(function(num) { return num * num })
  .value();
=> // [2, 200] (alerted)
=> [4, 40000]

has_.has(object, key)
对象是否包含给定的键吗？等同于object.hasOwnProperty(key)，但是使用hasOwnProperty 函数的一个安全引用，以防意外覆盖。

_.has({a: 1, b: 2, c: 3}, "b");
=> true

property_.property(key)
返回一个函数，这个函数返回任何传入的对象的key 属性。

var moe = {name: 'moe'};
'moe' === _.property('name')(moe);
=> true

matches_.matches(attrs)
返回一个断言函数，这个函数会给你一个断言可以用来辨别给定的对象是否匹配attrs指定键/值属性。

var ready = _.matches({selected: true, visible: true});
var readyToGoList = _.filter(list, ready);

类型判断

是否相等 _.isEqual(object, other)

执行两个对象之间的优化深度比较，确定他们是否应被视为相等。

var moe   = {name: 'moe', luckyNumbers: [13, 27, 34]};
var clone = {name: 'moe', luckyNumbers: [13, 27, 34]};
moe == clone; // false
_.isEqual(moe, clone); // true

是否为空对象 _.isEmpty(object)

如果object 不包含任何值(没有可枚举的属性)，返回true。对于字符串和类数组（array-like）对象，如果length属性为0，那么_.isEmpty检查返回true。

_.isEmpty([1, 2, 3]); //=> false    
_.isEmpty({}); // => true

是否为 DOM _.isElement(object)

如果object是一个DOM元素，返回true。

_.isElement(jQuery('body')[0]); // => true

是否为数组 _.isArray(object)

如果object是一个数组，返回true。

(function(){ return _.isArray(arguments); })(); // => false
_.isArray([1,2,3]); //=> true

是否为引用类型 _.isObject(value)

如果 value 是一个对象，返回true。需要注意的是JavaScript数组和函数是对象，字符串和数字不是。

_.isObject({});// => true
_.isObject(1); //=> false

是否为参数对象 _.isArguments(object)

如果object是一个参数对象，返回true。

(function(){ return _.isArguments(arguments); })(1, 2, 3); // => true
_.isArguments([1,2,3]); // => false

是否为函数 _.isFunction(object)

如果object是一个函数（Function），返回true。

_.isFunction(alert); // => true

是否是字符串 _.isString(object)

如果object是一个字符串，返回true。

_.isString("moe"); // => true

是否是数值 _.isNumber(object)

如果object是一个数值，返回true (包括 NaN)。

_.isNumber(8.4 * 5); // => true

是否是有限数 _.isFinite(object)

如果object是一个有限的数字，返回true。

_.isFinite(-101); // => true
_.isFinite(-Infinity); // => false

是否为布尔值 _.isBoolean(object)

如果object是一个布尔值，返回true。不管 object 是真假

_.isBoolean(null); // => false
_.isBoolean(false); // => true

是否为时间类型对象 _.isDate(object)

如果object是一个Date类型（日期时间），返回true。

_.isDate(new Date()); // => true

是否为正则类型对象 _.isRegExp(object)

如果object是一个正则表达式，返回true。

_.isRegExp(/moe/); // => true

是否为有理数 _.isNaN(object)

如果object是 NaN，返回true。
注意：这和原生的isNaN函数不一样，如果变量是undefined，原生的isNaN 函数也会返回 true 。

_.isNaN(NaN); // => true
isNaN(undefined); // => true
_.isNaN(undefined); // => false

是否为Null _.isNull(object)

如果object的值是 null，返回true。

_.isNull(null); // => true    
_.isNull(undefined); // => false

是否为Undefined _.isUndefined(value)

如果value是undefined，返回true。

_.isUndefined(window.missingVariable); // => true