handler.defineProperty()

The following parameters are passed to the defineProperty() method. this is bound to the handler.

target

The target object.

property

A string or Symbol representing the property name.

descriptor

The descriptor for the property being defined or modified.

The defineProperty() method must return a Boolean indicating whether or not the property has been successfully defined. Other values are coerced to booleans.

Many operations, including Object.defineProperty() and Object.defineProperties(), throw a TypeError if the [[DefineOwnProperty]] internal method returns false.

This trap can intercept these operations:

• Object.defineProperty(), Object.defineProperties()
• Reflect.defineProperty()

Or any other operation that invokes the [[DefineOwnProperty]] internal method.

The proxy's [[DefineOwnProperty]] internal method throws a TypeError if the handler definition violates one of the following invariants:

• A property cannot be added, if the target object is not extensible. That is, if Reflect.isExtensible() returns false on target, and Reflect.getOwnPropertyDescriptor() returns undefined for the property on target, then the trap must return a falsy value.
• A property cannot be non-configurable, unless there exists a corresponding non-configurable own property of the target object. That is, if Reflect.getOwnPropertyDescriptor() returns undefined or configurable: true for the property on target, and descriptor.configurable is false, then the trap must return a falsy value.
• A non-configurable property cannot be non-writable, unless there exists a corresponding non-configurable, non-writable own property of the target object. That is, if Reflect.getOwnPropertyDescriptor() returns configurable: false, writable: true for the property on target, and descriptor.writable is false, then the trap must return a falsy value.
• If a property has a corresponding property on the target object, then the target object property's descriptor must be compatible with descriptor. That is, pretending target is an ordinary object, and Object.defineProperty(target, property, descriptor) would throw an error, then the trap must return a falsy value. The Object.defineProperty() reference contains more information, but to summarize, when the target property is non-configurable, the following must hold:
  • configurable, enumerable, get, and set cannot be changed
  • the property cannot be switched between data and accessor
  • the writable attribute can only be changed from true to false
  • the value attribute can only be changed if writable is true

The following code traps Object.defineProperty().

const p = new Proxy(
  {},
  {
    defineProperty(target, prop, descriptor) {
      console.log(`called: ${prop}`);
      return true;
    },
  },
);

const desc = { configurable: true, enumerable: true, value: 10 };
Object.defineProperty(p, "a", desc); // "called: a"

When calling Object.defineProperty() or Reflect.defineProperty(), the descriptor passed to defineProperty() trap has one restriction—only following properties are usable (non-standard properties will be ignored):

• enumerable
• configurable
• writable
• value
• get
• set

const p = new Proxy(
  {},
  {
    defineProperty(target, prop, descriptor) {
      console.log(descriptor);
      return Reflect.defineProperty(target, prop, descriptor);
    },
  },
);

Object.defineProperty(p, "name", {
  value: "proxy",
  type: "custom",
}); // { value: 'proxy' }

• Proxy
• Proxy() constructor
• Object.defineProperty()
• Reflect.defineProperty()