大网数据广告活动
Web 标准与前端开发

handler.setPrototypeOf()

· 52CE 我爱测

**`handler.setPrototypeOf()`** 方法主要用来拦截 Object.setPrototypeOf().

handler.setPrototypeOf() 方法主要用来拦截 Object.setPrototypeOf().

语法

var p = new Proxy(target, {
  setPrototypeOf: function (target, prototype) {},
});

参数

以下参数传递给 setPrototypeOf 方法。

  • target
    • : 被拦截目标对象。
  • prototype
    • : 对象新原型或为null.

返回值

如果成功修改了[[Prototype]], setPrototypeOf 方法返回 true,否则返回 false.

描述

这个 handler.setPrototypeOf 方法用于拦截 Object.setPrototypeOf().

拦截

这个方法可以拦截以下操作:

  • Object.setPrototypeOf()
  • Reflect.setPrototypeOf()

不变量

如果违反了下列规则,则 proxy 将抛出一个 TypeError:

  • 如果 target 不可扩展,原型参数必须与 Object.getPrototypeOf(target) 的值相同。

示例

如果你不想为你的对象设置一个新的原型,你的 handler 的 setPrototypeOf 方法可以返回 false,也可以抛出异常。

前一种做法意味着,那些在修改失败时会抛出异常的操作必须自己创建这个异常。例如,Object.setPrototypeOf() 会自行创建并抛出 TypeError。如果这次修改是由通常不会在失败时抛出异常的操作执行的,例如 Reflect.setPrototypeOf(),那么不会抛出任何异常。

var handlerReturnsFalse = {
  setPrototypeOf(target, newProto) {
    return false;
  },
};

var newProto = {},
  target = {};

var p1 = new Proxy(target, handlerReturnsFalse);
Object.setPrototypeOf(p1, newProto); // throws a TypeError
Reflect.setPrototypeOf(p1, newProto); // returns false

后一种做法会让任何尝试修改的操作都抛出异常。如果你希望即使是不抛出异常的操作在失败时也能抛出异常,或者你想抛出自定义的异常值,就必须采用这种做法。

var handlerThrows = {
  setPrototypeOf(target, newProto) {
    throw new Error("custom error");
  },
};

var newProto = {},
  target = {};

var p2 = new Proxy(target, handlerThrows);
Object.setPrototypeOf(p2, newProto); // throws new Error("custom error")
Reflect.setPrototypeOf(p2, newProto); // throws new Error("custom error")

Specifications

Browser compatibility

See also

  • Proxy
  • Proxy/Proxy
  • Object.setPrototypeOf()
  • Reflect.setPrototypeOf()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。