1 # Copyright 2006-2009 the V8 project authors. All rights reserved. 2 # Redistribution and use in source and binary forms, with or without 3 # modification, are permitted provided that the following conditions are 4 # met: 5 # 6 # * Redistributions of source code must retain the above copyright 7 # notice, this list of conditions and the following disclaimer. 8 # * Redistributions in binary form must reproduce the above 9 # copyright notice, this list of conditions and the following 10 # disclaimer in the documentation and/or other materials provided 11 # with the distribution. 12 # * Neither the name of Google Inc. nor the names of its 13 # contributors may be used to endorse or promote products derived 14 # from this software without specific prior written permission. 15 # 16 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 28 # Dictionary that is passed as defines for js2c.py. 29 # Used for defines that must be defined for all native JS files. 30 31 const NONE = 0; 32 const READ_ONLY = 1; 33 const DONT_ENUM = 2; 34 const DONT_DELETE = 4; 35 const NEW_ONE_BYTE_STRING = true; 36 const NEW_TWO_BYTE_STRING = false; 37 38 # Constants used for getter and setter operations. 39 const GETTER = 0; 40 const SETTER = 1; 41 42 # These definitions must match the index of the properties in objects.h. 43 const kApiTagOffset = 0; 44 const kApiPropertyListOffset = 1; 45 const kApiSerialNumberOffset = 3; 46 const kApiConstructorOffset = 3; 47 const kApiPrototypeTemplateOffset = 5; 48 const kApiParentTemplateOffset = 6; 49 const kApiFlagOffset = 14; 50 51 const NO_HINT = 0; 52 const NUMBER_HINT = 1; 53 const STRING_HINT = 2; 54 55 const kFunctionTag = 0; 56 const kNewObjectTag = 1; 57 58 # For date.js. 59 const HoursPerDay = 24; 60 const MinutesPerHour = 60; 61 const SecondsPerMinute = 60; 62 const msPerSecond = 1000; 63 const msPerMinute = 60000; 64 const msPerHour = 3600000; 65 const msPerDay = 86400000; 66 const msPerMonth = 2592000000; 67 68 # For apinatives.js 69 const kUninitialized = -1; 70 const kReadOnlyPrototypeBit = 3; 71 const kRemovePrototypeBit = 4; # For FunctionTemplateInfo, matches objects.h 72 const kDoNotCacheBit = 5; # For FunctionTemplateInfo, matches objects.h 73 74 # Note: kDayZeroInJulianDay = ToJulianDay(1970, 0, 1). 75 const kInvalidDate = 'Invalid Date'; 76 const kDayZeroInJulianDay = 2440588; 77 const kMonthMask = 0x1e0; 78 const kDayMask = 0x01f; 79 const kYearShift = 9; 80 const kMonthShift = 5; 81 82 # Limits for parts of the date, so that we support all the dates that 83 # ECMA 262 - 15.9.1.1 requires us to, but at the same time be sure that 84 # the date (days since 1970) is in SMI range. 85 const kMinYear = -1000000; 86 const kMaxYear = 1000000; 87 const kMinMonth = -10000000; 88 const kMaxMonth = 10000000; 89 90 # Strict mode flags for passing to %SetProperty 91 const kSloppyMode = 0; 92 const kStrictMode = 1; 93 94 # Native cache ids. 95 const STRING_TO_REGEXP_CACHE_ID = 0; 96 97 # Type query macros. 98 # 99 # Note: We have special support for typeof(foo) === 'bar' in the compiler. 100 # It will *not* generate a runtime typeof call for the most important 101 # values of 'bar'. 102 macro IS_NULL(arg) = (arg === null); 103 macro IS_NULL_OR_UNDEFINED(arg) = (arg == null); 104 macro IS_UNDEFINED(arg) = (arg === (void 0)); 105 macro IS_NUMBER(arg) = (typeof(arg) === 'number'); 106 macro IS_STRING(arg) = (typeof(arg) === 'string'); 107 macro IS_BOOLEAN(arg) = (typeof(arg) === 'boolean'); 108 macro IS_SYMBOL(arg) = (typeof(arg) === 'symbol'); 109 macro IS_OBJECT(arg) = (%_IsObject(arg)); 110 macro IS_ARRAY(arg) = (%_IsArray(arg)); 111 macro IS_FUNCTION(arg) = (%_IsFunction(arg)); 112 macro IS_REGEXP(arg) = (%_IsRegExp(arg)); 113 macro IS_SET(arg) = (%_ClassOf(arg) === 'Set'); 114 macro IS_MAP(arg) = (%_ClassOf(arg) === 'Map'); 115 macro IS_WEAKMAP(arg) = (%_ClassOf(arg) === 'WeakMap'); 116 macro IS_WEAKSET(arg) = (%_ClassOf(arg) === 'WeakSet'); 117 macro IS_DATE(arg) = (%_ClassOf(arg) === 'Date'); 118 macro IS_NUMBER_WRAPPER(arg) = (%_ClassOf(arg) === 'Number'); 119 macro IS_STRING_WRAPPER(arg) = (%_ClassOf(arg) === 'String'); 120 macro IS_SYMBOL_WRAPPER(arg) = (%_ClassOf(arg) === 'Symbol'); 121 macro IS_BOOLEAN_WRAPPER(arg) = (%_ClassOf(arg) === 'Boolean'); 122 macro IS_ERROR(arg) = (%_ClassOf(arg) === 'Error'); 123 macro IS_SCRIPT(arg) = (%_ClassOf(arg) === 'Script'); 124 macro IS_ARGUMENTS(arg) = (%_ClassOf(arg) === 'Arguments'); 125 macro IS_GLOBAL(arg) = (%_ClassOf(arg) === 'global'); 126 macro IS_ARRAYBUFFER(arg) = (%_ClassOf(arg) === 'ArrayBuffer'); 127 macro IS_DATAVIEW(arg) = (%_ClassOf(arg) === 'DataView'); 128 macro IS_GENERATOR(arg) = (%_ClassOf(arg) === 'Generator'); 129 macro IS_SET_ITERATOR(arg) = (%_ClassOf(arg) === 'Set Iterator'); 130 macro IS_MAP_ITERATOR(arg) = (%_ClassOf(arg) === 'Map Iterator'); 131 macro IS_UNDETECTABLE(arg) = (%_IsUndetectableObject(arg)); 132 macro FLOOR(arg) = $floor(arg); 133 134 # Macro for ECMAScript 5 queries of the type: 135 # "Type(O) is object." 136 # This is the same as being either a function or an object in V8 terminology 137 # (including proxies). 138 # In addition, an undetectable object is also included by this. 139 macro IS_SPEC_OBJECT(arg) = (%_IsSpecObject(arg)); 140 141 # Macro for ECMAScript 5 queries of the type: 142 # "IsCallable(O)" 143 # We assume here that this is the same as being either a function or a function 144 # proxy. That ignores host objects with [[Call]] methods, but in most situations 145 # we cannot handle those anyway. 146 macro IS_SPEC_FUNCTION(arg) = (%_ClassOf(arg) === 'Function'); 147 148 # Macro for ES6 CheckObjectCoercible 149 # Will throw a TypeError of the form "[functionName] called on null or undefined". 150 macro CHECK_OBJECT_COERCIBLE(arg, functionName) = if (IS_NULL_OR_UNDEFINED(arg) && !IS_UNDETECTABLE(arg)) throw MakeTypeError('called_on_null_or_undefined', [functionName]); 151 152 # Indices in bound function info retrieved by %BoundFunctionGetBindings(...). 153 const kBoundFunctionIndex = 0; 154 const kBoundThisIndex = 1; 155 const kBoundArgumentsStartIndex = 2; 156 157 # Inline macros. Use %IS_VAR to make sure arg is evaluated only once. 158 macro NUMBER_IS_NAN(arg) = (!%_IsSmi(%IS_VAR(arg)) && !(arg == arg)); 159 macro NUMBER_IS_FINITE(arg) = (%_IsSmi(%IS_VAR(arg)) || ((arg == arg) && (arg != 1/0) && (arg != -1/0))); 160 macro TO_INTEGER(arg) = (%_IsSmi(%IS_VAR(arg)) ? arg : %NumberToInteger(ToNumber(arg))); 161 macro TO_INTEGER_FOR_SIDE_EFFECT(arg) = (%_IsSmi(%IS_VAR(arg)) ? arg : ToNumber(arg)); 162 macro TO_INTEGER_MAP_MINUS_ZERO(arg) = (%_IsSmi(%IS_VAR(arg)) ? arg : %NumberToIntegerMapMinusZero(ToNumber(arg))); 163 macro TO_INT32(arg) = (%_IsSmi(%IS_VAR(arg)) ? arg : (arg >> 0)); 164 macro TO_UINT32(arg) = (arg >>> 0); 165 macro TO_STRING_INLINE(arg) = (IS_STRING(%IS_VAR(arg)) ? arg : NonStringToString(arg)); 166 macro TO_NUMBER_INLINE(arg) = (IS_NUMBER(%IS_VAR(arg)) ? arg : NonNumberToNumber(arg)); 167 macro TO_OBJECT_INLINE(arg) = (IS_SPEC_OBJECT(%IS_VAR(arg)) ? arg : ToObject(arg)); 168 macro JSON_NUMBER_TO_STRING(arg) = ((%_IsSmi(%IS_VAR(arg)) || arg - arg == 0) ? %_NumberToString(arg) : "null"); 169 170 # Private names. 171 # GET_PRIVATE should only be used if the property is known to exists on obj 172 # itself (it should really use %GetOwnProperty, but that would be way slower). 173 macro GLOBAL_PRIVATE(name) = (%CreateGlobalPrivateSymbol(name)); 174 macro NEW_PRIVATE(name) = (%CreatePrivateSymbol(name)); 175 macro IS_PRIVATE(sym) = (%SymbolIsPrivate(sym)); 176 macro HAS_PRIVATE(obj, sym) = (%HasOwnProperty(obj, sym)); 177 macro GET_PRIVATE(obj, sym) = (obj[sym]); 178 macro SET_PRIVATE(obj, sym, val) = (obj[sym] = val); 179 macro DELETE_PRIVATE(obj, sym) = (delete obj[sym]); 180 181 # Constants. The compiler constant folds them. 182 const NAN = $NaN; 183 const INFINITY = (1/0); 184 const UNDEFINED = (void 0); 185 186 # Macros implemented in Python. 187 python macro CHAR_CODE(str) = ord(str[1]); 188 189 # Constants used on an array to implement the properties of the RegExp object. 190 const REGEXP_NUMBER_OF_CAPTURES = 0; 191 const REGEXP_FIRST_CAPTURE = 3; 192 193 # We can't put macros in macros so we use constants here. 194 # REGEXP_NUMBER_OF_CAPTURES 195 macro NUMBER_OF_CAPTURES(array) = ((array)[0]); 196 197 # Limit according to ECMA 262 15.9.1.1 198 const MAX_TIME_MS = 8640000000000000; 199 # Limit which is MAX_TIME_MS + msPerMonth. 200 const MAX_TIME_BEFORE_UTC = 8640002592000000; 201 202 # Gets the value of a Date object. If arg is not a Date object 203 # a type error is thrown. 204 macro CHECK_DATE(arg) = if (%_ClassOf(arg) !== 'Date') ThrowDateTypeError(); 205 macro LOCAL_DATE_VALUE(arg) = (%_DateField(arg, 0) + %_DateField(arg, 21)); 206 macro UTC_DATE_VALUE(arg) = (%_DateField(arg, 0)); 207 208 macro LOCAL_YEAR(arg) = (%_DateField(arg, 1)); 209 macro LOCAL_MONTH(arg) = (%_DateField(arg, 2)); 210 macro LOCAL_DAY(arg) = (%_DateField(arg, 3)); 211 macro LOCAL_WEEKDAY(arg) = (%_DateField(arg, 4)); 212 macro LOCAL_HOUR(arg) = (%_DateField(arg, 5)); 213 macro LOCAL_MIN(arg) = (%_DateField(arg, 6)); 214 macro LOCAL_SEC(arg) = (%_DateField(arg, 7)); 215 macro LOCAL_MS(arg) = (%_DateField(arg, 8)); 216 macro LOCAL_DAYS(arg) = (%_DateField(arg, 9)); 217 macro LOCAL_TIME_IN_DAY(arg) = (%_DateField(arg, 10)); 218 219 macro UTC_YEAR(arg) = (%_DateField(arg, 11)); 220 macro UTC_MONTH(arg) = (%_DateField(arg, 12)); 221 macro UTC_DAY(arg) = (%_DateField(arg, 13)); 222 macro UTC_WEEKDAY(arg) = (%_DateField(arg, 14)); 223 macro UTC_HOUR(arg) = (%_DateField(arg, 15)); 224 macro UTC_MIN(arg) = (%_DateField(arg, 16)); 225 macro UTC_SEC(arg) = (%_DateField(arg, 17)); 226 macro UTC_MS(arg) = (%_DateField(arg, 18)); 227 macro UTC_DAYS(arg) = (%_DateField(arg, 19)); 228 macro UTC_TIME_IN_DAY(arg) = (%_DateField(arg, 20)); 229 230 macro TIMEZONE_OFFSET(arg) = (%_DateField(arg, 21)); 231 232 macro SET_UTC_DATE_VALUE(arg, value) = (%DateSetValue(arg, value, 1)); 233 macro SET_LOCAL_DATE_VALUE(arg, value) = (%DateSetValue(arg, value, 0)); 234 235 # Last input and last subject of regexp matches. 236 const LAST_SUBJECT_INDEX = 1; 237 macro LAST_SUBJECT(array) = ((array)[1]); 238 macro LAST_INPUT(array) = ((array)[2]); 239 240 # REGEXP_FIRST_CAPTURE 241 macro CAPTURE(index) = (3 + (index)); 242 const CAPTURE0 = 3; 243 const CAPTURE1 = 4; 244 245 # For the regexp capture override array. This has the same 246 # format as the arguments to a function called from 247 # String.prototype.replace. 248 macro OVERRIDE_MATCH(override) = ((override)[0]); 249 macro OVERRIDE_POS(override) = ((override)[(override).length - 2]); 250 macro OVERRIDE_SUBJECT(override) = ((override)[(override).length - 1]); 251 # 1-based so index of 1 returns the first capture 252 macro OVERRIDE_CAPTURE(override, index) = ((override)[(index)]); 253 254 # PropertyDescriptor return value indices - must match 255 # PropertyDescriptorIndices in runtime.cc. 256 const IS_ACCESSOR_INDEX = 0; 257 const VALUE_INDEX = 1; 258 const GETTER_INDEX = 2; 259 const SETTER_INDEX = 3; 260 const WRITABLE_INDEX = 4; 261 const ENUMERABLE_INDEX = 5; 262 const CONFIGURABLE_INDEX = 6; 263 264 # For messages.js 265 # Matches Script::Type from objects.h 266 const TYPE_NATIVE = 0; 267 const TYPE_EXTENSION = 1; 268 const TYPE_NORMAL = 2; 269 270 # Matches Script::CompilationType from objects.h 271 const COMPILATION_TYPE_HOST = 0; 272 const COMPILATION_TYPE_EVAL = 1; 273 const COMPILATION_TYPE_JSON = 2; 274 275 # Matches Messages::kNoLineNumberInfo from v8.h 276 const kNoLineNumberInfo = 0; 277 278 # Matches PropertyAttributes from property-details.h 279 const PROPERTY_ATTRIBUTES_NONE = 0; 280 const PROPERTY_ATTRIBUTES_STRING = 8; 281 const PROPERTY_ATTRIBUTES_SYMBOLIC = 16; 282 const PROPERTY_ATTRIBUTES_PRIVATE_SYMBOL = 32; 283 284 # Use for keys, values and entries iterators. 285 const ITERATOR_KIND_KEYS = 1; 286 const ITERATOR_KIND_VALUES = 2; 287 const ITERATOR_KIND_ENTRIES = 3; 288