javascript common method - Object

// 11. Object.is(value1, value2)
// 比较两个值是否相同。所有 NaN 值都相等（这与==和===不同）。
/**
 * @description 判断两个值是否相同。
 * 这种相等性判断逻辑和传统的 == 运算不同，== 运算符会对它两边的操作数做隐式类型转换（如果它们类型不同），
 * 然后才进行相等性比较，（所以才会有类似 "" == false 等于 true 的现象），但 Object.is 不会做这种类型转换。
 * -----------------------------------------------------
 * 这与 === 运算符的判定方式也不一样。
 * === 运算符（和== 运算符）将数字值 -0 和 +0 视为相等，并认为 Number.NaN 不等于 NaN。
 * 
 * @param {*} value1 第一个需要比较的值
 * @param {*} value2 第二个需要比较的值
 * @returns  表示两个参数是否相同的布尔值。
 */
{
    console.log('--> 11. Object.is(value1, value2)');

    Object.is('foo', 'foo');     // true
    Object.is(window, window);   // true

    Object.is('foo', 'bar');     // false
    Object.is([], []);           // false

    var foo = { a: 1 };
    var bar = { a: 1 };
    Object.is(foo, foo);         // true
    Object.is(foo, bar);         // false

    Object.is(null, null);       // true

    // 特例
    Object.is(0, -0);            // false
    Object.is(0, +0);            // true
    Object.is(-0, -0);           // true
    Object.is(NaN, 0 / 0);         // true
}

// 12. Object.isExtensible(obj)
// 判断对象是否可扩展。
/**
 * @description （是否可以在它上面添加新的属性）。默认情况下，对象是可扩展的：即可以为他们添加新的属性。以及它们的 __proto__ 属性可以被更改。
 * Object.preventExtensions，Object.seal 或 Object.freeze 方法都可以标记一个对象为不可扩展（non-extensible）。
 * 
 * @param {Object} obj 需要检测的对象
 * @returns  表示给定对象是否可扩展的一个Boolean 。
 */
{
    console.log('--> 12. Object.isExtensible(obj)');

    // 新对象默认是可扩展的.
    var empty = {};
    var result = Object.isExtensible(empty); // === true
    console.log(result);

    // ...可以变的不可扩展.
    Object.preventExtensions(empty);
    result = Object.isExtensible(empty); // === false
    console.log(result);

    // 密封对象是不可扩展的.
    var sealed = Object.seal({});
    result = Object.isExtensible(sealed); // === false
    console.log(result);

    // 冻结对象也是不可扩展.
    var frozen = Object.freeze({});
    result = Object.isExtensible(frozen); // === false
    console.log(result);
}

