diff options
author | Matt A. Tobin <mattatobin@localhost.localdomain> | 2018-02-02 04:16:08 -0500 |
---|---|---|
committer | Matt A. Tobin <mattatobin@localhost.localdomain> | 2018-02-02 04:16:08 -0500 |
commit | 5f8de423f190bbb79a62f804151bc24824fa32d8 (patch) | |
tree | 10027f336435511475e392454359edea8e25895d /js/src/builtin/Utilities.js | |
parent | 49ee0794b5d912db1f95dce6eb52d781dc210db5 (diff) | |
download | UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.gz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.lz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.tar.xz UXP-5f8de423f190bbb79a62f804151bc24824fa32d8.zip |
Add m-esr52 at 52.6.0
Diffstat (limited to 'js/src/builtin/Utilities.js')
-rw-r--r-- | js/src/builtin/Utilities.js | 227 |
1 files changed, 227 insertions, 0 deletions
diff --git a/js/src/builtin/Utilities.js b/js/src/builtin/Utilities.js new file mode 100644 index 000000000..bfb1fe7f4 --- /dev/null +++ b/js/src/builtin/Utilities.js @@ -0,0 +1,227 @@ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ + +/*jshint bitwise: true, camelcase: false, curly: false, eqeqeq: true, + es5: true, forin: true, immed: true, indent: 4, latedef: false, + newcap: false, noarg: true, noempty: true, nonew: true, + plusplus: false, quotmark: false, regexp: true, undef: true, + unused: false, strict: false, trailing: true, +*/ + +/*global ToObject: false, ToInteger: false, IsCallable: false, + ThrowRangeError: false, ThrowTypeError: false, + AssertionFailed: false, + MakeConstructible: false, DecompileArg: false, + RuntimeDefaultLocale: false, + NewDenseArray: false, + Dump: false, + callFunction: false, + TO_UINT32: false, + JSMSG_NOT_FUNCTION: false, JSMSG_MISSING_FUN_ARG: false, + JSMSG_EMPTY_ARRAY_REDUCE: false, JSMSG_CANT_CONVERT_TO: false, +*/ + +#include "SelfHostingDefines.h" + +// Assertions and debug printing, defined here instead of in the header above +// to make `assert` invisible to C++. +#ifdef DEBUG +#define assert(b, info) if (!(b)) AssertionFailed(__FILE__ + ":" + __LINE__ + ": " + info) +#define dbg(msg) DumpMessage(callFunction(std_Array_pop, \ + StringSplitString(__FILE__, '/')) \ + + '#' + __LINE__ + ': ' + msg) +#else +#define assert(b, info) // Elided assertion. +#define dbg(msg) // Elided debugging output. +#endif + +// All C++-implemented standard builtins library functions used in self-hosted +// code are installed via the std_functions JSFunctionSpec[] in +// SelfHosting.cpp. +// +// Do not create an alias to a self-hosted builtin, otherwise it will be cloned +// twice. +// +// WeakMap is a bare constructor without properties or methods. +var std_WeakMap = WeakMap; +// StopIteration is a bare constructor without properties or methods. +var std_StopIteration = StopIteration; + + +/********** List specification type **********/ + +/* Spec: ECMAScript Language Specification, 5.1 edition, 8.8 */ +function List() { + this.length = 0; +} +MakeConstructible(List, {__proto__: null}); + + +/********** Record specification type **********/ + + +/* Spec: ECMAScript Internationalization API Specification, draft, 5 */ +function Record() { + return std_Object_create(null); +} +MakeConstructible(Record, {}); + + +/********** Abstract operations defined in ECMAScript Language Specification **********/ + + +/* Spec: ECMAScript Language Specification, 5.1 edition, 8.12.6 and 11.8.7 */ +function HasProperty(o, p) { + return p in o; +} + + +/* Spec: ECMAScript Language Specification, 5.1 edition, 9.2 and 11.4.9 */ +function ToBoolean(v) { + return !!v; +} + + +/* Spec: ECMAScript Language Specification, 5.1 edition, 9.3 and 11.4.6 */ +function ToNumber(v) { + return +v; +} + + +// ES6 7.2.1 (previously, ES5 9.10 under the name "CheckObjectCoercible"). +function RequireObjectCoercible(v) { + if (v === undefined || v === null) + ThrowTypeError(JSMSG_CANT_CONVERT_TO, ToString(v), "object"); +} + +/* Spec: ECMAScript Draft, 6 edition May 22, 2014, 7.1.15 */ +function ToLength(v) { + v = ToInteger(v); + + if (v <= 0) + return 0; + + // Math.pow(2, 53) - 1 = 0x1fffffffffffff + return std_Math_min(v, 0x1fffffffffffff); +} + +/* Spec: ECMAScript Draft, 6th edition Oct 14, 2014, 7.2.4 */ +function SameValueZero(x, y) { + return x === y || (x !== x && y !== y); +} + +// ES 2017 draft (April 6, 2016) 7.3.9 +function GetMethod(V, P) { + // Step 1. + assert(IsPropertyKey(P), "Invalid property key"); + + // Step 2. + var func = V[P]; + + // Step 3. + if (func === undefined || func === null) + return undefined; + + // Step 4. + if (!IsCallable(func)) + ThrowTypeError(JSMSG_NOT_FUNCTION, typeof func); + + // Step 5. + return func; +} + +/* Spec: ECMAScript Draft, 6th edition Dec 24, 2014, 7.2.7 */ +function IsPropertyKey(argument) { + var type = typeof argument; + return type === "string" || type === "symbol"; +} + +/* Spec: ECMAScript Draft, 6th edition Dec 24, 2014, 7.4.1 */ +function GetIterator(obj, method) { + // Steps 1-2. + if (arguments.length === 1) + method = GetMethod(obj, std_iterator); + + // Steps 3-4. + var iterator = callContentFunction(method, obj); + + // Step 5. + if (!IsObject(iterator)) + ThrowTypeError(JSMSG_NOT_ITERATOR, ToString(iterator)); + + // Step 6. + return iterator; +} + +var _builtinCtorsCache = {__proto__: null}; + +function GetBuiltinConstructor(builtinName) { + var ctor = _builtinCtorsCache[builtinName] || + (_builtinCtorsCache[builtinName] = GetBuiltinConstructorImpl(builtinName)); + assert(ctor, `No builtin with name "${builtinName}" found`); + return ctor; +} + +function GetBuiltinPrototype(builtinName) { + return (_builtinCtorsCache[builtinName] || GetBuiltinConstructor(builtinName)).prototype; +} + +// ES 2016 draft Mar 25, 2016 7.3.20. +function SpeciesConstructor(obj, defaultConstructor) { + // Step 1. + assert(IsObject(obj), "not passed an object"); + + // Step 2. + var ctor = obj.constructor; + + // Step 3. + if (ctor === undefined) + return defaultConstructor; + + // Step 4. + if (!IsObject(ctor)) + ThrowTypeError(JSMSG_NOT_NONNULL_OBJECT, "object's 'constructor' property"); + + // Steps 5. + var s = ctor[std_species]; + + // Step 6. + if (s === undefined || s === null) + return defaultConstructor; + + // Step 7. + if (IsConstructor(s)) + return s; + + // Step 8. + ThrowTypeError(JSMSG_NOT_CONSTRUCTOR, "@@species property of object's constructor"); +} + +function GetTypeError(msg) { + try { + FUN_APPLY(ThrowTypeError, undefined, arguments); + } catch (e) { + return e; + } + assert(false, "the catch block should've returned from this function."); +} + +function GetInternalError(msg) { + try { + FUN_APPLY(ThrowInternalError, undefined, arguments); + } catch (e) { + return e; + } + assert(false, "the catch block should've returned from this function."); +} + +// To be used when a function is required but calling it shouldn't do anything. +function NullFunction() {} + +/*************************************** Testing functions ***************************************/ +function outer() { + return function inner() { + return "foo"; + } +} |