页面模式偏好

28 反射

28.1 Reflect 对象

Reflect 对象：

28.1.1 Reflect.apply ( target, thisArg, args )

调用时，此函数执行以下步骤：

  1. 如果 IsCallable(target) 是 false，则抛出 TypeError 异常。
  2. 令 argList 为 ? CreateListFromArrayLike(args)。
  3. 执行 PrepareForTailCall()。
  4. 返回 ? Call(target, thisArg, argList)。

28.1.2 Reflect.construct ( target, args [ , newTarget ] )

调用时，此函数执行以下步骤：

  1. 如果 IsConstructor(target) 是 false，则抛出 TypeError 异常。
  2. 如果不存在 newTarget，则将 newTarget 设置为 target。
  3. 否则如果 IsConstructor(newTarget) 是 false，则抛出 TypeError 异常。
  4. 令 argList 为 ? CreateListFromArrayLike(args)。
  5. 返回 ? Construct(target, argList, newTarget)。

28.1.3 Reflect.defineProperty ( target, key, attrs )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 propertyKey 为 ? ToPropertyKey(key)。
  3. 令 propertyDesc 为 ? ToPropertyDescriptor(attrs)。
  4. 返回 ? target.[[DefineOwnProperty]](propertyKey, propertyDesc)。

28.1.4 Reflect.deleteProperty ( target, key )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 propertyKey 为 ? ToPropertyKey(key)。
  3. 返回 ? target.[[Delete]](propertyKey)。

28.1.5 Reflect.get ( target, key [ , receiver ] )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 propertyKey 为 ? ToPropertyKey(key)。
  3. 如果不存在 receiver，则
    1. 将 receiver 设置为 target。
  4. 返回 ? target.[[Get]](propertyKey, receiver)。

28.1.6 Reflect.getOwnPropertyDescriptor ( target, key )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 propertyKey 为 ? ToPropertyKey(key)。
  3. 令 propertyDesc 为 ? target.[[GetOwnProperty]](propertyKey)。
  4. 返回 FromPropertyDescriptor(propertyDesc)。

28.1.7 Reflect.getPrototypeOf ( target )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 返回 ? target.[[GetPrototypeOf]]()。

28.1.8 Reflect.has ( target, key )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 propertyKey 为 ? ToPropertyKey(key)。
  3. 返回 ? target.[[HasProperty]](propertyKey)。

28.1.9 Reflect.isExtensible ( target )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 返回 ? target.[[IsExtensible]]()。

28.1.10 Reflect.ownKeys ( target )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 keys 为 ? target.[[OwnPropertyKeys]]()。
  3. 返回 CreateArrayFromList(keys)。

28.1.11 Reflect.preventExtensions ( target )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 返回 ? target.[[PreventExtensions]]()。

28.1.12 Reflect.set ( target, key, value [ , receiver ] )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 令 propertyKey 为 ? ToPropertyKey(key)。
  3. 如果不存在 receiver，则
    1. 将 receiver 设置为 target。
  4. 返回 ? target.[[Set]](propertyKey, value, receiver)。

28.1.13 Reflect.setPrototypeOf ( target, proto )

调用时，此函数执行以下步骤：

  1. 如果 target 不是 Object，则抛出 TypeError 异常。
  2. 如果 proto 不是 Object 且 proto 不是 null，则抛出 TypeError 异常。
  3. 返回 ? target.[[SetPrototypeOf]](proto)。

28.1.14 Reflect [ %Symbol.toStringTag% ]

%Symbol.toStringTag% 属性的初始值是 String 值 "Reflect"。

此属性具有特性 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: true }。

28.2 Proxy 对象

28.2.1 Proxy 构造函数

Proxy 构造函数：

  • 是 %Proxy%。
  • 是全局对象的 "Proxy" 属性的初始值。
  • 作为构造函数调用时，创建并初始化新的 Proxy 对象。
  • 不旨在作为函数调用，并且以这种方式调用时会抛出异常。

28.2.1.1 Proxy ( target, handler )

调用时，此函数执行以下步骤：

  1. 如果 NewTarget 是 undefined，则抛出 TypeError 异常。
  2. 返回 ? ProxyCreate(target, handler)。

28.2.2 Proxy 构造函数的属性

Proxy 构造函数：

  • 具有 [[Prototype]] 内部槽，其值是 %Function.prototype%。
  • 不具有 "prototype" 属性，因为 Proxy 对象没有需要初始化的 [[Prototype]] 内部槽。
  • 具有以下属性：

28.2.2.1 Proxy.revocable ( target, handler )

此函数创建一个可撤销的 Proxy 对象。

调用时，它执行以下步骤：

  1. 令 proxy 为 ? ProxyCreate(target, handler)。
  2. 令 revokerClosure 为不带参数且不捕获任何内容的新 Abstract Closure，它在被调用时执行以下步骤：
    1. 令 activeFunc 为活动函数对象。
    2. 令 revocableProxy 为 activeFunc.[[RevocableProxy]]。
    3. 如果 revocableProxy 是 null，则返回 NormalCompletion(undefined)。
    4. 将 activeFunc.[[RevocableProxy]] 设置为 null。
    5. 断言：revocableProxy 是 Proxy exotic object。
    6. 将 revocableProxy.[[ProxyTarget]] 设置为 null。
    7. 将 revocableProxy.[[ProxyHandler]] 设置为 null。
    8. 返回 NormalCompletion(undefined)。
  3. 令 revoker 为 CreateBuiltinFunction(revokerClosure, 0, "", « [[RevocableProxy]] »)。
  4. 将 revoker.[[RevocableProxy]] 设置为 proxy。
  5. 令 result 为 OrdinaryObjectCreate(%Object.prototype%)。
  6. 执行 ! CreateDataPropertyOrThrow(result, "proxy", proxy)。
  7. 执行 ! CreateDataPropertyOrThrow(result, "revoke", revoker)。
  8. 返回 result。

28.3 Module Namespace 对象

Module Namespace Object 是一种 module namespace exotic object，它提供基于运行时属性访问模块导出绑定的能力。Module Namespace Object 没有构造函数。相反，对于由包含 NameSpaceImport 的 ImportDeclaration 导入的每个模块，都会创建此类对象。

除了 10.4.6 中规定的属性外，每个 Module Namespace Object 还具有以下自有属性：

28.3.1 %Symbol.toStringTag%

%Symbol.toStringTag% 属性的初始值是 String 值 "Module"。

此属性具有特性 { [[Writable]]: false, [[Enumerable]]: false, [[Configurable]]: false }。