// 13. Object.isFrozen(obj)
// 判断对象是否已经冻结。
/**
 * @description 一个对象是冻结的是指它不可扩展，所有属性都是不可配置的，且所有数据属性（即没有getter或setter组件的访问器的属性）都是不可写的。
 * 
 * @param {Object} obj 需要检测的对象
 * @returns  表示给定对象是否被冻结的Boolean。
 */
{
    console.log('--> 13. Object.isFrozen(obj)');

    // 一个对象默认是可扩展的,所以它也是非冻结的.
    Object.isFrozen({}); // === false

    // 一个不可扩展的空对象同时也是一个冻结对象.
    var vacuouslyFrozen = Object.preventExtensions({});
    Object.isFrozen(vacuouslyFrozen) //=== true;

    // 一个非空对象默认也是非冻结的.
    var oneProp = { p: 42 };
    Object.isFrozen(oneProp) //=== false

    // 让这个对象变的不可扩展,并不意味着这个对象变成了冻结对象,
    // 因为p属性仍然是可以配置的(而且可写的).
    Object.preventExtensions(oneProp);
    Object.isFrozen(oneProp) //=== false

    // 此时,如果删除了这个属性,则它会成为一个冻结对象.
    delete oneProp.p;
    Object.isFrozen(oneProp) //=== true

    // 一个不可扩展的对象,拥有一个不可写但可配置的属性,则它仍然是非冻结的.
    var nonWritable = { e: "plep" };
    Object.preventExtensions(nonWritable);
    Object.defineProperty(nonWritable, "e", { writable: false }); // 变得不可写
    Object.isFrozen(nonWritable) //=== false

    // 把这个属性改为不可配置,会让这个对象成为冻结对象.
    Object.defineProperty(nonWritable, "e", { configurable: false }); // 变得不可配置
    Object.isFrozen(nonWritable) //=== true

    // 一个不可扩展的对象,拥有一个不可配置但可写的属性,则它仍然是非冻结的.
    var nonConfigurable = { release: "the kraken!" };
    Object.preventExtensions(nonConfigurable);
    Object.defineProperty(nonConfigurable, "release", { configurable: false });
    Object.isFrozen(nonConfigurable) //=== false

    // 把这个属性改为不可写,会让这个对象成为冻结对象.
    Object.defineProperty(nonConfigurable, "release", { writable: false });
    Object.isFrozen(nonConfigurable) //=== true

    // 一个不可扩展的对象,值拥有一个访问器属性,则它仍然是非冻结的.
    var accessor = { get food() { return "yum"; } };
    Object.preventExtensions(accessor);
    Object.isFrozen(accessor) //=== false

    // ...但把这个属性改为不可配置,会让这个对象成为冻结对象.
    Object.defineProperty(accessor, "food", { configurable: false });
    Object.isFrozen(accessor) //=== true

    // 使用Object.freeze是冻结一个对象最方便的方法.
    var frozen = { 1: 81 };
    Object.isFrozen(frozen) //=== false
    Object.freeze(frozen);
    Object.isFrozen(frozen) //=== true

    // 一个冻结对象也是一个密封对象.
    Object.isSealed(frozen) //=== true

    // 当然,更是一个不可扩展的对象.
    Object.isExtensible(frozen) //=== false
}


// 14. Object.isSealed(obj)
// 判断对象是否已经密封。
/**
 * @description 密封对象是指那些不可 扩展 的，且所有自身属性都不可配置且因此不可删除（但不一定是不可写）的对象。
 * 
 * @param {Object} obj 需要检测的对象
 * @returns  表示给定对象是否被密封的一个Boolean 。
 */
{
    console.log('--> 14. Object.isSealed(obj)');

    // 新建的对象默认不是密封的.
    var empty = {};
    Object.isSealed(empty); // === false

    // 如果你把一个空对象变的不可扩展,则它同时也会变成个密封对象.
    Object.preventExtensions(empty);
    Object.isSealed(empty); // === true

    // 但如果这个对象不是空对象,则它不会变成密封对象,因为密封对象的所有自身属性必须是不可配置的.
    var hasProp = { fee: "fie foe fum" };
    Object.preventExtensions(hasProp);
    Object.isSealed(hasProp); // === false

    // 如果把这个属性变的不可配置,则这个对象也就成了密封对象.
    Object.defineProperty(hasProp, "fee", { configurable: false });
    Object.isSealed(hasProp); // === true

    // 最简单的方法来生成一个密封对象,当然是使用Object.seal.
    var sealed = {};
    Object.seal(sealed);
    Object.isSealed(sealed); // === true

    // 一个密封对象同时也是不可扩展的.
    Object.isExtensible(sealed); // === false

    // 一个密封对象也可以是一个冻结对象,但不是必须的.
    Object.isFrozen(sealed); // === true ，所有的属性都是不可写的
    var s2 = Object.seal({ p: 3 });
    Object.isFrozen(s2); // === false， 属性"p"可写

    var s3 = Object.seal({ get p() { return 0; } });
    Object.isFrozen(s3); // === true ，访问器属性不考虑可写不可写,只考虑是否可配置
}



