---
title: Proxy handler
slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler
tags:
  - ECMAScript 2015
  - JavaScript
  - Proxy
translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy
translation_of_original: Web/JavaScript/Reference/Global_Objects/Proxy/handler
---
<div>{{JSRef}}</div>

<div>Proxy 的 handler 对象是一个占位符对象，它包含了用于 {{jsxref("Proxy")}} 的陷阱（Trap）函数。</div>

<div>此处可以理解为由Proxy所暴露出的钩子函数，handler作为挂载钩子函数的对象存在，不同的操作会触发不同的钩子函数</div>

<div>，handler提供了覆写钩子函数的方法。</div>

<h2 id="方法">方法</h2>

<p>所有的陷阱是可选的。如果某个陷阱没有定义，那么就会保留默认行为。</p>

<dl>
 <dt>{{jsxref("Global_Objects/Proxy/handler/getPrototypeOf", "handler.getPrototypeOf()")}}</dt>
 <dd>在读取代理对象的原型时触发该操作，比如在执行 <code>{{jsxref("Object.getPrototypeOf")}}(proxy)</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/setPrototypeOf", "handler.setPrototypeOf()")}}</dt>
 <dd>在设置代理对象的原型时触发该操作，比如在执行 <code>{{jsxref("Object.setPrototypeOf")}}(proxy, null)</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/isExtensible", "handler.isExtensible()")}}</dt>
 <dd>在判断一个代理对象是否是可扩展时触发该操作，比如在执行 <code>{{jsxref("Object.isExtensible")}}(proxy)</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/preventExtensions", "handler.preventExtensions()")}}</dt>
 <dd>在让一个代理对象不可扩展时触发该操作，比如在执行 <code>{{jsxref("Object.preventExtensions")}}(proxy)</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/getOwnPropertyDescriptor", "handler.getOwnPropertyDescriptor()")}}</dt>
 <dd>在获取代理对象某个属性的属性描述时触发该操作，比如在执行 <code>{{jsxref("Object.getOwnPropertyDescriptor")}}(proxy, "foo")</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/defineProperty", "handler.defineProperty()")}}</dt>
 <dd>在定义代理对象某个属性时的属性描述时触发该操作，比如在执行 <code>{{jsxref("Object.defineProperty")}}(proxy, "foo", {})</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/has", "handler.has()")}}</dt>
 <dd>在判断代理对象是否拥有某个属性时触发该操作，比如在执行 <code>"foo" {{jsxref("Operators/in", "in")}} proxy</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/get", "handler.get()")}}</dt>
 <dd>在读取代理对象的某个属性时触发该操作，比如在执行 <code>proxy.foo</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/set", "handler.set()")}}</dt>
 <dd>在给代理对象的某个属性赋值时触发该操作，比如在执行 <code>proxy.foo = 1</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/deleteProperty", "handler.deleteProperty()")}}</dt>
 <dd>在删除代理对象的某个属性时触发该操作，即使用 {{jsxref("Operators/delete", "delete")}} 运算符，比如在执行 <code>delete proxy.foo</code> 时。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/ownKeys", "handler.ownKeys()")}}</dt>
 <dd>{{jsxref("Object.getOwnPropertyNames")}} 和{{jsxref("Object.getOwnPropertySymbols")}} 的陷阱。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/apply", "handler.apply()")}}</dt>
 <dd>函数调用操作的陷阱。</dd>
 <dt>{{jsxref("Global_Objects/Proxy/handler/construct", "handler.construct()")}}</dt>
 <dd>{{jsxref("Operators/new", "new")}} 运算符的陷阱。</dd>
</dl>

<p>一些不标准的陷阱已经<a href="/zh-CN/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#Proxy">废弃并且被移除了</a></p>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots', 'Proxy Object Internal Methods and Internal Slots')}}</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



<p>{{Compat("javascript.builtins.Proxy.handler")}}</p>

<h2 id="相关链接">相关链接</h2>

<ul>
 <li>{{JSxRef("Proxy")}}</li>
</ul>