オブジェクト上で直接複数のプロパティを新しく定義、または既存の複数のプロパティの修正を行い、そのオブジェクトを返します。

文法

Object.defineProperties(obj, props)

引数	説明
obj	プロパティの定義または修正を行うオブジェクトを指定します。
props	プロパティを定義または修正するための記述子(descriptor)となる、 列挙可能なプロパティを持つオブジェクトを指定します。(例を参照)

例

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

Polyfill

全ての名前とプロパティが初期値を参照する元のままの実行環境であるとすると、 Object.definePropertiesはJavaScript内で下記の再実装とほとんど完全に同じになります。 (isCallableのコメントに注意してください。)

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

    function isCallable(v) {
      // 注意! : 関数以外の値が呼び出し可能である場合は、
      //         必要に応じて修正してください。
      return typeof v === "function";
    }

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

    var d = {};

    if (hasProperty(desc, "enumerable"))
      d.enumerable = !!obj.enumerable;
    if (hasProperty(desc, "configurable"))
      d.configurable = !!obj.configurable;
    if (hasProperty(desc, "value"))
      d.value = obj.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;
}

仕様

ブラウザ互換性

デスクトップ

機能	Chrome	Firefox (Gecko)	IE	Opera	Safari
基本	5(それ以前は未調査)	4.0 (2)	9	11.6	5

モバイル

機能	Android	Firefox Mobile	IE Mobile	Opera Mobile	Safari Mobile
基本	◯	4.0 (2)	?	11.5	◯

Kangax氏の互換性テーブルに基づきます。

関連項目

• Object.defineProperty()
• Object.keys()
• Enumerability and ownership of properties

 Back to top