// 15. Object.keys(obj)
// 返回一个包含所有给定对象自身可枚举属性名称的数组。
/**
 * @description 返回一个所有元素为字符串的数组，其元素来自于从给定的object上面可直接枚举的属性。
 * 这些属性的顺序与手动遍历该对象属性时的一致。
 * 
 * @param {Object} obj 要返回其枚举自身属性的对象。
 * @returns  一个表示给定对象的所有可枚举属性的字符串数组。
 */
{
    console.log('--> 15. Object.keys(obj)');

    // simple array
    var arr = ['a', 'b', 'c'];
    console.log(Object.keys(arr)); // console: ['0', '1', '2']

    // array like object
    var obj = { 0: 'a', 1: 'b', 2: 'c' };
    console.log(Object.keys(obj)); // console: ['0', '1', '2']

    // array like object with random key ordering
    var anObj = { 100: 'a', 2: 'b', 7: 'c' };
    console.log(Object.keys(anObj)); // console: ['2', '7', '100']

    // getFoo is a property which isn't enumerable
    var myObj = Object.create({}, {
        getFoo: {
            value: function () { return this.foo; }
        }
    });
    myObj.foo = 1;
    console.log(Object.keys(myObj)); // console: ['foo']
}


// 16. Object.preventExtensions(obj)
// 防止对象的任何扩展。
/**
 * @description 如果一个对象可以添加新的属性，则这个对象是可扩展的。Object.preventExtensions()将对象标记为不再可扩展，
 * 因此它将永远不会具有超出它被标记为不可扩展的属性。注意，一般来说，不可扩展对象的属性可能仍然可被删除。
 * 尝试将新属性添加到不可扩展对象将静默失败或抛出TypeError（最常见但不排除其他情况，如在strict mode中）。
 * ---------------------------------------
 * 仅阻止添加自身的属性。但属性仍然可以添加到对象原型。一旦使其不可扩展，就无法再对象进行扩展。
 * 
 * @param {Object} obj 将要变得不可扩展的对象。
 * @returns  已经不可扩展的对象。
 */
{
    console.log('--> 16. Object.preventExtensions(obj)');

    // Object.preventExtensions将原对象变的不可扩展,并且返回原对象.
    var obj = {};
    var obj2 = Object.preventExtensions(obj);
    obj === obj2;  // true

    // 字面量方式定义的对象默认是可扩展的.
    var empty = {};
    Object.isExtensible(empty) //=== true

    // ...但可以改变.
    Object.preventExtensions(empty);
    Object.isExtensible(empty) //=== false

    try {
        // 使用Object.defineProperty方法为一个不可扩展的对象添加新属性会抛出异常.
        var nonExtensible = { removable: true };
        Object.preventExtensions(nonExtensible);
        Object.defineProperty(nonExtensible, "new", { value: 8675309 }); // 抛出TypeError异常
    } catch (error) {
        console.log(error);
    }


    try {
        // 在严格模式中,为一个不可扩展对象的新属性赋值会抛出TypeError异常.
        function fail() {
            "use strict";
            nonExtensible.newProperty = "FAIL"; // throws a TypeError
        }
        fail();
    } catch (error) {
        console.log(error);
    }


    try {
        // 一个不可扩展对象的原型是不可更改的,__proto__是个非标准魔法属性,可以更改一个对象的原型.
        var fixed = Object.preventExtensions({});
        fixed.__proto__ = { oh: "hai" }; // 抛出TypeError异常
    } catch (error) {
        console.log(error);
    }
}

