Proxy() constructor is used to create Proxy 对象。

句法

new Proxy(target, handler)
					

参数

target
A target object to wrap with Proxy . It can be any sort of object, including a native array, a function, or even another proxy.
handler

An object whose properties are functions that define the behavior of the proxy when an operation is performed on it.

描述

使用 Proxy() constructor to create a new Proxy object. This constructor takes two mandatory arguments:

  • target is the object for which you want to create the proxy
  • handler is the object that defines the custom behavior of the proxy.

An empty handler will create a proxy that behaves, in almost all respects, exactly like the target. By defining any of a set group of functions on the handler object, you can customise specific aspects of the proxy's behavior. For example, by defining get() you can provide a customised version of the target's property accessor .

Handler functions

This section lists all the handler functions you can define. Handler functions are sometimes called traps , because they trap calls to the underlying target object.

handler.apply()

A trap for a function call.

handler.construct()
A trap for the new operator.
handler.defineProperty()
A trap for Object.defineProperty .
handler.deleteProperty()
A trap for the delete operator.
handler.get()

A trap for getting property values.

handler.getOwnPropertyDescriptor()
A trap for Object.getOwnPropertyDescriptor .
handler.getPrototypeOf()
A trap for Object.getPrototypeOf .
handler.has()
A trap for the in operator.
handler.isExtensible()
A trap for Object.isExtensible .
handler.ownKeys()
A trap for Object.getOwnPropertyNames and Object.getOwnPropertySymbols .
handler.preventExtensions()
A trap for Object.preventExtensions .
handler.set()

A trap for setting property values.

handler.setPrototypeOf()
A trap for Object.setPrototypeOf .

范例

Selectively proxy property accessors

In this example the target has two properties, notProxied and proxied . We define a handler that returns a different value for proxied , and lets any other accesses through to the target.

const target = {
  notProxied: "original value",
  proxied: "original value"
};
const handler = {
  get: function(target, prop, receiver) {
    if (prop === "proxied") {
      return "replaced value";
    }
    return Reflect.get(...arguments);
  }
};
const proxy = new Proxy(target, handler);
console.log(proxy.notProxied); // "original value"
console.log(proxy.proxied);    // "replaced value"
					

规范

规范
ECMAScript (ECMA-262)
The definition of 'Proxy constructor' 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
Proxy() 构造函数 Chrome 49 Edge 12 Firefox 18 IE No Opera 36 Safari 10 WebView Android 49 Chrome Android 49 Firefox Android 18 Opera Android 36 Safari iOS 10 Samsung Internet Android 5.0 nodejs 6.0.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

元数据

  • 最后修改: