JavaScript深入理解對象方法——Object.defineProperties()

jk_v1 發(fā)布于2019-08-21 17:06 / 1214人閱讀

摘要：方法直接在一個對象上定義新的屬性或修改現(xiàn)有屬性，并返回該對象。默認(rèn)為當(dāng)且僅當(dāng)在枚舉相應(yīng)對象上的屬性時該屬性顯現(xiàn)。函數(shù)返回值將被用作屬性的值。默認(rèn)為返回值傳遞給函數(shù)的對象。

Object.defineProperties()

Object.defineProperties() 方法直接在一個對象上定義新的屬性或修改現(xiàn)有屬性，并返回該對象。

語法

Object.defineProperties(obj, props)

參數(shù)

obj
在其上定義或修改屬性的對象。

props
要定義其可枚舉屬性或修改的屬性描述符的對象。對象中存在的屬性描述符主要有兩種：數(shù)據(jù)描述符和訪問器描述符（更多詳情，請參閱Object.defineProperty()）。描述符具有以下鍵：

configurable
true 當(dāng)且僅當(dāng)該屬性描述符的類型可以被改變并且該屬性可以從對應(yīng)對象中刪除。默認(rèn)為 false

enumerable
true 當(dāng)且僅當(dāng)在枚舉相應(yīng)對象上的屬性時該屬性顯現(xiàn)。默認(rèn)為 false

value
與屬性關(guān)聯(lián)的值。可以是任何有效的JavaScript值（數(shù)字，對象，函數(shù)等）。默認(rèn)為 undefined.

writable
true當(dāng)且僅當(dāng)與該屬性相關(guān)聯(lián)的值可以用assignment operator改變時。默認(rèn)為 false

get
作為該屬性的 getter 函數(shù)，如果沒有 getter 則為undefined。函數(shù)返回值將被用作屬性的值。默認(rèn)為 undefined

set
作為屬性的 setter 函數(shù)，如果沒有 setter 則為undefined。函數(shù)將僅接受參數(shù)賦值給該屬性的新值。默認(rèn)為 undefined

返回值

傳遞給函數(shù)的對象。

描述

Object.defineProperties本質(zhì)上定義了obj 對象上props的可枚舉屬性相對應(yīng)的所有屬性。

例子

var obj = {};
Object.defineProperties(obj, {
  "property1": {
    value: true,
    writable: true
  },
  "property2": {
    value: "Hello",
    writable: false
  }
  // etc. etc.
});

Polyfill

假設(shè)一個原始的執(zhí)行環(huán)境，所有的名稱和屬性都引用它們的初始值，Object.defineProperties幾乎完全等同于（注意isCallable中的注釋）以下JavaScript中的重新實現(xiàn)：

function defineProperties(obj, properties) {
  function convertToDescriptor(desc) {
    function hasProperty(obj, prop) {
      return Object.prototype.hasOwnProperty.call(obj, prop);
    }

    function isCallable(v) {
      // NB: modify as necessary if other values than functions are callable.
      return typeof v === "function";
    }

    if (typeof desc !== "object" || desc === null)
      throw new TypeError("bad desc");

    var d = {};

    if (hasProperty(desc, "enumerable"))
      d.enumerable = !!desc.enumerable;
    if (hasProperty(desc, "configurable"))
      d.configurable = !!desc.configurable;
    if (hasProperty(desc, "value"))
      d.value = desc.value;
    if (hasProperty(desc, "writable"))
      d.writable = !!desc.writable;
    if (hasProperty(desc, "get")) {
      var g = desc.get;

      if (!isCallable(g) && typeof g !== "undefined")
        throw new TypeError("bad get");
      d.get = g;
    }
    if (hasProperty(desc, "set")) {
      var s = desc.set;
      if (!isCallable(s) && typeof s !== "undefined")
        throw new TypeError("bad set");
      d.set = s;
    }

    if (("get" in d || "set" in d) && ("value" in d || "writable" in d))
      throw new TypeError("identity-confused descriptor");

    return d;
  }

  if (typeof obj !== "object" || obj === null)
    throw new TypeError("bad obj");

  properties = Object(properties);

  var keys = Object.keys(properties);
  var descs = [];

  for (var i = 0; i < keys.length; i++)
    descs.push([keys[i], convertToDescriptor(properties[keys[i]])]);

  for (var i = 0; i < descs.length; i++)
    Object.defineProperty(obj, descs[i][0], descs[i][1]);

  return obj;
}