handler.preventExtensions()

¥Syntax

new Proxy(target, {
  preventExtensions(target) {
  }
});

¥Parameters

以下参数传递给 preventExtensions() 方法。this 绑定到处理程序。

¥The following parameter is passed to the preventExtensions() method. this is bound to the handler.

target

目标对象。

¥Return value

preventExtensions() 方法必须返回布尔值。

¥The preventExtensions() method must return a boolean value.

¥Description

¥Interceptions

该陷阱可以拦截以下操作：

¥This trap can intercept these operations:

• Object.preventExtensions()
• Reflect.preventExtensions()
• Object.seal()
• Object.freeze()

或调用 [[PreventExtensions]] 内部方法 的任何其他操作。

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

¥Invariants

如果违反以下不变量，则陷阱在调用时会抛出 TypeError。

¥If the following invariants are violated, the trap throws a TypeError when invoked.

• 如果 Object.isExtensible(proxy) 是 false，则 Object.preventExtensions(proxy) 仅返回 true。

¥Examples

¥Trapping of preventExtensions

以下代码捕获 Object.preventExtensions()。

¥The following code traps Object.preventExtensions().

const p = new Proxy(
  {},
  {
    preventExtensions(target) {
      console.log("called");
      Object.preventExtensions(target);
      return true;
    },
  },
);

console.log(Object.preventExtensions(p));
// "called"
// false

以下代码违反了不变量。

¥The following code violates the invariant.

const p = new Proxy(
  {},
  {
    preventExtensions(target) {
      return true;
    },
  },
);

Object.preventExtensions(p); // TypeError is thrown

¥See also

• Proxy
• Proxy() 构造函数
• Object.preventExtensions()
• Reflect.preventExtensions()