在此页

• 句法
• Polyfill
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Object.defineProperties() method defines new or modifies existing properties directly on an object, returning the object.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

Object.defineProperties(obj, props)
					

参数

obj

The object on which to define or modify properties.

props

An object whose keys represent the names of properties to be defined or modified and whose values are objects describing those properties. Each value in props must be either a data descriptor or an accessor descriptor; it cannot be both (see Object.defineProperty() for more details).

Data descriptors and accessor descriptors may optionally contain the following keys:

configurable

true if and only if the type of this property descriptor may be changed and if the property may be deleted from the corresponding object.
Defaults to false .

enumerable

true if and only if this property shows up during enumeration of the properties on the corresponding object.
Defaults to false .

A data descriptor also has the following optional keys:

value

The value associated with the property. Can be any valid JavaScript value (number, object, function, etc).
Defaults to undefined .

writable

true if and only if the value associated with the property may be changed with an assignment operator .
Defaults to false .

An accessor descriptor also has the following optional keys:

get

A function which serves as a getter for the property, or undefined if there is no getter. The function's return value will be used as the value of the property.
Defaults to undefined .

set

A function which serves as a setter for the property, or undefined if there is no setter. The function will receive as its only argument the new value being assigned to the property.
Defaults to undefined .

If a descriptor has neither of value , writable , get and set keys, it is treated as a data descriptor. If a descriptor has both value or writable and get or set keys, an exception is thrown.

返回值

The object that was passed to the function.

Polyfill

Assuming a pristine execution environment with all names and properties referring to their initial values, Object.defineProperties is almost completely equivalent (note the comment in isCallable ) to the following reimplementation in JavaScript:

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;
}
					

范例

Using Object.defineProperties

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

规范

规范
ECMAScript (ECMA-262) The definition of 'Object.defineProperties' in that specification.

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
defineProperties	Chrome 5	Edge 12	Firefox 4	IE 9	Opera 11.6	Safari 5	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 12	Safari iOS 5	Samsung Internet Android 1.0	nodejs Yes

图例

完整支持

完整支持

另请参阅

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

元数据

• 最后修改： May 20, 2020

相关话题

1. 标准内置对象
2. Object
3. 特性
   1. Object.prototype.__proto__
   2. Object.prototype.constructor
4. 方法
   1. Object.assign()
   2. Object.create()
   3. Object.defineProperties()
   4. Object.defineProperty()
   5. Object.entries()
   6. Object.freeze()
   7. Object.fromEntries()
   8. Object.getOwnPropertyDescriptor()
   9. Object.getOwnPropertyDescriptors()
   10. Object.getOwnPropertyNames()
   11. Object.getOwnPropertySymbols()
   12. Object.getPrototypeOf()
   13. Object.is()
   14. Object.isExtensible()
   15. Object.isFrozen()
   16. Object.isSealed()
   17. Object.keys()
   18. Object.preventExtensions()
   19. Object.prototype.__defineGetter__()
   20. Object.prototype.__defineSetter__()
   21. Object.prototype.__lookupGetter__()
   22. Object.prototype.__lookupSetter__()
   23. Object.prototype.hasOwnProperty()
   24. Object.prototype.isPrototypeOf()
   25. Object.prototype.propertyIsEnumerable()
   26. Object.prototype.toLocaleString()
   27. Object.prototype.toSource()
   28. Object.prototype.toString()
   29. Object.prototype.valueOf()
   30. Object.seal()
   31. Object.setPrototypeOf()
   32. Object.values()
5. 继承：
6. Function
7. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
8. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()