|
|
// Copyright (C) 2011-2012 Software Languages Lab, Vrije Universiteit Brussel
// This code is dual-licensed under both the Apache License and the MPL
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
/* Version: MPL 1.1 * * The contents of this file are subject to the Mozilla Public License Version * 1.1 (the "License"); you may not use this file except in compliance with * the License. You may obtain a copy of the License at * http://www.mozilla.org/MPL/
* * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License * for the specific language governing rights and limitations under the * License. * * The Original Code is a shim for the ES-Harmony reflection module * * The Initial Developer of the Original Code is * Tom Van Cutsem, Vrije Universiteit Brussel. * Portions created by the Initial Developer are Copyright (C) 2011-2012 * the Initial Developer. All Rights Reserved. * * Contributor(s): * */
// ----------------------------------------------------------------------------
// This file is a polyfill for the upcoming ECMAScript Reflect API,
// including support for Proxies. See the draft specification at:
// http://wiki.ecmascript.org/doku.php?id=harmony:reflect_api
// http://wiki.ecmascript.org/doku.php?id=harmony:direct_proxies
// For an implementation of the Handler API, see handlers.js, which implements:
// http://wiki.ecmascript.org/doku.php?id=harmony:virtual_object_api
// This implementation supersedes the earlier polyfill at:
// code.google.com/p/es-lab/source/browse/trunk/src/proxies/DirectProxies.js
// This code was tested on tracemonkey / Firefox 12
// (and should run fine on older Firefox versions starting with FF4)
// The code also works correctly on
// v8 --harmony_proxies --harmony_weakmaps (v3.6.5.1)
// Language Dependencies:
// - ECMAScript 5/strict
// - "old" (i.e. non-direct) Harmony Proxies
// - Harmony WeakMaps
// Patches:
// - Object.{freeze,seal,preventExtensions}
// - Object.{isFrozen,isSealed,isExtensible}
// - Object.getPrototypeOf
// - Object.keys
// - Object.prototype.valueOf
// - Object.prototype.isPrototypeOf
// - Object.prototype.toString
// - Object.prototype.hasOwnProperty
// - Object.getOwnPropertyDescriptor
// - Object.defineProperty
// - Object.defineProperties
// - Object.getOwnPropertyNames
// - Object.getOwnPropertySymbols
// - Object.getPrototypeOf
// - Object.setPrototypeOf
// - Object.assign
// - Function.prototype.toString
// - Date.prototype.toString
// - Array.isArray
// - Array.prototype.concat
// - Proxy
// Adds new globals:
// - Reflect
// Direct proxies can be created via Proxy(target, handler)
// ----------------------------------------------------------------------------
(function(global){ // function-as-module pattern
"use strict";
// === Direct Proxies: Invariant Enforcement ===
// Direct proxies build on non-direct proxies by automatically wrapping
// all user-defined proxy handlers in a Validator handler that checks and
// enforces ES5 invariants.
// A direct proxy is a proxy for an existing object called the target object.
// A Validator handler is a wrapper for a target proxy handler H.
// The Validator forwards all operations to H, but additionally
// performs a number of integrity checks on the results of some traps,
// to make sure H does not violate the ES5 invariants w.r.t. non-configurable
// properties and non-extensible, sealed or frozen objects.
// For each property that H exposes as own, non-configurable
// (e.g. by returning a descriptor from a call to getOwnPropertyDescriptor)
// the Validator handler defines those properties on the target object.
// When the proxy becomes non-extensible, also configurable own properties
// are checked against the target.
// We will call properties that are defined on the target object
// "fixed properties".
// We will name fixed non-configurable properties "sealed properties".
// We will name fixed non-configurable non-writable properties "frozen
// properties".
// The Validator handler upholds the following invariants w.r.t. non-configurability:
// - getOwnPropertyDescriptor cannot report sealed properties as non-existent
// - getOwnPropertyDescriptor cannot report incompatible changes to the
// attributes of a sealed property (e.g. reporting a non-configurable
// property as configurable, or reporting a non-configurable, non-writable
// property as writable)
// - getPropertyDescriptor cannot report sealed properties as non-existent
// - getPropertyDescriptor cannot report incompatible changes to the
// attributes of a sealed property. It _can_ report incompatible changes
// to the attributes of non-own, inherited properties.
// - defineProperty cannot make incompatible changes to the attributes of
// sealed properties
// - deleteProperty cannot report a successful deletion of a sealed property
// - hasOwn cannot report a sealed property as non-existent
// - has cannot report a sealed property as non-existent
// - get cannot report inconsistent values for frozen data
// properties, and must report undefined for sealed accessors with an
// undefined getter
// - set cannot report a successful assignment for frozen data
// properties or sealed accessors with an undefined setter.
// - get{Own}PropertyNames lists all sealed properties of the target.
// - keys lists all enumerable sealed properties of the target.
// - enumerate lists all enumerable sealed properties of the target.
// - if a property of a non-extensible proxy is reported as non-existent,
// then it must forever be reported as non-existent. This applies to
// own and inherited properties and is enforced in the
// deleteProperty, get{Own}PropertyDescriptor, has{Own},
// get{Own}PropertyNames, keys and enumerate traps
// Violation of any of these invariants by H will result in TypeError being
// thrown.
// Additionally, once Object.preventExtensions, Object.seal or Object.freeze
// is invoked on the proxy, the set of own property names for the proxy is
// fixed. Any property name that is not fixed is called a 'new' property.
// The Validator upholds the following invariants regarding extensibility:
// - getOwnPropertyDescriptor cannot report new properties as existent
// (it must report them as non-existent by returning undefined)
// - defineProperty cannot successfully add a new property (it must reject)
// - getOwnPropertyNames cannot list new properties
// - hasOwn cannot report true for new properties (it must report false)
// - keys cannot list new properties
// Invariants currently not enforced:
// - getOwnPropertyNames lists only own property names
// - keys lists only enumerable own property names
// Both traps may list more property names than are actually defined on the
// target.
// Invariants with regard to inheritance are currently not enforced.
// - a non-configurable potentially inherited property on a proxy with
// non-mutable ancestry cannot be reported as non-existent
// (An object with non-mutable ancestry is a non-extensible object whose
// [[Prototype]] is either null or an object with non-mutable ancestry.)
// Changes in Handler API compared to previous harmony:proxies, see:
// http://wiki.ecmascript.org/doku.php?id=strawman:direct_proxies
// http://wiki.ecmascript.org/doku.php?id=harmony:direct_proxies
// ----------------------------------------------------------------------------
// ---- WeakMap polyfill ----
// TODO: find a proper WeakMap polyfill
// define an empty WeakMap so that at least the Reflect module code
// will work in the absence of WeakMaps. Proxy emulation depends on
// actual WeakMaps, so will not work with this little shim.
if (typeof WeakMap === "undefined") { global.WeakMap = function(){}; global.WeakMap.prototype = { get: function(k) { return undefined; }, set: function(k,v) { throw new Error("WeakMap not supported"); } }; }
// ---- Normalization functions for property descriptors ----
function isStandardAttribute(name) { return /^(get|set|value|writable|enumerable|configurable)$/.test(name); }
// Adapted from ES5 section 8.10.5
function toPropertyDescriptor(obj) { if (Object(obj) !== obj) { throw new TypeError("property descriptor should be an Object, given: "+ obj); } var desc = {}; if ('enumerable' in obj) { desc.enumerable = !!obj.enumerable; } if ('configurable' in obj) { desc.configurable = !!obj.configurable; } if ('value' in obj) { desc.value = obj.value; } if ('writable' in obj) { desc.writable = !!obj.writable; } if ('get' in obj) { var getter = obj.get; if (getter !== undefined && typeof getter !== "function") { throw new TypeError("property descriptor 'get' attribute must be "+ "callable or undefined, given: "+getter); } desc.get = getter; } if ('set' in obj) { var setter = obj.set; if (setter !== undefined && typeof setter !== "function") { throw new TypeError("property descriptor 'set' attribute must be "+ "callable or undefined, given: "+setter); } desc.set = setter; } if ('get' in desc || 'set' in desc) { if ('value' in desc || 'writable' in desc) { throw new TypeError("property descriptor cannot be both a data and an "+ "accessor descriptor: "+obj); } } return desc; }
function isAccessorDescriptor(desc) { if (desc === undefined) return false; return ('get' in desc || 'set' in desc); } function isDataDescriptor(desc) { if (desc === undefined) return false; return ('value' in desc || 'writable' in desc); } function isGenericDescriptor(desc) { if (desc === undefined) return false; return !isAccessorDescriptor(desc) && !isDataDescriptor(desc); }
function toCompletePropertyDescriptor(desc) { var internalDesc = toPropertyDescriptor(desc); if (isGenericDescriptor(internalDesc) || isDataDescriptor(internalDesc)) { if (!('value' in internalDesc)) { internalDesc.value = undefined; } if (!('writable' in internalDesc)) { internalDesc.writable = false; } } else { if (!('get' in internalDesc)) { internalDesc.get = undefined; } if (!('set' in internalDesc)) { internalDesc.set = undefined; } } if (!('enumerable' in internalDesc)) { internalDesc.enumerable = false; } if (!('configurable' in internalDesc)) { internalDesc.configurable = false; } return internalDesc; }
function isEmptyDescriptor(desc) { return !('get' in desc) && !('set' in desc) && !('value' in desc) && !('writable' in desc) && !('enumerable' in desc) && !('configurable' in desc); }
function isEquivalentDescriptor(desc1, desc2) { return sameValue(desc1.get, desc2.get) && sameValue(desc1.set, desc2.set) && sameValue(desc1.value, desc2.value) && sameValue(desc1.writable, desc2.writable) && sameValue(desc1.enumerable, desc2.enumerable) && sameValue(desc1.configurable, desc2.configurable); }
// copied from http://wiki.ecmascript.org/doku.php?id=harmony:egal
function sameValue(x, y) { if (x === y) { // 0 === -0, but they are not identical
return x !== 0 || 1 / x === 1 / y; }
// NaN !== NaN, but they are identical.
// NaNs are the only non-reflexive value, i.e., if x !== x,
// then x is a NaN.
// isNaN is broken: it converts its argument to number, so
// isNaN("foo") => true
return x !== x && y !== y; }
/** * Returns a fresh property descriptor that is guaranteed * to be complete (i.e. contain all the standard attributes). * Additionally, any non-standard enumerable properties of * attributes are copied over to the fresh descriptor. * * If attributes is undefined, returns undefined. * * See also: http://wiki.ecmascript.org/doku.php?id=harmony:proxies_semantics
*/ function normalizeAndCompletePropertyDescriptor(attributes) { if (attributes === undefined) { return undefined; } var desc = toCompletePropertyDescriptor(attributes); // Note: no need to call FromPropertyDescriptor(desc), as we represent
// "internal" property descriptors as proper Objects from the start
for (var name in attributes) { if (!isStandardAttribute(name)) { Object.defineProperty(desc, name, { value: attributes[name], writable: true, enumerable: true, configurable: true }); } } return desc; }
/** * Returns a fresh property descriptor whose standard * attributes are guaranteed to be data properties of the right type. * Additionally, any non-standard enumerable properties of * attributes are copied over to the fresh descriptor. * * If attributes is undefined, will throw a TypeError. * * See also: http://wiki.ecmascript.org/doku.php?id=harmony:proxies_semantics
*/ function normalizePropertyDescriptor(attributes) { var desc = toPropertyDescriptor(attributes); // Note: no need to call FromGenericPropertyDescriptor(desc), as we represent
// "internal" property descriptors as proper Objects from the start
for (var name in attributes) { if (!isStandardAttribute(name)) { Object.defineProperty(desc, name, { value: attributes[name], writable: true, enumerable: true, configurable: true }); } } return desc; }
// store a reference to the real ES5 primitives before patching them later
var prim_preventExtensions = Object.preventExtensions, prim_seal = Object.seal, prim_freeze = Object.freeze, prim_isExtensible = Object.isExtensible, prim_isSealed = Object.isSealed, prim_isFrozen = Object.isFrozen, prim_getPrototypeOf = Object.getPrototypeOf, prim_getOwnPropertyDescriptor = Object.getOwnPropertyDescriptor, prim_defineProperty = Object.defineProperty, prim_defineProperties = Object.defineProperties, prim_keys = Object.keys, prim_getOwnPropertyNames = Object.getOwnPropertyNames, prim_getOwnPropertySymbols = Object.getOwnPropertySymbols, prim_assign = Object.assign, prim_isArray = Array.isArray, prim_concat = Array.prototype.concat, prim_isPrototypeOf = Object.prototype.isPrototypeOf, prim_hasOwnProperty = Object.prototype.hasOwnProperty;
// these will point to the patched versions of the respective methods on
// Object. They are used within this module as the "intrinsic" bindings
// of these methods (i.e. the "original" bindings as defined in the spec)
var Object_isFrozen, Object_isSealed, Object_isExtensible, Object_getPrototypeOf, Object_getOwnPropertyNames;
/** * A property 'name' is fixed if it is an own property of the target. */ function isFixed(name, target) { return ({}).hasOwnProperty.call(target, name); } function isSealed(name, target) { var desc = Object.getOwnPropertyDescriptor(target, name); if (desc === undefined) { return false; } return desc.configurable === false; } function isSealedDesc(desc) { return desc !== undefined && desc.configurable === false; }
/** * Performs all validation that Object.defineProperty performs, * without actually defining the property. Returns a boolean * indicating whether validation succeeded. * * Implementation transliterated from ES5.1 section 8.12.9 */ function isCompatibleDescriptor(extensible, current, desc) { if (current === undefined && extensible === false) { return false; } if (current === undefined && extensible === true) { return true; } if (isEmptyDescriptor(desc)) { return true; } if (isEquivalentDescriptor(current, desc)) { return true; } if (current.configurable === false) { if (desc.configurable === true) { return false; } if ('enumerable' in desc && desc.enumerable !== current.enumerable) { return false; } } if (isGenericDescriptor(desc)) { return true; } if (isDataDescriptor(current) !== isDataDescriptor(desc)) { if (current.configurable === false) { return false; } return true; } if (isDataDescriptor(current) && isDataDescriptor(desc)) { if (current.configurable === false) { if (current.writable === false && desc.writable === true) { return false; } if (current.writable === false) { if ('value' in desc && !sameValue(desc.value, current.value)) { return false; } } } return true; } if (isAccessorDescriptor(current) && isAccessorDescriptor(desc)) { if (current.configurable === false) { if ('set' in desc && !sameValue(desc.set, current.set)) { return false; } if ('get' in desc && !sameValue(desc.get, current.get)) { return false; } } } return true; }
// ES6 7.3.11 SetIntegrityLevel
// level is one of "sealed" or "frozen"
function setIntegrityLevel(target, level) { var ownProps = Object_getOwnPropertyNames(target); var pendingException = undefined; if (level === "sealed") { var l = +ownProps.length; var k; for (var i = 0; i < l; i++) { k = String(ownProps[i]); try { Object.defineProperty(target, k, { configurable: false }); } catch (e) { if (pendingException === undefined) { pendingException = e; } } } } else { // level === "frozen"
var l = +ownProps.length; var k; for (var i = 0; i < l; i++) { k = String(ownProps[i]); try { var currentDesc = Object.getOwnPropertyDescriptor(target, k); if (currentDesc !== undefined) { var desc; if (isAccessorDescriptor(currentDesc)) { desc = { configurable: false } } else { desc = { configurable: false, writable: false } } Object.defineProperty(target, k, desc); } } catch (e) { if (pendingException === undefined) { pendingException = e; } } } } if (pendingException !== undefined) { throw pendingException; } return Reflect.preventExtensions(target); }
// ES6 7.3.12 TestIntegrityLevel
// level is one of "sealed" or "frozen"
function testIntegrityLevel(target, level) { var isExtensible = Object_isExtensible(target); if (isExtensible) return false; var ownProps = Object_getOwnPropertyNames(target); var pendingException = undefined; var configurable = false; var writable = false; var l = +ownProps.length; var k; var currentDesc; for (var i = 0; i < l; i++) { k = String(ownProps[i]); try { currentDesc = Object.getOwnPropertyDescriptor(target, k); configurable = configurable || currentDesc.configurable; if (isDataDescriptor(currentDesc)) { writable = writable || currentDesc.writable; } } catch (e) { if (pendingException === undefined) { pendingException = e; configurable = true; } } } if (pendingException !== undefined) { throw pendingException; } if (level === "frozen" && writable === true) { return false; } if (configurable === true) { return false; } return true; }
// ---- The Validator handler wrapper around user handlers ----
/** * @param target the object wrapped by this proxy. * As long as the proxy is extensible, only non-configurable properties * are checked against the target. Once the proxy becomes non-extensible, * invariants w.r.t. non-extensibility are also enforced. * * @param handler the handler of the direct proxy. The object emulated by * this handler is validated against the target object of the direct proxy. * Any violations that the handler makes against the invariants * of the target will cause a TypeError to be thrown. * * Both target and handler must be proper Objects at initialization time. */ function Validator(target, handler) { // for non-revokable proxies, these are const references
// for revokable proxies, on revocation:
// - this.target is set to null
// - this.handler is set to a handler that throws on all traps
this.target = target; this.handler = handler; }
Validator.prototype = {
/** * If getTrap returns undefined, the caller should perform the * default forwarding behavior. * If getTrap returns normally otherwise, the return value * will be a callable trap function. When calling the trap function, * the caller is responsible for binding its |this| to |this.handler|. */ getTrap: function(trapName) { var trap = this.handler[trapName]; if (trap === undefined) { // the trap was not defined,
// perform the default forwarding behavior
return undefined; }
if (typeof trap !== "function") { throw new TypeError(trapName + " trap is not callable: "+trap); }
return trap; },
// === fundamental traps ===
/** * If name denotes a fixed property, check: * - whether targetHandler reports it as existent * - whether the returned descriptor is compatible with the fixed property * If the proxy is non-extensible, check: * - whether name is not a new property * Additionally, the returned descriptor is normalized and completed. */ getOwnPropertyDescriptor: function(name) { "use strict";
var trap = this.getTrap("getOwnPropertyDescriptor"); if (trap === undefined) { return Reflect.getOwnPropertyDescriptor(this.target, name); }
name = String(name); var desc = trap.call(this.handler, this.target, name); desc = normalizeAndCompletePropertyDescriptor(desc);
var targetDesc = Object.getOwnPropertyDescriptor(this.target, name); var extensible = Object.isExtensible(this.target);
if (desc === undefined) { if (isSealedDesc(targetDesc)) { throw new TypeError("cannot report non-configurable property '"+name+ "' as non-existent"); } if (!extensible && targetDesc !== undefined) { // if handler is allowed to return undefined, we cannot guarantee
// that it will not return a descriptor for this property later.
// Once a property has been reported as non-existent on a non-extensible
// object, it should forever be reported as non-existent
throw new TypeError("cannot report existing own property '"+name+ "' as non-existent on a non-extensible object"); } return undefined; }
// at this point, we know (desc !== undefined), i.e.
// targetHandler reports 'name' as an existing property
// Note: we could collapse the following two if-tests into a single
// test. Separating out the cases to improve error reporting.
if (!extensible) { if (targetDesc === undefined) { throw new TypeError("cannot report a new own property '"+ name + "' on a non-extensible object"); } }
if (name !== undefined) { if (!isCompatibleDescriptor(extensible, targetDesc, desc)) { throw new TypeError("cannot report incompatible property descriptor "+ "for property '"+name+"'"); } } if (desc.configurable === false) { if (targetDesc === undefined || targetDesc.configurable === true) { // if the property is configurable or non-existent on the target,
// but is reported as a non-configurable property, it may later be
// reported as configurable or non-existent, which violates the
// invariant that if the property might change or disappear, the
// configurable attribute must be true.
throw new TypeError( "cannot report a non-configurable descriptor " + "for configurable or non-existent property '" + name + "'"); } if ('writable' in desc && desc.writable === false) { if (targetDesc.writable === true) { // if the property is non-configurable, writable on the target,
// but is reported as non-configurable, non-writable, it may later
// be reported as non-configurable, writable again, which violates
// the invariant that a non-configurable, non-writable property
// may not change state.
throw new TypeError( "cannot report non-configurable, writable property '" + name + "' as non-configurable, non-writable"); } } }
return desc; },
/** * In the direct proxies design with refactored prototype climbing, * this trap is deprecated. For proxies-as-prototypes, instead * of calling this trap, the get, set, has or enumerate traps are * called instead. * * In this implementation, we "abuse" getPropertyDescriptor to * support trapping the get or set traps for proxies-as-prototypes. * We do this by returning a getter/setter pair that invokes * the corresponding traps. * * While this hack works for inherited property access, it has some * quirks: * * In Firefox, this trap is only called after a prior invocation * of the 'has' trap has returned true. Hence, expect the following * behavior: * <code> * var child = Object.create(Proxy(target, handler)); * child[name] // triggers handler.has(target, name)
* // if that returns true, triggers handler.get(target, name, child)
* </code> * * On v8, the 'in' operator, when applied to an object that inherits * from a proxy, will call getPropertyDescriptor and walk the proto-chain. * That calls the below getPropertyDescriptor trap on the proxy. The * result of the 'in'-operator is then determined by whether this trap * returns undefined or a property descriptor object. That is why * we first explicitly trigger the 'has' trap to determine whether * the property exists. * * This has the side-effect that when enumerating properties on * an object that inherits from a proxy in v8, only properties * for which 'has' returns true are returned: * * <code> * var child = Object.create(Proxy(target, handler)); * for (var prop in child) { * // only enumerates prop if (prop in child) returns true
* } * </code> */ getPropertyDescriptor: function(name) { var handler = this;
if (!handler.has(name)) return undefined;
return { get: function() { return handler.get(this, name); }, set: function(val) { if (handler.set(this, name, val)) { return val; } else { throw new TypeError("failed assignment to "+name); } }, enumerable: true, configurable: true }; },
/** * If name denotes a fixed property, check for incompatible changes. * If the proxy is non-extensible, check that new properties are rejected. */ defineProperty: function(name, desc) { // TODO(tvcutsem): the current tracemonkey implementation of proxies
// auto-completes 'desc', which is not correct. 'desc' should be
// normalized, but not completed. Consider:
// Object.defineProperty(proxy, 'foo', {enumerable:false})
// This trap will receive desc =
// {value:undefined,writable:false,enumerable:false,configurable:false}
// This will also set all other attributes to their default value,
// which is unexpected and different from [[DefineOwnProperty]].
// Bug filed: https://bugzilla.mozilla.org/show_bug.cgi?id=601329
var trap = this.getTrap("defineProperty"); if (trap === undefined) { // default forwarding behavior
return Reflect.defineProperty(this.target, name, desc); }
name = String(name); var descObj = normalizePropertyDescriptor(desc); var success = trap.call(this.handler, this.target, name, descObj); success = !!success; // coerce to Boolean
if (success === true) {
var targetDesc = Object.getOwnPropertyDescriptor(this.target, name); var extensible = Object.isExtensible(this.target);
// Note: we could collapse the following two if-tests into a single
// test. Separating out the cases to improve error reporting.
if (!extensible) { if (targetDesc === undefined) { throw new TypeError("cannot successfully add a new property '"+ name + "' to a non-extensible object"); } }
if (targetDesc !== undefined) { if (!isCompatibleDescriptor(extensible, targetDesc, desc)) { throw new TypeError("cannot define incompatible property "+ "descriptor for property '"+name+"'"); } if (isDataDescriptor(targetDesc) && targetDesc.configurable === false && targetDesc.writable === true) { if (desc.configurable === false && desc.writable === false) { // if the property is non-configurable, writable on the target
// but was successfully reported to be updated to
// non-configurable, non-writable, it can later be reported
// again as non-configurable, writable, which violates
// the invariant that non-configurable, non-writable properties
// cannot change state
throw new TypeError( "cannot successfully define non-configurable, writable " + " property '" + name + "' as non-configurable, non-writable"); } } }
if (desc.configurable === false && !isSealedDesc(targetDesc)) { // if the property is configurable or non-existent on the target,
// but is successfully being redefined as a non-configurable property,
// it may later be reported as configurable or non-existent, which violates
// the invariant that if the property might change or disappear, the
// configurable attribute must be true.
throw new TypeError( "cannot successfully define a non-configurable " + "descriptor for configurable or non-existent property '" + name + "'"); }
}
return success; },
/** * On success, check whether the target object is indeed non-extensible. */ preventExtensions: function() { var trap = this.getTrap("preventExtensions"); if (trap === undefined) { // default forwarding behavior
return Reflect.preventExtensions(this.target); }
var success = trap.call(this.handler, this.target); success = !!success; // coerce to Boolean
if (success) { if (Object_isExtensible(this.target)) { throw new TypeError("can't report extensible object as non-extensible: "+ this.target); } } return success; },
/** * If name denotes a sealed property, check whether handler rejects. */ delete: function(name) { "use strict"; var trap = this.getTrap("deleteProperty"); if (trap === undefined) { // default forwarding behavior
return Reflect.deleteProperty(this.target, name); }
name = String(name); var res = trap.call(this.handler, this.target, name); res = !!res; // coerce to Boolean
var targetDesc; if (res === true) { targetDesc = Object.getOwnPropertyDescriptor(this.target, name); if (targetDesc !== undefined && targetDesc.configurable === false) { throw new TypeError("property '" + name + "' is non-configurable "+ "and can't be deleted"); } if (targetDesc !== undefined && !Object_isExtensible(this.target)) { // if the property still exists on a non-extensible target but
// is reported as successfully deleted, it may later be reported
// as present, which violates the invariant that an own property,
// deleted from a non-extensible object cannot reappear.
throw new TypeError( "cannot successfully delete existing property '" + name + "' on a non-extensible object"); } }
return res; },
/** * The getOwnPropertyNames trap was replaced by the ownKeys trap, * which now also returns an array (of strings or symbols) and * which performs the same rigorous invariant checks as getOwnPropertyNames * * See issue #48 on how this trap can still get invoked by external libs * that don't use the patched Object.getOwnPropertyNames function. */ getOwnPropertyNames: function() { // Note: removed deprecation warning to avoid dependency on 'console'
// (and on node, should anyway use util.deprecate). Deprecation warnings
// can also be annoying when they are outside of the user's control, e.g.
// when an external library calls unpatched Object.getOwnPropertyNames.
// Since there is a clean fallback to `ownKeys`, the fact that the
// deprecated method is still called is mostly harmless anyway.
// See also issues #65 and #66.
// console.warn("getOwnPropertyNames trap is deprecated. Use ownKeys instead");
return this.ownKeys(); },
/** * Checks whether the trap result does not contain any new properties * if the proxy is non-extensible. * * Any own non-configurable properties of the target that are not included * in the trap result give rise to a TypeError. As such, we check whether the * returned result contains at least all sealed properties of the target * object. * * Additionally, the trap result is normalized. * Instead of returning the trap result directly: * - create and return a fresh Array, * - of which each element is coerced to a String * * This trap is called a.o. by Reflect.ownKeys, Object.getOwnPropertyNames * and Object.keys (the latter filters out only the enumerable own properties). */ ownKeys: function() { var trap = this.getTrap("ownKeys"); if (trap === undefined) { // default forwarding behavior
return Reflect.ownKeys(this.target); }
var trapResult = trap.call(this.handler, this.target);
// propNames is used as a set of strings
var propNames = Object.create(null); var numProps = +trapResult.length; var result = new Array(numProps);
for (var i = 0; i < numProps; i++) { var s = String(trapResult[i]); if (!Object.isExtensible(this.target) && !isFixed(s, this.target)) { // non-extensible proxies don't tolerate new own property names
throw new TypeError("ownKeys trap cannot list a new "+ "property '"+s+"' on a non-extensible object"); }
propNames[s] = true; result[i] = s; }
var ownProps = Object_getOwnPropertyNames(this.target); var target = this.target; ownProps.forEach(function (ownProp) { if (!propNames[ownProp]) { if (isSealed(ownProp, target)) { throw new TypeError("ownKeys trap failed to include "+ "non-configurable property '"+ownProp+"'"); } if (!Object.isExtensible(target) && isFixed(ownProp, target)) { // if handler is allowed to report ownProp as non-existent,
// we cannot guarantee that it will never later report it as
// existent. Once a property has been reported as non-existent
// on a non-extensible object, it should forever be reported as
// non-existent
throw new TypeError("ownKeys trap cannot report existing own property '"+ ownProp+"' as non-existent on a non-extensible object"); } } });
return result; },
/** * Checks whether the trap result is consistent with the state of the * wrapped target. */ isExtensible: function() { var trap = this.getTrap("isExtensible"); if (trap === undefined) { // default forwarding behavior
return Reflect.isExtensible(this.target); }
var result = trap.call(this.handler, this.target); result = !!result; // coerce to Boolean
var state = Object_isExtensible(this.target); if (result !== state) { if (result) { throw new TypeError("cannot report non-extensible object as extensible: "+ this.target); } else { throw new TypeError("cannot report extensible object as non-extensible: "+ this.target); } } return state; },
/** * Check whether the trap result corresponds to the target's [[Prototype]] */ getPrototypeOf: function() { var trap = this.getTrap("getPrototypeOf"); if (trap === undefined) { // default forwarding behavior
return Reflect.getPrototypeOf(this.target); }
var allegedProto = trap.call(this.handler, this.target);
if (!Object_isExtensible(this.target)) { var actualProto = Object_getPrototypeOf(this.target); if (!sameValue(allegedProto, actualProto)) { throw new TypeError("prototype value does not match: " + this.target); } }
return allegedProto; },
/** * If target is non-extensible and setPrototypeOf trap returns true, * check whether the trap result corresponds to the target's [[Prototype]] */ setPrototypeOf: function(newProto) { var trap = this.getTrap("setPrototypeOf"); if (trap === undefined) { // default forwarding behavior
return Reflect.setPrototypeOf(this.target, newProto); }
var success = trap.call(this.handler, this.target, newProto);
success = !!success; if (success && !Object_isExtensible(this.target)) { var actualProto = Object_getPrototypeOf(this.target); if (!sameValue(newProto, actualProto)) { throw new TypeError("prototype value does not match: " + this.target); } }
return success; },
/** * In the direct proxies design with refactored prototype climbing, * this trap is deprecated. For proxies-as-prototypes, for-in will * call the enumerate() trap. If that trap is not defined, the * operation is forwarded to the target, no more fallback on this * fundamental trap. */ getPropertyNames: function() { throw new TypeError("getPropertyNames trap is deprecated"); },
// === derived traps ===
/** * If name denotes a fixed property, check whether the trap returns true. */ has: function(name) { var trap = this.getTrap("has"); if (trap === undefined) { // default forwarding behavior
return Reflect.has(this.target, name); }
name = String(name); var res = trap.call(this.handler, this.target, name); res = !!res; // coerce to Boolean
if (res === false) { if (isSealed(name, this.target)) { throw new TypeError("cannot report existing non-configurable own "+ "property '"+ name + "' as a non-existent "+ "property"); } if (!Object.isExtensible(this.target) && isFixed(name, this.target)) { // if handler is allowed to return false, we cannot guarantee
// that it will not return true for this property later.
// Once a property has been reported as non-existent on a non-extensible
// object, it should forever be reported as non-existent
throw new TypeError("cannot report existing own property '"+name+ "' as non-existent on a non-extensible object"); } }
// if res === true, we don't need to check for extensibility
// even for a non-extensible proxy that has no own name property,
// the property may have been inherited
return res; },
/** * If name denotes a fixed non-configurable, non-writable data property, * check its return value against the previously asserted value of the * fixed property. */ get: function(receiver, name) {
// experimental support for invoke() trap on platforms that
// support __noSuchMethod__
/* if (name === '__noSuchMethod__') { var handler = this; return function(name, args) { return handler.invoke(receiver, name, args); } } */
var trap = this.getTrap("get"); if (trap === undefined) { // default forwarding behavior
return Reflect.get(this.target, name, receiver); }
name = String(name); var res = trap.call(this.handler, this.target, name, receiver);
var fixedDesc = Object.getOwnPropertyDescriptor(this.target, name); // check consistency of the returned value
if (fixedDesc !== undefined) { // getting an existing property
if (isDataDescriptor(fixedDesc) && fixedDesc.configurable === false && fixedDesc.writable === false) { // own frozen data property
if (!sameValue(res, fixedDesc.value)) { throw new TypeError("cannot report inconsistent value for "+ "non-writable, non-configurable property '"+ name+"'"); } } else { // it's an accessor property
if (isAccessorDescriptor(fixedDesc) && fixedDesc.configurable === false && fixedDesc.get === undefined) { if (res !== undefined) { throw new TypeError("must report undefined for non-configurable "+ "accessor property '"+name+"' without getter"); } } } }
return res; },
/** * If name denotes a fixed non-configurable, non-writable data property, * check that the trap rejects the assignment. */ set: function(receiver, name, val) { var trap = this.getTrap("set"); if (trap === undefined) { // default forwarding behavior
return Reflect.set(this.target, name, val, receiver); }
name = String(name); var res = trap.call(this.handler, this.target, name, val, receiver); res = !!res; // coerce to Boolean
// if success is reported, check whether property is truly assignable
if (res === true) { var fixedDesc = Object.getOwnPropertyDescriptor(this.target, name); if (fixedDesc !== undefined) { // setting an existing property
if (isDataDescriptor(fixedDesc) && fixedDesc.configurable === false && fixedDesc.writable === false) { if (!sameValue(val, fixedDesc.value)) { throw new TypeError("cannot successfully assign to a "+ "non-writable, non-configurable property '"+ name+"'"); } } else { if (isAccessorDescriptor(fixedDesc) && fixedDesc.configurable === false && // non-configurable
fixedDesc.set === undefined) { // accessor with undefined setter
throw new TypeError("setting a property '"+name+"' that has "+ " only a getter"); } } } }
return res; },
/** * Any own enumerable non-configurable properties of the target that are not * included in the trap result give rise to a TypeError. As such, we check * whether the returned result contains at least all sealed enumerable properties * of the target object. * * The trap should return an iterator. * * However, as implementations of pre-direct proxies still expect enumerate * to return an array of strings, we convert the iterator into an array. */ enumerate: function() { var trap = this.getTrap("enumerate"); if (trap === undefined) { // default forwarding behavior
var trapResult = Reflect.enumerate(this.target); var result = []; var nxt = trapResult.next(); while (!nxt.done) { result.push(String(nxt.value)); nxt = trapResult.next(); } return result; }
var trapResult = trap.call(this.handler, this.target); if (trapResult === null || trapResult === undefined || trapResult.next === undefined) { throw new TypeError("enumerate trap should return an iterator, got: "+ trapResult); } // propNames is used as a set of strings
var propNames = Object.create(null); // var numProps = +trapResult.length;
var result = []; // new Array(numProps);
// trapResult is supposed to be an iterator
// drain iterator to array as current implementations still expect
// enumerate to return an array of strings
var nxt = trapResult.next(); while (!nxt.done) { var s = String(nxt.value); if (propNames[s]) { throw new TypeError("enumerate trap cannot list a "+ "duplicate property '"+s+"'"); } propNames[s] = true; result.push(s); nxt = trapResult.next(); } /*for (var i = 0; i < numProps; i++) { var s = String(trapResult[i]); if (propNames[s]) { throw new TypeError("enumerate trap cannot list a "+ "duplicate property '"+s+"'"); }
propNames[s] = true; result[i] = s; } */
var ownEnumerableProps = Object.keys(this.target); var target = this.target; ownEnumerableProps.forEach(function (ownEnumerableProp) { if (!propNames[ownEnumerableProp]) { if (isSealed(ownEnumerableProp, target)) { throw new TypeError("enumerate trap failed to include "+ "non-configurable enumerable property '"+ ownEnumerableProp+"'"); } if (!Object.isExtensible(target) && isFixed(ownEnumerableProp, target)) { // if handler is allowed not to report ownEnumerableProp as an own
// property, we cannot guarantee that it will never report it as
// an own property later. Once a property has been reported as
// non-existent on a non-extensible object, it should forever be
// reported as non-existent
throw new TypeError("cannot report existing own property '"+ ownEnumerableProp+"' as non-existent on a "+ "non-extensible object"); } } });
return result; },
/** * The iterate trap is deprecated by the enumerate trap. */ iterate: Validator.prototype.enumerate,
/** * Any own non-configurable properties of the target that are not included * in the trap result give rise to a TypeError. As such, we check whether the * returned result contains at least all sealed properties of the target * object. * * The trap result is normalized. * The trap result is not returned directly. Instead: * - create and return a fresh Array, * - of which each element is coerced to String, * - which does not contain duplicates * * FIXME: keys trap is deprecated */ /* keys: function() { var trap = this.getTrap("keys"); if (trap === undefined) { // default forwarding behavior
return Reflect.keys(this.target); }
var trapResult = trap.call(this.handler, this.target);
// propNames is used as a set of strings
var propNames = Object.create(null); var numProps = +trapResult.length; var result = new Array(numProps);
for (var i = 0; i < numProps; i++) { var s = String(trapResult[i]); if (propNames[s]) { throw new TypeError("keys trap cannot list a "+ "duplicate property '"+s+"'"); } if (!Object.isExtensible(this.target) && !isFixed(s, this.target)) { // non-extensible proxies don't tolerate new own property names
throw new TypeError("keys trap cannot list a new "+ "property '"+s+"' on a non-extensible object"); }
propNames[s] = true; result[i] = s; }
var ownEnumerableProps = Object.keys(this.target); var target = this.target; ownEnumerableProps.forEach(function (ownEnumerableProp) { if (!propNames[ownEnumerableProp]) { if (isSealed(ownEnumerableProp, target)) { throw new TypeError("keys trap failed to include "+ "non-configurable enumerable property '"+ ownEnumerableProp+"'"); } if (!Object.isExtensible(target) && isFixed(ownEnumerableProp, target)) { // if handler is allowed not to report ownEnumerableProp as an own
// property, we cannot guarantee that it will never report it as
// an own property later. Once a property has been reported as
// non-existent on a non-extensible object, it should forever be
// reported as non-existent
throw new TypeError("cannot report existing own property '"+ ownEnumerableProp+"' as non-existent on a "+ "non-extensible object"); } } });
return result; }, */ /** * New trap that reifies [[Call]]. * If the target is a function, then a call to * proxy(...args) * Triggers this trap */ apply: function(target, thisBinding, args) { var trap = this.getTrap("apply"); if (trap === undefined) { return Reflect.apply(target, thisBinding, args); }
if (typeof this.target === "function") { return trap.call(this.handler, target, thisBinding, args); } else { throw new TypeError("apply: "+ target + " is not a function"); } },
/** * New trap that reifies [[Construct]]. * If the target is a function, then a call to * new proxy(...args) * Triggers this trap */ construct: function(target, args, newTarget) { var trap = this.getTrap("construct"); if (trap === undefined) { return Reflect.construct(target, args, newTarget); }
if (typeof target !== "function") { throw new TypeError("new: "+ target + " is not a function"); }
if (newTarget === undefined) { newTarget = target; } else { if (typeof newTarget !== "function") { throw new TypeError("new: "+ newTarget + " is not a function"); } } return trap.call(this.handler, target, args, newTarget); } };
// ---- end of the Validator handler wrapper handler ----
// In what follows, a 'direct proxy' is a proxy
// whose handler is a Validator. Such proxies can be made non-extensible,
// sealed or frozen without losing the ability to trap.
// maps direct proxies to their Validator handlers
var directProxies = new WeakMap();
// patch Object.{preventExtensions,seal,freeze} so that
// they recognize fixable proxies and act accordingly
Object.preventExtensions = function(subject) { var vhandler = directProxies.get(subject); if (vhandler !== undefined) { if (vhandler.preventExtensions()) { return subject; } else { throw new TypeError("preventExtensions on "+subject+" rejected"); } } else { return prim_preventExtensions(subject); } }; Object.seal = function(subject) { setIntegrityLevel(subject, "sealed"); return subject; }; Object.freeze = function(subject) { setIntegrityLevel(subject, "frozen"); return subject; }; Object.isExtensible = Object_isExtensible = function(subject) { var vHandler = directProxies.get(subject); if (vHandler !== undefined) { return vHandler.isExtensible(); } else { return prim_isExtensible(subject); } }; Object.isSealed = Object_isSealed = function(subject) { return testIntegrityLevel(subject, "sealed"); }; Object.isFrozen = Object_isFrozen = function(subject) { return testIntegrityLevel(subject, "frozen"); }; Object.getPrototypeOf = Object_getPrototypeOf = function(subject) { var vHandler = directProxies.get(subject); if (vHandler !== undefined) { return vHandler.getPrototypeOf(); } else { return prim_getPrototypeOf(subject); } };
// patch Object.getOwnPropertyDescriptor to directly call
// the Validator.prototype.getOwnPropertyDescriptor trap
// This is to circumvent an assertion in the built-in Proxy
// trapping mechanism of v8, which disallows that trap to
// return non-configurable property descriptors (as per the
// old Proxy design)
Object.getOwnPropertyDescriptor = function(subject, name) { var vhandler = directProxies.get(subject); if (vhandler !== undefined) { return vhandler.getOwnPropertyDescriptor(name); } else { return prim_getOwnPropertyDescriptor(subject, name); } };
// patch Object.defineProperty to directly call
// the Validator.prototype.defineProperty trap
// This is to circumvent two issues with the built-in
// trap mechanism:
// 1) the current tracemonkey implementation of proxies
// auto-completes 'desc', which is not correct. 'desc' should be
// normalized, but not completed. Consider:
// Object.defineProperty(proxy, 'foo', {enumerable:false})
// This trap will receive desc =
// {value:undefined,writable:false,enumerable:false,configurable:false}
// This will also set all other attributes to their default value,
// which is unexpected and different from [[DefineOwnProperty]].
// Bug filed: https://bugzilla.mozilla.org/show_bug.cgi?id=601329
// 2) the current spidermonkey implementation does not
// throw an exception when this trap returns 'false', but instead silently
// ignores the operation (this is regardless of strict-mode)
// 2a) v8 does throw an exception for this case, but includes the rather
// unhelpful error message:
// 'Proxy handler #<Object> returned false from 'defineProperty' trap'
Object.defineProperty = function(subject, name, desc) { var vhandler = directProxies.get(subject); if (vhandler !== undefined) { var normalizedDesc = normalizePropertyDescriptor(desc); var success = vhandler.defineProperty(name, normalizedDesc); if (success === false) { throw new TypeError("can't redefine property '"+name+"'"); } return subject; } else { return prim_defineProperty(subject, name, desc); } };
Object.defineProperties = function(subject, descs) { var vhandler = directProxies.get(subject); if (vhandler !== undefined) { var names = Object.keys(descs); for (var i = 0; i < names.length; i++) { var name = names[i]; var normalizedDesc = normalizePropertyDescriptor(descs[name]); var success = vhandler.defineProperty(name, normalizedDesc); if (success === false) { throw new TypeError("can't redefine property '"+name+"'"); } } return subject; } else { return prim_defineProperties(subject, descs); } };
Object.keys = function(subject) { var vHandler = directProxies.get(subject); if (vHandler !== undefined) { var ownKeys = vHandler.ownKeys(); var result = []; for (var i = 0; i < ownKeys.length; i++) { var k = String(ownKeys[i]); var desc = Object.getOwnPropertyDescriptor(subject, k); if (desc !== undefined && desc.enumerable === true) { result.push(k); } } return result; } else { return prim_keys(subject); } }
Object.getOwnPropertyNames = Object_getOwnPropertyNames = function(subject) { var vHandler = directProxies.get(subject); if (vHandler !== undefined) { return vHandler.ownKeys(); } else { return prim_getOwnPropertyNames(subject); } }
// fixes issue #71 (Calling Object.getOwnPropertySymbols() on a Proxy
// throws an error)
if (prim_getOwnPropertySymbols !== undefined) { Object.getOwnPropertySymbols = function(subject) { var vHandler = directProxies.get(subject); if (vHandler !== undefined) { // as this shim does not support symbols, a Proxy never advertises
// any symbol-valued own properties
return []; } else { return prim_getOwnPropertySymbols(subject); } }; }
// fixes issue #72 ('Illegal access' error when using Object.assign)
// Object.assign polyfill based on a polyfill posted on MDN:
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/\
// Global_Objects/Object/assign
// Note that this polyfill does not support Symbols, but this Proxy Shim
// does not support Symbols anyway.
if (prim_assign !== undefined) { Object.assign = function (target) { // check if any argument is a proxy object
var noProxies = true; for (var i = 0; i < arguments.length; i++) { var vHandler = directProxies.get(arguments[i]); if (vHandler !== undefined) { noProxies = false; break; } } if (noProxies) { // not a single argument is a proxy, perform built-in algorithm
return prim_assign.apply(Object, arguments); } // there is at least one proxy argument, use the polyfill
if (target === undefined || target === null) { throw new TypeError('Cannot convert undefined or null to object'); }
var output = Object(target); for (var index = 1; index < arguments.length; index++) { var source = arguments[index]; if (source !== undefined && source !== null) { for (var nextKey in source) { if (source.hasOwnProperty(nextKey)) { output[nextKey] = source[nextKey]; } } } } return output; }; }
// returns whether an argument is a reference to an object,
// which is legal as a WeakMap key.
function isObject(arg) { var type = typeof arg; return (type === 'object' && arg !== null) || (type === 'function'); };
// a wrapper for WeakMap.get which returns the undefined value
// for keys that are not objects (in which case the underlying
// WeakMap would have thrown a TypeError).
function safeWeakMapGet(map, key) { return isObject(key) ? map.get(key) : undefined; };
// returns a new function of zero arguments that recursively
// unwraps any proxies specified as the |this|-value.
// The primitive is assumed to be a zero-argument method
// that uses its |this|-binding.
function makeUnwrapping0ArgMethod(primitive) { return function builtin() { var vHandler = safeWeakMapGet(directProxies, this); if (vHandler !== undefined) { return builtin.call(vHandler.target); } else { return primitive.call(this); } } };
// returns a new function of 1 arguments that recursively
// unwraps any proxies specified as the |this|-value.
// The primitive is assumed to be a 1-argument method
// that uses its |this|-binding.
function makeUnwrapping1ArgMethod(primitive) { return function builtin(arg) { var vHandler = safeWeakMapGet(directProxies, this); if (vHandler !== undefined) { return builtin.call(vHandler.target, arg); } else { return primitive.call(this, arg); } } };
Object.prototype.valueOf = makeUnwrapping0ArgMethod(Object.prototype.valueOf); Object.prototype.toString = makeUnwrapping0ArgMethod(Object.prototype.toString); Function.prototype.toString = makeUnwrapping0ArgMethod(Function.prototype.toString); Date.prototype.toString = makeUnwrapping0ArgMethod(Date.prototype.toString);
Object.prototype.isPrototypeOf = function builtin(arg) { // bugfix thanks to Bill Mark:
// built-in isPrototypeOf does not unwrap proxies used
// as arguments. So, we implement the builtin ourselves,
// based on the ECMAScript 6 spec. Our encoding will
// make sure that if a proxy is used as an argument,
// its getPrototypeOf trap will be called.
while (true) { var vHandler2 = safeWeakMapGet(directProxies, arg); if (vHandler2 !== undefined) { arg = vHandler2.getPrototypeOf(); if (arg === null) { return false; } else if (sameValue(arg, this)) { return true; } } else { return prim_isPrototypeOf.call(this, arg); } } };
Array.isArray = function(subject) { var vHandler = safeWeakMapGet(directProxies, subject); if (vHandler !== undefined) { return Array.isArray(vHandler.target); } else { return prim_isArray(subject); } };
function isProxyArray(arg) { var vHandler = safeWeakMapGet(directProxies, arg); if (vHandler !== undefined) { return Array.isArray(vHandler.target); } return false; }
// Array.prototype.concat internally tests whether one of its
// arguments is an Array, by checking whether [[Class]] == "Array"
// As such, it will fail to recognize proxies-for-arrays as arrays.
// We patch Array.prototype.concat so that it "unwraps" proxies-for-arrays
// by making a copy. This will trigger the exact same sequence of
// traps on the proxy-for-array as if we would not have unwrapped it.
// See <https://github.com/tvcutsem/harmony-reflect/issues/19> for more.
Array.prototype.concat = function(/*...args*/) { var length; for (var i = 0; i < arguments.length; i++) { if (isProxyArray(arguments[i])) { length = arguments[i].length; arguments[i] = Array.prototype.slice.call(arguments[i], 0, length); } } return prim_concat.apply(this, arguments); };
// setPrototypeOf support on platforms that support __proto__
var prim_setPrototypeOf = Object.setPrototypeOf;
// patch and extract original __proto__ setter
var __proto__setter = (function() { var protoDesc = prim_getOwnPropertyDescriptor(Object.prototype,'__proto__'); if (protoDesc === undefined || typeof protoDesc.set !== "function") { return function() { throw new TypeError("setPrototypeOf not supported on this platform"); } }
// see if we can actually mutate a prototype with the generic setter
// (e.g. Chrome v28 doesn't allow setting __proto__ via the generic setter)
try { protoDesc.set.call({},{}); } catch (e) { return function() { throw new TypeError("setPrototypeOf not supported on this platform"); } }
prim_defineProperty(Object.prototype, '__proto__', { set: function(newProto) { return Object.setPrototypeOf(this, Object(newProto)); } });
return protoDesc.set; }());
Object.setPrototypeOf = function(target, newProto) { var handler = directProxies.get(target); if (handler !== undefined) { if (handler.setPrototypeOf(newProto)) { return target; } else { throw new TypeError("proxy rejected prototype mutation"); } } else { if (!Object_isExtensible(target)) { throw new TypeError("can't set prototype on non-extensible object: " + target); } if (prim_setPrototypeOf) return prim_setPrototypeOf(target, newProto);
if (Object(newProto) !== newProto || newProto === null) { throw new TypeError("Object prototype may only be an Object or null: " + newProto); // throw new TypeError("prototype must be an object or null")
} __proto__setter.call(target, newProto); return target; } }
Object.prototype.hasOwnProperty = function(name) { var handler = safeWeakMapGet(directProxies, this); if (handler !== undefined) { var desc = handler.getOwnPropertyDescriptor(name); return desc !== undefined; } else { return prim_hasOwnProperty.call(this, name); } }
// ============= Reflection module =============
// see http://wiki.ecmascript.org/doku.php?id=harmony:reflect_api
var Reflect = { getOwnPropertyDescriptor: function(target, name) { return Object.getOwnPropertyDescriptor(target, name); }, defineProperty: function(target, name, desc) {
// if target is a proxy, invoke its "defineProperty" trap
var handler = directProxies.get(target); if (handler !== undefined) { return handler.defineProperty(target, name, desc); }
// Implementation transliterated from [[DefineOwnProperty]]
// see ES5.1 section 8.12.9
// this is the _exact same algorithm_ as the isCompatibleDescriptor
// algorithm defined above, except that at every place it
// returns true, this algorithm actually does define the property.
var current = Object.getOwnPropertyDescriptor(target, name); var extensible = Object.isExtensible(target); if (current === undefined && extensible === false) { return false; } if (current === undefined && extensible === true) { Object.defineProperty(target, name, desc); // should never fail
return true; } if (isEmptyDescriptor(desc)) { return true; } if (isEquivalentDescriptor(current, desc)) { return true; } if (current.configurable === false) { if (desc.configurable === true) { return false; } if ('enumerable' in desc && desc.enumerable !== current.enumerable) { return false; } } if (isGenericDescriptor(desc)) { // no further validation necessary
} else if (isDataDescriptor(current) !== isDataDescriptor(desc)) { if (current.configurable === false) { return false; } } else if (isDataDescriptor(current) && isDataDescriptor(desc)) { if (current.configurable === false) { if (current.writable === false && desc.writable === true) { return false; } if (current.writable === false) { if ('value' in desc && !sameValue(desc.value, current.value)) { return false; } } } } else if (isAccessorDescriptor(current) && isAccessorDescriptor(desc)) { if (current.configurable === false) { if ('set' in desc && !sameValue(desc.set, current.set)) { return false; } if ('get' in desc && !sameValue(desc.get, current.get)) { return false; } } } Object.defineProperty(target, name, desc); // should never fail
return true; }, deleteProperty: function(target, name) { var handler = directProxies.get(target); if (handler !== undefined) { return handler.delete(name); } var desc = Object.getOwnPropertyDescriptor(target, name); if (desc === undefined) { return true; } if (desc.configurable === true) { delete target[name]; return true; } return false; }, getPrototypeOf: function(target) { return Object.getPrototypeOf(target); }, setPrototypeOf: function(target, newProto) { var handler = directProxies.get(target); if (handler !== undefined) { return handler.setPrototypeOf(newProto); } if (Object(newProto) !== newProto || newProto === null) { throw new TypeError("Object prototype may only be an Object or null: " + newProto); } if (!Object_isExtensible(target)) { return false; } var current = Object.getPrototypeOf(target); if (sameValue(current, newProto)) { return true; } if (prim_setPrototypeOf) { try { prim_setPrototypeOf(target, newProto); return true; } catch (e) { return false; } }
__proto__setter.call(target, newProto); return true; }, preventExtensions: function(target) { var handler = directProxies.get(target); if (handler !== undefined) { return handler.preventExtensions(); } prim_preventExtensions(target); return true; }, isExtensible: function(target) { return Object.isExtensible(target); }, has: function(target, name) { return name in target; }, get: function(target, name, receiver) { receiver = receiver || target;
// if target is a proxy, invoke its "get" trap
var handler = directProxies.get(target); if (handler !== undefined) { return handler.get(receiver, name); }
var desc = Object.getOwnPropertyDescriptor(target, name); if (desc === undefined) { var proto = Object.getPrototypeOf(target); if (proto === null) { return undefined; } return Reflect.get(proto, name, receiver); } if (isDataDescriptor(desc)) { return desc.value; } var getter = desc.get; if (getter === undefined) { return undefined; } return desc.get.call(receiver); }, // Reflect.set implementation based on latest version of [[SetP]] at
// http://wiki.ecmascript.org/doku.php?id=harmony:proto_climbing_refactoring
set: function(target, name, value, receiver) { receiver = receiver || target;
// if target is a proxy, invoke its "set" trap
var handler = directProxies.get(target); if (handler !== undefined) { return handler.set(receiver, name, value); }
// first, check whether target has a non-writable property
// shadowing name on receiver
var ownDesc = Object.getOwnPropertyDescriptor(target, name);
if (ownDesc === undefined) { // name is not defined in target, search target's prototype
var proto = Object.getPrototypeOf(target);
if (proto !== null) { // continue the search in target's prototype
return Reflect.set(proto, name, value, receiver); }
// Rev16 change. Cf. https://bugs.ecmascript.org/show_bug.cgi?id=1549
// target was the last prototype, now we know that 'name' is not shadowed
// by an existing (accessor or data) property, so we can add the property
// to the initial receiver object
// (this branch will intentionally fall through to the code below)
ownDesc = { value: undefined, writable: true, enumerable: true, configurable: true }; }
// we now know that ownDesc !== undefined
if (isAccessorDescriptor(ownDesc)) { var setter = ownDesc.set; if (setter === undefined) return false; setter.call(receiver, value); // assumes Function.prototype.call
return true; } // otherwise, isDataDescriptor(ownDesc) must be true
if (ownDesc.writable === false) return false; // we found an existing writable data property on the prototype chain.
// Now update or add the data property on the receiver, depending on
// whether the receiver already defines the property or not.
var existingDesc = Object.getOwnPropertyDescriptor(receiver, name); if (existingDesc !== undefined) { var updateDesc = { value: value, // FIXME: it should not be necessary to describe the following
// attributes. Added to circumvent a bug in tracemonkey:
// https://bugzilla.mozilla.org/show_bug.cgi?id=601329
writable: existingDesc.writable, enumerable: existingDesc.enumerable, configurable: existingDesc.configurable }; Object.defineProperty(receiver, name, updateDesc); return true; } else { if (!Object.isExtensible(receiver)) return false; var newDesc = { value: value, writable: true, enumerable: true, configurable: true }; Object.defineProperty(receiver, name, newDesc); return true; } }, /*invoke: function(target, name, args, receiver) { receiver = receiver || target;
var handler = directProxies.get(target); if (handler !== undefined) { return handler.invoke(receiver, name, args); }
var fun = Reflect.get(target, name, receiver); return Function.prototype.apply.call(fun, receiver, args); },*/ enumerate: function(target) { var handler = directProxies.get(target); var result; if (handler !== undefined) { // handler.enumerate should return an iterator directly, but the
// iterator gets converted to an array for backward-compat reasons,
// so we must re-iterate over the array
result = handler.enumerate(handler.target); } else { result = []; for (var name in target) { result.push(name); }; } var l = +result.length; var idx = 0; return { next: function() { if (idx === l) return { done: true }; return { done: false, value: result[idx++] }; } }; }, // imperfect ownKeys implementation: in ES6, should also include
// symbol-keyed properties.
ownKeys: function(target) { return Object_getOwnPropertyNames(target); }, apply: function(target, receiver, args) { // target.apply(receiver, args)
return Function.prototype.apply.call(target, receiver, args); }, construct: function(target, args, newTarget) { // return new target(...args);
// if target is a proxy, invoke its "construct" trap
var handler = directProxies.get(target); if (handler !== undefined) { return handler.construct(handler.target, args, newTarget); } if (typeof target !== "function") { throw new TypeError("target is not a function: " + target); } if (newTarget === undefined || newTarget === target) { // If newTarget is undefined, then newTarget is set to `target` and
// `Reflect.construct(target, ...args)` becomes equivalent to
// `new target(...args)`
// if `target` is an ES2015 Class constructor, it must be called using
// the `new` operator. Hence we use the new operator on a bound function
// to trigger the [[Construct]] internal method. This technique will work
// for both plain constructor functions and ES2015 classes
return new (Function.prototype.bind.apply(target, [null].concat(args))); } else { if (typeof newTarget !== "function") { throw new TypeError("newTarget is not a function: " + target); } // if newTarget is a *different* constructor function, we need to
// emulate [[Construct]] by falling back to [[Call]] with a hand-crafted
// new instance inheriting from newTarget.prototype
// Unfortunately this won't work if target is an ES2015 Constructor
// function, whose [[Call]] method throws an error (it must be invoked
// using the `new` operator)
var proto = newTarget.prototype; var instance = (Object(proto) === proto) ? Object.create(proto) : {}; var result = Function.prototype.apply.call(target, instance, args); return Object(result) === result ? result : instance; } } };
// feature-test whether the Reflect global exists
if (global.Reflect !== undefined) { // Reflect exists, add/override the shimmed methods
Object.getOwnPropertyNames(Reflect).forEach(function (key) { global.Reflect[key] = Reflect[key]; }); } else { // Reflect doesn't exist, define it as the shimmed Reflect object
global.Reflect = Reflect; }
// feature-test whether the Proxy global exists, with
// the harmony-era Proxy.create API
if (typeof Proxy !== "undefined" && typeof Proxy.create !== "undefined") {
var primCreate = Proxy.create, primCreateFunction = Proxy.createFunction;
var revokedHandler = primCreate({ get: function() { throw new TypeError("proxy is revoked"); } });
global.Proxy = function(target, handler) { // check that target is an Object
if (Object(target) !== target) { throw new TypeError("Proxy target must be an Object, given "+target); } // check that handler is an Object
if (Object(handler) !== handler) { throw new TypeError("Proxy handler must be an Object, given "+handler); }
var vHandler = new Validator(target, handler); var proxy; if (typeof target === "function") { proxy = primCreateFunction(vHandler, // call trap
function() { var args = Array.prototype.slice.call(arguments); return vHandler.apply(target, this, args); }, // construct trap
function() { var args = Array.prototype.slice.call(arguments); return vHandler.construct(target, args); }); } else { proxy = primCreate(vHandler, Object.getPrototypeOf(target)); } directProxies.set(proxy, vHandler); return proxy; };
global.Proxy.revocable = function(target, handler) { var proxy = new Proxy(target, handler); var revoke = function() { var vHandler = directProxies.get(proxy); if (vHandler !== null) { vHandler.target = null; vHandler.handler = revokedHandler; } return undefined; }; return {proxy: proxy, revoke: revoke}; } // add the old Proxy.create and Proxy.createFunction methods
// so old code that still depends on the harmony-era Proxy object
// is not broken. Also ensures that multiple versions of this
// library should load fine
global.Proxy.create = primCreate; global.Proxy.createFunction = primCreateFunction;
} else { // Proxy global not defined, or old API not available
if (typeof Proxy === "undefined") { // Proxy global not defined, add a Proxy function stub
global.Proxy = function(_target, _handler) { throw new Error("proxies not supported on this platform. On v8/node/iojs, make sure to pass the --harmony_proxies flag"); }; } // Proxy global defined but old API not available
// presumably Proxy global already supports new API, leave untouched
}
// for node.js modules, export every property in the Reflect object
// as part of the module interface
if (typeof exports !== 'undefined') { Object.keys(Reflect).forEach(function (key) { exports[key] = Reflect[key]; }); }
// function-as-module pattern
}(typeof exports !== 'undefined' ? global : this));
|