underscore.js框架Objects类API学习

Posted 2020-09-21 claireyuancy

keys_.keys(object) 
Retrieve all the names of the object‘s properties.

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

values_.values(object) 
Return all of the values of the object‘s properties.

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

pairs_.pairs(object) 
Convert an object into a list of [key, value] pairs.

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

invert_.invert(object) 
Returns a copy of the object where the keys have become the values and the values the keys. For this to work, all of your object‘s values should be unique and string serializable.

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

functions_.functions(object) Alias: methods 
Returns a sorted list of the names of every method in an object — that is to say, the name of every function property of the object.

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

extend_.extend(destination, *sources) 
Copy all of the properties in the source objects over to the destination object, and return the destination object. It‘s in-order, so the last source will override properties of the same name in previous arguments.

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

说明：extend函数是直接改动destination參数的。通过以下代码非常easy证明

var destination = {name: ‘moe‘};
var source = {age: 50}
_.extend(destination, source);
console.log("extend="+destination.age);//50

pick_.pick(object, *keys) 
Return a copy of the object, filtered to only have values for the whitelisted(白名单) keys (or array of valid keys). Alternatively accepts a predicate indicating which keys to pick.

_.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) 
Return a copy of the object, filtered to omit the blacklisted(黑名单) keys (or array of keys). Alternatively accepts a predicate indicating which keys to omit.

_.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) 
Fill in undefined properties in object with the first value present in the following list ofdefaults objects.

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

说明：这个函数和extend非常类似，假设destination和source中属性名没有反复。那么2个函数的功能是全然一致的。

区别在于：当属性名有同名的时候，extend直接用source中的值覆盖掉destination中的值；而defaults则会依据destination中的属性值是否为undefined区别对待。

var iceCream = {flavor: "chocolate",sprinkles:undefined};
_.defaults(iceCream, {flavor: "vanilla", sprinkles: "lots"});
console.log("iceCream=" + iceCream.flavor);//chocolate
console.log("sprinkles=" + iceCream.sprinkles);//lots

clone_.clone(object) 
Create a shallow-copied(浅拷贝) clone of the object. Any nested objects or arrays will be copied by reference, not duplicated.

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

tap_.tap(object, interceptor) 
Invokes interceptor with the object, and then returns object. The primary purpose of this method is to "tap into" a method chain, in order to perform operations on intermediate results within the chain.

_.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) 
Does the object contain the given key?

Identical to object.hasOwnProperty(key), but uses a safe reference to the hasOwnProperty function, in case it‘s been overridden accidentally.

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

property_.property(key) 
Returns a function that will itself return the key property of any passed-in object.

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

matches_.matches(attrs) 
Returns a predicate function that will tell you if a passed in object contains all of the key/value properties present in attrs.

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

isEqual_.isEqual(object, other) 
Performs an optimized deep comparison between the two objects, to determine if they should be considered equal.

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

isEmpty_.isEmpty(object) 
Returns true if an enumerable object contains no values (no enumerable own-properties). For strings and array-like objects _.isEmpty checks if the length property is 0.

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

isElement_.isElement(object) 
Returns true if object is a DOM element.

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

isArray_.isArray(object) 
Returns true if object is an Array.

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

isObject_.isObject(value) 
Returns true if value is an Object. Note that javascript arrays and functions are objects, while (normal) strings and numbers are not.

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

isArguments_.isArguments(object) 
Returns true if object is an Arguments object.

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

isFunction_.isFunction(object) 
Returns true if object is a Function.

_.isFunction(alert);
=> true

isString_.isString(object) 
Returns true if object is a String.

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

isNumber_.isNumber(object) 
Returns true if object is a Number (including NaN).

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

isFinite_.isFinite(object) 
Returns true if object is a finite Number.

_.isFinite(-101);
=> true

_.isFinite(-Infinity);
=> false

isBoolean_.isBoolean(object) 
Returns true if object is either true or false.

_.isBoolean(null);
=> false

isDate_.isDate(object) 
Returns true if object is a Date.

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

isRegExp_.isRegExp(object) 
Returns true if object is a RegExp.

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

isNaN_.isNaN(object) 
Returns true if object is NaN.
Note: this is not the same as the native isNaN function, which will also return true for many other not-number values, such as undefined.

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

isNull_.isNull(object) 
Returns true if the value of object is null.

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

isUndefined_.isUndefined(value) 
Returns true if value is undefined.

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