/* vim: set sw=4 ts=4 et tw=78: */ /* ***** BEGIN LICENSE BLOCK ***** * Version: MPL 1.1/GPL 2.0/LGPL 2.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 the Narcissus JavaScript engine. * * The Initial Developer of the Original Code is * Brendan Eich . * Portions created by the Initial Developer are Copyright (C) 2004 * the Initial Developer. All Rights Reserved. * * Contributor(s): * Tom Austin * Brendan Eich * Shu-Yu Guo * Dave Herman * Dimitris Vardoulakis * Patrick Walton * * Alternatively, the contents of this file may be used under the terms of * either the GNU General Public License Version 2 or later (the "GPL"), or * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"), * in which case the provisions of the GPL or the LGPL are applicable instead * of those above. If you wish to allow use of your version of this file only * under the terms of either the GPL or the LGPL, and not to allow others to * use your version of this file under the terms of the MPL, indicate your * decision by deleting the provisions above and replace them with the notice * and other provisions required by the GPL or the LGPL. If you do not delete * the provisions above, a recipient may use your version of this file under * the terms of any one of the MPL, the GPL or the LGPL. * * ***** END LICENSE BLOCK ***** */ /* * Narcissus - JS implemented in JS. * * Well-known constants and lookup tables. Many consts are generated from the * tokens table via eval to minimize redundancy, so consumers must be compiled * separately to take advantage of the simple switch-case constant propagation * done by SpiderMonkey. */ define(function(require, exports, module) { var tokens = [ // End of source. "END", // Operators and punctuators. Some pair-wise order matters, e.g. (+, -) // and (UNARY_PLUS, UNARY_MINUS). "\n", ";", ",", "=", "?", ":", "CONDITIONAL", "||", "&&", "|", "^", "&", "==", "!=", "===", "!==", "<", "<=", ">=", ">", "<<", ">>", ">>>", "+", "-", "*", "/", "%", "!", "~", "UNARY_PLUS", "UNARY_MINUS", "++", "--", ".", "[", "]", "{", "}", "(", ")", // Nonterminal tree node type codes. "SCRIPT", "BLOCK", "LABEL", "FOR_IN", "CALL", "NEW_WITH_ARGS", "INDEX", "ARRAY_INIT", "OBJECT_INIT", "PROPERTY_INIT", "GETTER", "SETTER", "GROUP", "LIST", "LET_BLOCK", "ARRAY_COMP", "GENERATOR", "COMP_TAIL", // Contextual keywords. "IMPLEMENTS", "INTERFACE", "LET", "MODULE", "PACKAGE", "PRIVATE", "PROTECTED", "PUBLIC", "STATIC", "USE", "YIELD", // Terminals. "IDENTIFIER", "NUMBER", "STRING", "REGEXP", // Keywords. "break", "case", "catch", "const", "continue", "debugger", "default", "delete", "do", "else", "export", "false", "finally", "for", "function", "if", "import", "in", "instanceof", "new", "null", "return", "switch", "this", "throw", "true", "try", "typeof", "var", "void", "while", "with", ]; var strictKeywords = { __proto__: null, "implements": true, "interface": true, "let": true, //"module": true, "package": true, "private": true, "protected": true, "public": true, "static": true, "use": true, "yield": true }; var statementStartTokens = [ "break", "const", "continue", "debugger", "do", "for", "if", "let", "return", "switch", "throw", "try", "var", "yield", "while", "with", ]; // Whitespace characters (see ECMA-262 7.2) var whitespaceChars = [ // normal whitespace: "\u0009", "\u000B", "\u000C", "\u0020", "\u00A0", "\uFEFF", // high-Unicode whitespace: "\u1680", "\u180E", "\u2000", "\u2001", "\u2002", "\u2003", "\u2004", "\u2005", "\u2006", "\u2007", "\u2008", "\u2009", "\u200A", "\u202F", "\u205F", "\u3000" ]; var whitespace = {}; for (var i = 0; i < whitespaceChars.length; i++) { whitespace[whitespaceChars[i]] = true; } // Operator and punctuator mapping from token to tree node type name. // NB: because the lexer doesn't backtrack, all token prefixes must themselves // be valid tokens (e.g. !== is acceptable because its prefixes are the valid // tokens != and !). var opTypeNames = { '\n': "NEWLINE", ';': "SEMICOLON", ',': "COMMA", '?': "HOOK", ':': "COLON", '||': "OR", '&&': "AND", '|': "BITWISE_OR", '^': "BITWISE_XOR", '&': "BITWISE_AND", '===': "STRICT_EQ", '==': "EQ", '=': "ASSIGN", '!==': "STRICT_NE", '!=': "NE", '<<': "LSH", '<=': "LE", '<': "LT", '>>>': "URSH", '>>': "RSH", '>=': "GE", '>': "GT", '++': "INCREMENT", '--': "DECREMENT", '+': "PLUS", '-': "MINUS", '*': "MUL", '/': "DIV", '%': "MOD", '!': "NOT", '~': "BITWISE_NOT", '.': "DOT", '[': "LEFT_BRACKET", ']': "RIGHT_BRACKET", '{': "LEFT_CURLY", '}': "RIGHT_CURLY", '(': "LEFT_PAREN", ')': "RIGHT_PAREN" }; // Hash of keyword identifier to tokens index. NB: we must null __proto__ to // avoid toString, etc. namespace pollution. var keywords = {__proto__: null}; var mozillaKeywords = {__proto__: null}; // Define const END, etc., based on the token names. Also map name to index. var tokenIds = {}; var hostSupportsEvalConst = (function() { try { return eval("(function(s) { eval(s); return x })('const x = true;')"); } catch (e) { return false; } })(); // Building up a string to be eval'd in different contexts. var consts = hostSupportsEvalConst ? "const " : "var "; for (var i = 0, j = tokens.length; i < j; i++) { if (i > 0) consts += ", "; var t = tokens[i]; var name; if (/^[a-z]/.test(t)) { name = t.toUpperCase(); if (name === "LET" || name === "YIELD") mozillaKeywords[name] = i; if (strictKeywords[name]) strictKeywords[name] = i; keywords[t] = i; } else { name = (/^\W/.test(t) ? opTypeNames[t] : t); } consts += name + " = " + i; tokenIds[name] = i; tokens[t] = i; } consts += ";"; var isStatementStartCode = {__proto__: null}; for (i = 0, j = statementStartTokens.length; i < j; i++) isStatementStartCode[keywords[statementStartTokens[i]]] = true; // Map assignment operators to their indexes in the tokens array. var assignOps = ['|', '^', '&', '<<', '>>', '>>>', '+', '-', '*', '/', '%']; for (i = 0, j = assignOps.length; i < j; i++) { t = assignOps[i]; assignOps[t] = tokens[t]; } function defineGetter(obj, prop, fn, dontDelete, dontEnum) { Object.defineProperty(obj, prop, { get: fn, configurable: !dontDelete, enumerable: !dontEnum }); } function defineGetterSetter(obj, prop, getter, setter, dontDelete, dontEnum) { Object.defineProperty(obj, prop, { get: getter, set: setter, configurable: !dontDelete, enumerable: !dontEnum }); } function defineMemoGetter(obj, prop, fn, dontDelete, dontEnum) { Object.defineProperty(obj, prop, { get: function() { var val = fn(); defineProperty(obj, prop, val, dontDelete, true, dontEnum); return val; }, configurable: true, enumerable: !dontEnum }); } function defineProperty(obj, prop, val, dontDelete, readOnly, dontEnum) { Object.defineProperty(obj, prop, { value: val, writable: !readOnly, configurable: !dontDelete, enumerable: !dontEnum }); } // Returns true if fn is a native function. (Note: SpiderMonkey specific.) function isNativeCode(fn) { // Relies on the toString method to identify native code. return ((typeof fn) === "function") && fn.toString().match(/\[native code\]/); } var Fpapply = Function.prototype.apply; function apply(f, o, a) { return Fpapply.call(f, [o].concat(a)); } var applyNew; // ES5's bind is a simpler way to implement applyNew if (Function.prototype.bind) { applyNew = function applyNew(f, a) { return new (f.bind.apply(f, [,].concat(Array.prototype.slice.call(a))))(); }; } else { applyNew = function applyNew(f, a) { switch (a.length) { case 0: return new f(); case 1: return new f(a[0]); case 2: return new f(a[0], a[1]); case 3: return new f(a[0], a[1], a[2]); default: var argStr = "a[0]"; for (var i = 1, n = a.length; i < n; i++) argStr += ",a[" + i + "]"; return eval("new f(" + argStr + ")"); } }; } function getPropertyDescriptor(obj, name) { while (obj) { if (({}).hasOwnProperty.call(obj, name)) return Object.getOwnPropertyDescriptor(obj, name); obj = Object.getPrototypeOf(obj); } } function getPropertyNames(obj) { var table = Object.create(null, {}); while (obj) { var names = Object.getOwnPropertyNames(obj); for (var i = 0, n = names.length; i < n; i++) table[names[i]] = true; obj = Object.getPrototypeOf(obj); } return Object.keys(table); } function getOwnProperties(obj) { var map = {}; for (var name in Object.getOwnPropertyNames(obj)) map[name] = Object.getOwnPropertyDescriptor(obj, name); return map; } function blacklistHandler(target, blacklist) { var mask = Object.create(null, {}); var redirect = Dict.create(blacklist).mapObject(function(name) { return mask; }); return mixinHandler(redirect, target); } function whitelistHandler(target, whitelist) { var catchall = Object.create(null, {}); var redirect = Dict.create(whitelist).mapObject(function(name) { return target; }); return mixinHandler(redirect, catchall); } /* * Mixin proxies break the single-inheritance model of prototypes, so * the handler treats all properties as own-properties: * * X * | * +------------+------------+ * | O | * | | | * | O O O | * | | | | | * | O O O O | * | | | | | | * | O O O O O | * | | | | | | | * +-(*)--(w)--(x)--(y)--(z)-+ */ function mixinHandler(redirect, catchall) { function targetFor(name) { return hasOwn(redirect, name) ? redirect[name] : catchall; } function getMuxPropertyDescriptor(name) { var desc = getPropertyDescriptor(targetFor(name), name); if (desc) desc.configurable = true; return desc; } function getMuxPropertyNames() { var names1 = Object.getOwnPropertyNames(redirect).filter(function(name) { return name in redirect[name]; }); var names2 = getPropertyNames(catchall).filter(function(name) { return !hasOwn(redirect, name); }); return names1.concat(names2); } function enumerateMux() { var result = Object.getOwnPropertyNames(redirect).filter(function(name) { return name in redirect[name]; }); for (name in catchall) { if (!hasOwn(redirect, name)) result.push(name); }; return result; } function hasMux(name) { return name in targetFor(name); } return { getOwnPropertyDescriptor: getMuxPropertyDescriptor, getPropertyDescriptor: getMuxPropertyDescriptor, getOwnPropertyNames: getMuxPropertyNames, defineProperty: function(name, desc) { Object.defineProperty(targetFor(name), name, desc); }, "delete": function(name) { var target = targetFor(name); return delete target[name]; }, // FIXME: ha ha ha fix: function() { }, has: hasMux, hasOwn: hasMux, get: function(receiver, name) { var target = targetFor(name); return target[name]; }, set: function(receiver, name, val) { var target = targetFor(name); target[name] = val; return true; }, enumerate: enumerateMux, keys: enumerateMux }; } function makePassthruHandler(obj) { // Handler copied from // http://wiki.ecmascript.org/doku.php?id=harmony:proxies&s=proxy%20object#examplea_no-op_forwarding_proxy return { getOwnPropertyDescriptor: function(name) { var desc = Object.getOwnPropertyDescriptor(obj, name); // a trapping proxy's properties must always be configurable desc.configurable = true; return desc; }, getPropertyDescriptor: function(name) { var desc = getPropertyDescriptor(obj, name); // a trapping proxy's properties must always be configurable desc.configurable = true; return desc; }, getOwnPropertyNames: function() { return Object.getOwnPropertyNames(obj); }, defineProperty: function(name, desc) { Object.defineProperty(obj, name, desc); }, "delete": function(name) { return delete obj[name]; }, fix: function() { if (Object.isFrozen(obj)) { return getOwnProperties(obj); } // As long as obj is not frozen, the proxy won't allow itself to be fixed. return undefined; // will cause a TypeError to be thrown }, has: function(name) { return name in obj; }, hasOwn: function(name) { return ({}).hasOwnProperty.call(obj, name); }, get: function(receiver, name) { return obj[name]; }, // bad behavior when set fails in non-strict mode set: function(receiver, name, val) { obj[name] = val; return true; }, enumerate: function() { var result = []; for (name in obj) { result.push(name); }; return result; }, keys: function() { return Object.keys(obj); } }; } var hasOwnProperty = ({}).hasOwnProperty; function hasOwn(obj, name) { return hasOwnProperty.call(obj, name); } function Dict(table, size) { this.table = table || Object.create(null, {}); this.size = size || 0; } Dict.create = function(table) { var init = Object.create(null, {}); var size = 0; var names = Object.getOwnPropertyNames(table); for (var i = 0, n = names.length; i < n; i++) { var name = names[i]; init[name] = table[name]; size++; } return new Dict(init, size); }; Dict.prototype = { has: function(x) { return hasOwnProperty.call(this.table, x); }, set: function(x, v) { if (!hasOwnProperty.call(this.table, x)) this.size++; this.table[x] = v; }, get: function(x) { return this.table[x]; }, getDef: function(x, thunk) { if (!hasOwnProperty.call(this.table, x)) { this.size++; this.table[x] = thunk(); } return this.table[x]; }, forEach: function(f) { var table = this.table; for (var key in table) f.call(this, key, table[key]); }, map: function(f) { var table1 = this.table; var table2 = Object.create(null, {}); this.forEach(function(key, val) { table2[key] = f.call(this, val, key); }); return new Dict(table2, this.size); }, mapObject: function(f) { var table1 = this.table; var table2 = Object.create(null, {}); this.forEach(function(key, val) { table2[key] = f.call(this, val, key); }); return table2; }, toObject: function() { return this.mapObject(function(val) { return val; }); }, choose: function() { return Object.getOwnPropertyNames(this.table)[0]; }, remove: function(x) { if (hasOwnProperty.call(this.table, x)) { this.size--; delete this.table[x]; } }, copy: function() { var table = Object.create(null, {}); for (var key in this.table) table[key] = this.table[key]; return new Dict(table, this.size); }, keys: function() { return Object.keys(this.table); }, toString: function() { return "[object Dict]" } }; var _WeakMap = typeof WeakMap === "function" ? WeakMap : (function() { // shim for ES6 WeakMap with poor asymptotics function WeakMap(array) { this.array = array || []; } function searchMap(map, key, found, notFound) { var a = map.array; for (var i = 0, n = a.length; i < n; i++) { var pair = a[i]; if (pair.key === key) return found(pair, i); } return notFound(); } WeakMap.prototype = { has: function(x) { return searchMap(this, x, function() { return true }, function() { return false }); }, set: function(x, v) { var a = this.array; searchMap(this, x, function(pair) { pair.value = v }, function() { a.push({ key: x, value: v }) }); }, get: function(x) { return searchMap(this, x, function(pair) { return pair.value }, function() { return null }); }, "delete": function(x) { var a = this.array; searchMap(this, x, function(pair, i) { a.splice(i, 1) }, function() { }); }, toString: function() { return "[object WeakMap]" } }; return WeakMap; })(); // non-destructive stack function Stack(elts) { this.elts = elts || null; } Stack.prototype = { push: function(x) { return new Stack({ top: x, rest: this.elts }); }, top: function() { if (!this.elts) throw new Error("empty stack"); return this.elts.top; }, isEmpty: function() { return this.top === null; }, find: function(test) { for (var elts = this.elts; elts; elts = elts.rest) { if (test(elts.top)) return elts.top; } return null; }, has: function(x) { return Boolean(this.find(function(elt) { return elt === x })); }, forEach: function(f) { for (var elts = this.elts; elts; elts = elts.rest) { f(elts.top); } } }; if (!Array.prototype.copy) { defineProperty(Array.prototype, "copy", function() { var result = []; for (var i = 0, n = this.length; i < n; i++) result[i] = this[i]; return result; }, false, false, true); } if (!Array.prototype.top) { defineProperty(Array.prototype, "top", function() { return this.length && this[this.length-1]; }, false, false, true); } exports.tokens = tokens; exports.whitespace = whitespace; exports.opTypeNames = opTypeNames; exports.keywords = keywords; exports.mozillaKeywords = mozillaKeywords; exports.strictKeywords = strictKeywords; exports.isStatementStartCode = isStatementStartCode; exports.tokenIds = tokenIds; exports.consts = consts; exports.assignOps = assignOps; exports.defineGetter = defineGetter; exports.defineGetterSetter = defineGetterSetter; exports.defineMemoGetter = defineMemoGetter; exports.defineProperty = defineProperty; exports.isNativeCode = isNativeCode; exports.apply = apply; exports.applyNew = applyNew; exports.mixinHandler = mixinHandler; exports.whitelistHandler = whitelistHandler; exports.blacklistHandler = blacklistHandler; exports.makePassthruHandler = makePassthruHandler; exports.Dict = Dict; exports.WeakMap = _WeakMap; exports.Stack = Stack; });