// 17. Object.seal(obj)
// 防止其他代码删除对象的属性。
/**
 * @description 通常，一个对象是可扩展的（可以添加新的属性）。密封一个对象会让这个对象变的不能添加新属性，且所有已有属性会变的不可配置。
 * 属性不可配置的效果就是属性变的不可删除，以及一个数据属性不能被重新定义成为访问器属性，或者反之。但属性的值仍然可以修改。
 * 尝试删除一个密封对象的属性或者将某个密封对象的属性从数据属性转换成访问器属性，结果会静默失败或抛出TypeError（在严格模式 中最常见的，但不唯一）。
 * 
 * ---------------------------------------------------
 * 不会影响从原型链上继承的属性。但 __proto__ (  ) 属性的值也会不能修改。返回被密封对象的引用。
 * 
 * @param {Object} obj 将要被密封的对象。
 * @returns  被密封的对象。
 */
{
    console.log("--> 17. Object.seal(obj)");

    var obj = {
        prop: function () { },
        foo: 'bar'
    };

    // New properties may be added, existing properties
    // may be changed or removed.
    obj.foo = 'baz';
    obj.lumpy = 'woof';
    delete obj.prop;

    var o = Object.seal(obj);

    o === obj; // true
    Object.isSealed(obj); // === true

    // Changing property values on a sealed object
    // still works.
    obj.foo = 'quux';

    try {
        // But you can't convert data properties to accessors,
        // or vice versa.
        Object.defineProperty(obj, 'foo', {
            get: function () { return 'g'; }
        }); // throws a TypeError
    } catch (error) {
        console.log(error);
    }

    // Now any changes, other than to property values,
    // will fail.
    obj.quaxxor = 'the friendly duck';
    // silently doesn't add the property
    delete obj.foo;
    // silently doesn't delete the property

    try {
        // ...and in strict mode such attempts
        // will throw TypeErrors.
        function fail() {
            'use strict';
            delete obj.foo; // throws a TypeError
            obj.sparky = 'arf'; // throws a TypeError
        }
        fail();
    } catch (error) {
        console.log(error);
    }

    try {
        // Attempted additions through
        // Object.defineProperty will also throw.
        Object.defineProperty(obj, 'ohai', {
            value: 17
        }); // throws a TypeError
    } catch (error) {
        console.log(error);
    }

    Object.defineProperty(obj, 'foo', {
        value: 'eit'
    }); // changes existing property value
}


// 18. Object.setPrototypeOf(obj, prototype)
// 设置对象的原型（即内部 [[Prototype]] 属性）。
/**
 * @description 如果对象的[[Prototype]]被修改成不可扩展(通过 Object.isExtensible()查看)，就会抛出 TypeError异常。如果prototype参数不是一个对象或者null
 * (例如，数字，字符串，boolean，或者 undefined)，则什么都不做。否则，该方法将obj的[[Prototype]]修改为新的值。
 * 
 * ---------------------------------------------------
 * Object.setPrototypeOf()是ECMAScript 6最新草案中的方法，相对于 Object.prototype.__proto__ ，它被认为是修改对象原型更合适的方法
 * 
 * @param {Object} obj 要设置其原型的对象.
 * @param {Object} prototype 该对象的新原型(一个对象 或 null).
 */
{
    var dict = Object.setPrototypeOf({}, null);
}


// 19. Object.values(obj)
// 返回给定对象自身可枚举值的数组。
/**
 * @description 返回一个数组，其元素是在对象上找到的可枚举属性值。属性的顺序与通过手动循环对象的属性值所给出的顺序相同。
 * 
 * @param {Object} obj 被返回可枚举属性值的对象。
 * @returns {Array} 一个包含对象自身的所有可枚举属性值的数组。
 */
{
    console.log('--> 19. Object.values(obj)');

    var obj = { foo: 'bar', baz: 42 };
    console.log(Object.values(obj)); // ['bar', 42]

    // array like object
    var obj = { 0: 'a', 1: 'b', 2: 'c' };
    console.log(Object.values(obj)); // ['a', 'b', 'c']

    // array like object with random key ordering
    // when we use numeric keys, the value returned in a numerical order according to the keys
    var an_obj = { 100: 'a', 2: 'b', 7: 'c' };
    console.log(Object.values(an_obj)); // ['b', 'c', 'a']

    // getFoo is property which isn't enumerable
    var my_obj = Object.create({}, { getFoo: { value: function () { return this.foo; } } });
    my_obj.foo = 'bar';
    console.log(Object.values(my_obj)); // ['bar']

    // non-object argument will be coerced to an object
    console.log(Object.values('foo')); // ['f', 'o', 'o']
}