src/objects.h

   1 // Copyright 2012 the V8 project authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef V8_OBJECTS_H_
   6 #define V8_OBJECTS_H_
   7
   8 #include <iosfwd>
   9
  10 #include "src/allocation.h"
  11 #include "src/assert-scope.h"
  12 #include "src/bailout-reason.h"
  13 #include "src/base/bits.h"
  14 #include "src/base/smart-pointers.h"
  15 #include "src/builtins.h"
  16 #include "src/checks.h"
  17 #include "src/elements-kind.h"
  18 #include "src/field-index.h"
  19 #include "src/flags.h"
  20 #include "src/list.h"
  21 #include "src/property-details.h"
  22 #include "src/unicode-inl.h"
  23 #include "src/unicode-decoder.h"
  24 #include "src/zone.h"
  25
  26 #if V8_TARGET_ARCH_ARM
  27 #include "src/arm/constants-arm.h"  // NOLINT
  28 #elif V8_TARGET_ARCH_ARM64
  29 #include "src/arm64/constants-arm64.h"  // NOLINT
  30 #elif V8_TARGET_ARCH_MIPS
  31 #include "src/mips/constants-mips.h"  // NOLINT
  32 #elif V8_TARGET_ARCH_MIPS64
  33 #include "src/mips64/constants-mips64.h"  // NOLINT
  34 #elif V8_TARGET_ARCH_PPC
  35 #include "src/ppc/constants-ppc.h"  // NOLINT
  36 #endif
  37
  38
  39 //
  40 // Most object types in the V8 JavaScript are described in this file.
  41 //
  42 // Inheritance hierarchy:
  43 // - Object
  44 //   - Smi          (immediate small integer)
  45 //   - HeapObject   (superclass for everything allocated in the heap)
  46 //     - JSReceiver  (suitable for property access)
  47 //       - JSObject
  48 //         - JSArray
  49 //         - JSArrayBuffer
  50 //         - JSArrayBufferView
  51 //           - JSTypedArray
  52 //           - JSDataView
  53 //         - JSCollection
  54 //           - JSSet
  55 //           - JSMap
  56 //         - JSSetIterator
  57 //         - JSMapIterator
  58 //         - JSWeakCollection
  59 //           - JSWeakMap
  60 //           - JSWeakSet
  61 //         - JSRegExp
  62 //         - JSFunction
  63 //         - JSGeneratorObject
  64 //         - JSModule
  65 //         - GlobalObject
  66 //           - JSGlobalObject
  67 //           - JSBuiltinsObject
  68 //         - JSGlobalProxy
  69 //         - JSValue
  70 //           - JSDate
  71 //         - JSMessageObject
  72 //       - JSProxy
  73 //         - JSFunctionProxy
  74 //     - FixedArrayBase
  75 //       - ByteArray
  76 //       - BytecodeArray
  77 //       - FixedArray
  78 //         - DescriptorArray
  79 //         - HashTable
  80 //           - Dictionary
  81 //           - StringTable
  82 //           - CompilationCacheTable
  83 //           - CodeCacheHashTable
  84 //           - MapCache
  85 //         - OrderedHashTable
  86 //           - OrderedHashSet
  87 //           - OrderedHashMap
  88 //         - Context
  89 //         - TypeFeedbackVector
  90 //         - ScopeInfo
  91 //         - TransitionArray
  92 //         - ScriptContextTable
  93 //         - WeakFixedArray
  94 //       - FixedDoubleArray
  95 //     - Name
  96 //       - String
  97 //         - SeqString
  98 //           - SeqOneByteString
  99 //           - SeqTwoByteString
 100 //         - SlicedString
 101 //         - ConsString
 102 //         - ExternalString
 103 //           - ExternalOneByteString
 104 //           - ExternalTwoByteString
 105 //         - InternalizedString
 106 //           - SeqInternalizedString
 107 //             - SeqOneByteInternalizedString
 108 //             - SeqTwoByteInternalizedString
 109 //           - ConsInternalizedString
 110 //           - ExternalInternalizedString
 111 //             - ExternalOneByteInternalizedString
 112 //             - ExternalTwoByteInternalizedString
 113 //       - Symbol
 114 //     - HeapNumber
 115 //     - Simd128Value
 116 //       - Float32x4
 117 //       - Int32x4
 118 //       - Bool32x4
 119 //       - Int16x8
 120 //       - Bool16x8
 121 //       - Int8x16
 122 //       - Bool8x16
 123 //     - Cell
 124 //     - PropertyCell
 125 //     - Code
 126 //     - Map
 127 //     - Oddball
 128 //     - Foreign
 129 //     - SharedFunctionInfo
 130 //     - Struct
 131 //       - Box
 132 //       - AccessorInfo
 133 //         - ExecutableAccessorInfo
 134 //       - AccessorPair
 135 //       - AccessCheckInfo
 136 //       - InterceptorInfo
 137 //       - CallHandlerInfo
 138 //       - TemplateInfo
 139 //         - FunctionTemplateInfo
 140 //         - ObjectTemplateInfo
 141 //       - Script
 142 //       - TypeSwitchInfo
 143 //       - DebugInfo
 144 //       - BreakPointInfo
 145 //       - CodeCache
 146 //       - PrototypeInfo
 147 //     - WeakCell
 148 //
 149 // Formats of Object*:
 150 //  Smi:        [31 bit signed int] 0
 151 //  HeapObject: [32 bit direct pointer] (4 byte aligned) | 01
 152
 153 namespace v8 {
 154 namespace internal {
 155
 156 enum KeyedAccessStoreMode {
 157   STANDARD_STORE,
 158   STORE_TRANSITION_SMI_TO_OBJECT,
 159   STORE_TRANSITION_SMI_TO_DOUBLE,
 160   STORE_TRANSITION_DOUBLE_TO_OBJECT,
 161   STORE_TRANSITION_HOLEY_SMI_TO_OBJECT,
 162   STORE_TRANSITION_HOLEY_SMI_TO_DOUBLE,
 163   STORE_TRANSITION_HOLEY_DOUBLE_TO_OBJECT,
 164   STORE_AND_GROW_NO_TRANSITION,
 165   STORE_AND_GROW_TRANSITION_SMI_TO_OBJECT,
 166   STORE_AND_GROW_TRANSITION_SMI_TO_DOUBLE,
 167   STORE_AND_GROW_TRANSITION_DOUBLE_TO_OBJECT,
 168   STORE_AND_GROW_TRANSITION_HOLEY_SMI_TO_OBJECT,
 169   STORE_AND_GROW_TRANSITION_HOLEY_SMI_TO_DOUBLE,
 170   STORE_AND_GROW_TRANSITION_HOLEY_DOUBLE_TO_OBJECT,
 171   STORE_NO_TRANSITION_IGNORE_OUT_OF_BOUNDS,
 172   STORE_NO_TRANSITION_HANDLE_COW
 173 };
 174
 175
 176 enum TypeofMode { INSIDE_TYPEOF, NOT_INSIDE_TYPEOF };
 177
 178
 179 enum MutableMode {
 180   MUTABLE,
 181   IMMUTABLE
 182 };
 183
 184
 185 enum ExternalArrayType {
 186   kExternalInt8Array = 1,
 187   kExternalUint8Array,
 188   kExternalInt16Array,
 189   kExternalUint16Array,
 190   kExternalInt32Array,
 191   kExternalUint32Array,
 192   kExternalFloat32Array,
 193   kExternalFloat64Array,
 194   kExternalUint8ClampedArray,
 195 };
 196
 197
 198 static const int kGrowICDelta = STORE_AND_GROW_NO_TRANSITION -
 199     STANDARD_STORE;
 200 STATIC_ASSERT(STANDARD_STORE == 0);
 201 STATIC_ASSERT(kGrowICDelta ==
 202               STORE_AND_GROW_TRANSITION_SMI_TO_OBJECT -
 203               STORE_TRANSITION_SMI_TO_OBJECT);
 204 STATIC_ASSERT(kGrowICDelta ==
 205               STORE_AND_GROW_TRANSITION_SMI_TO_DOUBLE -
 206               STORE_TRANSITION_SMI_TO_DOUBLE);
 207 STATIC_ASSERT(kGrowICDelta ==
 208               STORE_AND_GROW_TRANSITION_DOUBLE_TO_OBJECT -
 209               STORE_TRANSITION_DOUBLE_TO_OBJECT);
 210
 211
 212 static inline KeyedAccessStoreMode GetGrowStoreMode(
 213     KeyedAccessStoreMode store_mode) {
 214   if (store_mode < STORE_AND_GROW_NO_TRANSITION) {
 215     store_mode = static_cast<KeyedAccessStoreMode>(
 216         static_cast<int>(store_mode) + kGrowICDelta);
 217   }
 218   return store_mode;
 219 }
 220
 221
 222 static inline bool IsTransitionStoreMode(KeyedAccessStoreMode store_mode) {
 223   return store_mode > STANDARD_STORE &&
 224       store_mode <= STORE_AND_GROW_TRANSITION_HOLEY_DOUBLE_TO_OBJECT &&
 225       store_mode != STORE_AND_GROW_NO_TRANSITION;
 226 }
 227
 228
 229 static inline KeyedAccessStoreMode GetNonTransitioningStoreMode(
 230     KeyedAccessStoreMode store_mode) {
 231   if (store_mode >= STORE_NO_TRANSITION_IGNORE_OUT_OF_BOUNDS) {
 232     return store_mode;
 233   }
 234   if (store_mode >= STORE_AND_GROW_NO_TRANSITION) {
 235     return STORE_AND_GROW_NO_TRANSITION;
 236   }
 237   return STANDARD_STORE;
 238 }
 239
 240
 241 static inline bool IsGrowStoreMode(KeyedAccessStoreMode store_mode) {
 242   return store_mode >= STORE_AND_GROW_NO_TRANSITION &&
 243       store_mode <= STORE_AND_GROW_TRANSITION_HOLEY_DOUBLE_TO_OBJECT;
 244 }
 245
 246
 247 enum IcCheckType { ELEMENT, PROPERTY };
 248
 249
 250 // SKIP_WRITE_BARRIER skips the write barrier.
 251 // UPDATE_WEAK_WRITE_BARRIER skips the marking part of the write barrier and
 252 // only performs the generational part.
 253 // UPDATE_WRITE_BARRIER is doing the full barrier, marking and generational.
 254 enum WriteBarrierMode {
 255   SKIP_WRITE_BARRIER,
 256   UPDATE_WEAK_WRITE_BARRIER,
 257   UPDATE_WRITE_BARRIER
 258 };
 259
 260
 261 // Indicates whether a value can be loaded as a constant.
 262 enum StoreMode { ALLOW_IN_DESCRIPTOR, FORCE_FIELD };
 263
 264
 265 // PropertyNormalizationMode is used to specify whether to keep
 266 // inobject properties when normalizing properties of a JSObject.
 267 enum PropertyNormalizationMode {
 268   CLEAR_INOBJECT_PROPERTIES,
 269   KEEP_INOBJECT_PROPERTIES
 270 };
 271
 272
 273 // Indicates how aggressively the prototype should be optimized. FAST_PROTOTYPE
 274 // will give the fastest result by tailoring the map to the prototype, but that
 275 // will cause polymorphism with other objects. REGULAR_PROTOTYPE is to be used
 276 // (at least for now) when dynamically modifying the prototype chain of an
 277 // object using __proto__ or Object.setPrototypeOf.
 278 enum PrototypeOptimizationMode { REGULAR_PROTOTYPE, FAST_PROTOTYPE };
 279
 280
 281 // Indicates whether transitions can be added to a source map or not.
 282 enum TransitionFlag {
 283   INSERT_TRANSITION,
 284   OMIT_TRANSITION
 285 };
 286
 287
 288 // Indicates whether the transition is simple: the target map of the transition
 289 // either extends the current map with a new property, or it modifies the
 290 // property that was added last to the current map.
 291 enum SimpleTransitionFlag {
 292   SIMPLE_PROPERTY_TRANSITION,
 293   PROPERTY_TRANSITION,
 294   SPECIAL_TRANSITION
 295 };
 296
 297
 298 // Indicates whether we are only interested in the descriptors of a particular
 299 // map, or in all descriptors in the descriptor array.
 300 enum DescriptorFlag {
 301   ALL_DESCRIPTORS,
 302   OWN_DESCRIPTORS
 303 };
 304
 305 // The GC maintains a bit of information, the MarkingParity, which toggles
 306 // from odd to even and back every time marking is completed. Incremental
 307 // marking can visit an object twice during a marking phase, so algorithms that
 308 // that piggy-back on marking can use the parity to ensure that they only
 309 // perform an operation on an object once per marking phase: they record the
 310 // MarkingParity when they visit an object, and only re-visit the object when it
 311 // is marked again and the MarkingParity changes.
 312 enum MarkingParity {
 313   NO_MARKING_PARITY,
 314   ODD_MARKING_PARITY,
 315   EVEN_MARKING_PARITY
 316 };
 317
 318 // ICs store extra state in a Code object. The default extra state is
 319 // kNoExtraICState.
 320 typedef int ExtraICState;
 321 static const ExtraICState kNoExtraICState = 0;
 322
 323 // Instance size sentinel for objects of variable size.
 324 const int kVariableSizeSentinel = 0;
 325
 326 // We may store the unsigned bit field as signed Smi value and do not
 327 // use the sign bit.
 328 const int kStubMajorKeyBits = 7;
 329 const int kStubMinorKeyBits = kSmiValueSize - kStubMajorKeyBits - 1;
 330
 331 // All Maps have a field instance_type containing a InstanceType.
 332 // It describes the type of the instances.
 333 //
 334 // As an example, a JavaScript object is a heap object and its map
 335 // instance_type is JS_OBJECT_TYPE.
 336 //
 337 // The names of the string instance types are intended to systematically
 338 // mirror their encoding in the instance_type field of the map.  The default
 339 // encoding is considered TWO_BYTE.  It is not mentioned in the name.  ONE_BYTE
 340 // encoding is mentioned explicitly in the name.  Likewise, the default
 341 // representation is considered sequential.  It is not mentioned in the
 342 // name.  The other representations (e.g. CONS, EXTERNAL) are explicitly
 343 // mentioned.  Finally, the string is either a STRING_TYPE (if it is a normal
 344 // string) or a INTERNALIZED_STRING_TYPE (if it is a internalized string).
 345 //
 346 // NOTE: The following things are some that depend on the string types having
 347 // instance_types that are less than those of all other types:
 348 // HeapObject::Size, HeapObject::IterateBody, the typeof operator, and
 349 // Object::IsString.
 350 //
 351 // NOTE: Everything following JS_VALUE_TYPE is considered a
 352 // JSObject for GC purposes. The first four entries here have typeof
 353 // 'object', whereas JS_FUNCTION_TYPE has typeof 'function'.
 354 #define INSTANCE_TYPE_LIST(V)                                   \
 355   V(STRING_TYPE)                                                \
 356   V(ONE_BYTE_STRING_TYPE)                                       \
 357   V(CONS_STRING_TYPE)                                           \
 358   V(CONS_ONE_BYTE_STRING_TYPE)                                  \
 359   V(SLICED_STRING_TYPE)                                         \
 360   V(SLICED_ONE_BYTE_STRING_TYPE)                                \
 361   V(EXTERNAL_STRING_TYPE)                                       \
 362   V(EXTERNAL_ONE_BYTE_STRING_TYPE)                              \
 363   V(EXTERNAL_STRING_WITH_ONE_BYTE_DATA_TYPE)                    \
 364   V(SHORT_EXTERNAL_STRING_TYPE)                                 \
 365   V(SHORT_EXTERNAL_ONE_BYTE_STRING_TYPE)                        \
 366   V(SHORT_EXTERNAL_STRING_WITH_ONE_BYTE_DATA_TYPE)              \
 367                                                                 \
 368   V(INTERNALIZED_STRING_TYPE)                                   \
 369   V(ONE_BYTE_INTERNALIZED_STRING_TYPE)                          \
 370   V(EXTERNAL_INTERNALIZED_STRING_TYPE)                          \
 371   V(EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE)                 \
 372   V(EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE)       \
 373   V(SHORT_EXTERNAL_INTERNALIZED_STRING_TYPE)                    \
 374   V(SHORT_EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE)           \
 375   V(SHORT_EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE) \
 376                                                                 \
 377   V(SYMBOL_TYPE)                                                \
 378   V(FLOAT32X4_TYPE)                                             \
 379   V(INT32X4_TYPE)                                               \
 380   V(BOOL32X4_TYPE)                                              \
 381   V(INT16X8_TYPE)                                               \
 382   V(BOOL16X8_TYPE)                                              \
 383   V(INT8X16_TYPE)                                               \
 384   V(BOOL8X16_TYPE)                                              \
 385                                                                 \
 386   V(MAP_TYPE)                                                   \
 387   V(CODE_TYPE)                                                  \
 388   V(ODDBALL_TYPE)                                               \
 389   V(CELL_TYPE)                                                  \
 390   V(PROPERTY_CELL_TYPE)                                         \
 391                                                                 \
 392   V(HEAP_NUMBER_TYPE)                                           \
 393   V(MUTABLE_HEAP_NUMBER_TYPE)                                   \
 394   V(FOREIGN_TYPE)                                               \
 395   V(BYTE_ARRAY_TYPE)                                            \
 396   V(BYTECODE_ARRAY_TYPE)                                        \
 397   V(FREE_SPACE_TYPE)                                            \
 398                                                                 \
 399   V(FIXED_INT8_ARRAY_TYPE)                                      \
 400   V(FIXED_UINT8_ARRAY_TYPE)                                     \
 401   V(FIXED_INT16_ARRAY_TYPE)                                     \
 402   V(FIXED_UINT16_ARRAY_TYPE)                                    \
 403   V(FIXED_INT32_ARRAY_TYPE)                                     \
 404   V(FIXED_UINT32_ARRAY_TYPE)                                    \
 405   V(FIXED_FLOAT32_ARRAY_TYPE)                                   \
 406   V(FIXED_FLOAT64_ARRAY_TYPE)                                   \
 407   V(FIXED_UINT8_CLAMPED_ARRAY_TYPE)                             \
 408                                                                 \
 409   V(FILLER_TYPE)                                                \
 410                                                                 \
 411   V(DECLARED_ACCESSOR_DESCRIPTOR_TYPE)                          \
 412   V(DECLARED_ACCESSOR_INFO_TYPE)                                \
 413   V(EXECUTABLE_ACCESSOR_INFO_TYPE)                              \
 414   V(ACCESSOR_PAIR_TYPE)                                         \
 415   V(ACCESS_CHECK_INFO_TYPE)                                     \
 416   V(INTERCEPTOR_INFO_TYPE)                                      \
 417   V(CALL_HANDLER_INFO_TYPE)                                     \
 418   V(FUNCTION_TEMPLATE_INFO_TYPE)                                \
 419   V(OBJECT_TEMPLATE_INFO_TYPE)                                  \
 420   V(SIGNATURE_INFO_TYPE)                                        \
 421   V(TYPE_SWITCH_INFO_TYPE)                                      \
 422   V(ALLOCATION_MEMENTO_TYPE)                                    \
 423   V(ALLOCATION_SITE_TYPE)                                       \
 424   V(SCRIPT_TYPE)                                                \
 425   V(CODE_CACHE_TYPE)                                            \
 426   V(POLYMORPHIC_CODE_CACHE_TYPE)                                \
 427   V(TYPE_FEEDBACK_INFO_TYPE)                                    \
 428   V(ALIASED_ARGUMENTS_ENTRY_TYPE)                               \
 429   V(BOX_TYPE)                                                   \
 430   V(PROTOTYPE_INFO_TYPE)                                        \
 431                                                                 \
 432   V(FIXED_ARRAY_TYPE)                                           \
 433   V(FIXED_DOUBLE_ARRAY_TYPE)                                    \
 434   V(SHARED_FUNCTION_INFO_TYPE)                                  \
 435   V(WEAK_CELL_TYPE)                                             \
 436                                                                 \
 437   V(JS_MESSAGE_OBJECT_TYPE)                                     \
 438                                                                 \
 439   V(JS_VALUE_TYPE)                                              \
 440   V(JS_DATE_TYPE)                                               \
 441   V(JS_OBJECT_TYPE)                                             \
 442   V(JS_CONTEXT_EXTENSION_OBJECT_TYPE)                           \
 443   V(JS_GENERATOR_OBJECT_TYPE)                                   \
 444   V(JS_MODULE_TYPE)                                             \
 445   V(JS_GLOBAL_OBJECT_TYPE)                                      \
 446   V(JS_BUILTINS_OBJECT_TYPE)                                    \
 447   V(JS_GLOBAL_PROXY_TYPE)                                       \
 448   V(JS_ARRAY_TYPE)                                              \
 449   V(JS_ARRAY_BUFFER_TYPE)                                       \
 450   V(JS_TYPED_ARRAY_TYPE)                                        \
 451   V(JS_DATA_VIEW_TYPE)                                          \
 452   V(JS_PROXY_TYPE)                                              \
 453   V(JS_SET_TYPE)                                                \
 454   V(JS_MAP_TYPE)                                                \
 455   V(JS_SET_ITERATOR_TYPE)                                       \
 456   V(JS_MAP_ITERATOR_TYPE)                                       \
 457   V(JS_WEAK_MAP_TYPE)                                           \
 458   V(JS_WEAK_SET_TYPE)                                           \
 459   V(JS_REGEXP_TYPE)                                             \
 460                                                                 \
 461   V(JS_FUNCTION_TYPE)                                           \
 462   V(JS_FUNCTION_PROXY_TYPE)                                     \
 463   V(DEBUG_INFO_TYPE)                                            \
 464   V(BREAK_POINT_INFO_TYPE)
 465
 466
 467 // Since string types are not consecutive, this macro is used to
 468 // iterate over them.
 469 #define STRING_TYPE_LIST(V)                                                   \
 470   V(STRING_TYPE, kVariableSizeSentinel, string, String)                       \
 471   V(ONE_BYTE_STRING_TYPE, kVariableSizeSentinel, one_byte_string,             \
 472     OneByteString)                                                            \
 473   V(CONS_STRING_TYPE, ConsString::kSize, cons_string, ConsString)             \
 474   V(CONS_ONE_BYTE_STRING_TYPE, ConsString::kSize, cons_one_byte_string,       \
 475     ConsOneByteString)                                                        \
 476   V(SLICED_STRING_TYPE, SlicedString::kSize, sliced_string, SlicedString)     \
 477   V(SLICED_ONE_BYTE_STRING_TYPE, SlicedString::kSize, sliced_one_byte_string, \
 478     SlicedOneByteString)                                                      \
 479   V(EXTERNAL_STRING_TYPE, ExternalTwoByteString::kSize, external_string,      \
 480     ExternalString)                                                           \
 481   V(EXTERNAL_ONE_BYTE_STRING_TYPE, ExternalOneByteString::kSize,              \
 482     external_one_byte_string, ExternalOneByteString)                          \
 483   V(EXTERNAL_STRING_WITH_ONE_BYTE_DATA_TYPE, ExternalTwoByteString::kSize,    \
 484     external_string_with_one_byte_data, ExternalStringWithOneByteData)        \
 485   V(SHORT_EXTERNAL_STRING_TYPE, ExternalTwoByteString::kShortSize,            \
 486     short_external_string, ShortExternalString)                               \
 487   V(SHORT_EXTERNAL_ONE_BYTE_STRING_TYPE, ExternalOneByteString::kShortSize,   \
 488     short_external_one_byte_string, ShortExternalOneByteString)               \
 489   V(SHORT_EXTERNAL_STRING_WITH_ONE_BYTE_DATA_TYPE,                            \
 490     ExternalTwoByteString::kShortSize,                                        \
 491     short_external_string_with_one_byte_data,                                 \
 492     ShortExternalStringWithOneByteData)                                       \
 493                                                                               \
 494   V(INTERNALIZED_STRING_TYPE, kVariableSizeSentinel, internalized_string,     \
 495     InternalizedString)                                                       \
 496   V(ONE_BYTE_INTERNALIZED_STRING_TYPE, kVariableSizeSentinel,                 \
 497     one_byte_internalized_string, OneByteInternalizedString)                  \
 498   V(EXTERNAL_INTERNALIZED_STRING_TYPE, ExternalTwoByteString::kSize,          \
 499     external_internalized_string, ExternalInternalizedString)                 \
 500   V(EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE, ExternalOneByteString::kSize, \
 501     external_one_byte_internalized_string, ExternalOneByteInternalizedString) \
 502   V(EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE,                     \
 503     ExternalTwoByteString::kSize,                                             \
 504     external_internalized_string_with_one_byte_data,                          \
 505     ExternalInternalizedStringWithOneByteData)                                \
 506   V(SHORT_EXTERNAL_INTERNALIZED_STRING_TYPE,                                  \
 507     ExternalTwoByteString::kShortSize, short_external_internalized_string,    \
 508     ShortExternalInternalizedString)                                          \
 509   V(SHORT_EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE,                         \
 510     ExternalOneByteString::kShortSize,                                        \
 511     short_external_one_byte_internalized_string,                              \
 512     ShortExternalOneByteInternalizedString)                                   \
 513   V(SHORT_EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE,               \
 514     ExternalTwoByteString::kShortSize,                                        \
 515     short_external_internalized_string_with_one_byte_data,                    \
 516     ShortExternalInternalizedStringWithOneByteData)
 517
 518 // A struct is a simple object a set of object-valued fields.  Including an
 519 // object type in this causes the compiler to generate most of the boilerplate
 520 // code for the class including allocation and garbage collection routines,
 521 // casts and predicates.  All you need to define is the class, methods and
 522 // object verification routines.  Easy, no?
 523 //
 524 // Note that for subtle reasons related to the ordering or numerical values of
 525 // type tags, elements in this list have to be added to the INSTANCE_TYPE_LIST
 526 // manually.
 527 #define STRUCT_LIST(V)                                                       \
 528   V(BOX, Box, box)                                                           \
 529   V(EXECUTABLE_ACCESSOR_INFO, ExecutableAccessorInfo,                        \
 530     executable_accessor_info)                                                \
 531   V(ACCESSOR_PAIR, AccessorPair, accessor_pair)                              \
 532   V(ACCESS_CHECK_INFO, AccessCheckInfo, access_check_info)                   \
 533   V(INTERCEPTOR_INFO, InterceptorInfo, interceptor_info)                     \
 534   V(CALL_HANDLER_INFO, CallHandlerInfo, call_handler_info)                   \
 535   V(FUNCTION_TEMPLATE_INFO, FunctionTemplateInfo, function_template_info)    \
 536   V(OBJECT_TEMPLATE_INFO, ObjectTemplateInfo, object_template_info)          \
 537   V(TYPE_SWITCH_INFO, TypeSwitchInfo, type_switch_info)                      \
 538   V(SCRIPT, Script, script)                                                  \
 539   V(ALLOCATION_SITE, AllocationSite, allocation_site)                        \
 540   V(ALLOCATION_MEMENTO, AllocationMemento, allocation_memento)               \
 541   V(CODE_CACHE, CodeCache, code_cache)                                       \
 542   V(POLYMORPHIC_CODE_CACHE, PolymorphicCodeCache, polymorphic_code_cache)    \
 543   V(TYPE_FEEDBACK_INFO, TypeFeedbackInfo, type_feedback_info)                \
 544   V(ALIASED_ARGUMENTS_ENTRY, AliasedArgumentsEntry, aliased_arguments_entry) \
 545   V(DEBUG_INFO, DebugInfo, debug_info)                                       \
 546   V(BREAK_POINT_INFO, BreakPointInfo, break_point_info)                      \
 547   V(PROTOTYPE_INFO, PrototypeInfo, prototype_info)
 548
 549 // We use the full 8 bits of the instance_type field to encode heap object
 550 // instance types.  The high-order bit (bit 7) is set if the object is not a
 551 // string, and cleared if it is a string.
 552 const uint32_t kIsNotStringMask = 0x80;
 553 const uint32_t kStringTag = 0x0;
 554 const uint32_t kNotStringTag = 0x80;
 555
 556 // Bit 6 indicates that the object is an internalized string (if set) or not.
 557 // Bit 7 has to be clear as well.
 558 const uint32_t kIsNotInternalizedMask = 0x40;
 559 const uint32_t kNotInternalizedTag = 0x40;
 560 const uint32_t kInternalizedTag = 0x0;
 561
 562 // If bit 7 is clear then bit 2 indicates whether the string consists of
 563 // two-byte characters or one-byte characters.
 564 const uint32_t kStringEncodingMask = 0x4;
 565 const uint32_t kTwoByteStringTag = 0x0;
 566 const uint32_t kOneByteStringTag = 0x4;
 567
 568 // If bit 7 is clear, the low-order 2 bits indicate the representation
 569 // of the string.
 570 const uint32_t kStringRepresentationMask = 0x03;
 571 enum StringRepresentationTag {
 572   kSeqStringTag = 0x0,
 573   kConsStringTag = 0x1,
 574   kExternalStringTag = 0x2,
 575   kSlicedStringTag = 0x3
 576 };
 577 const uint32_t kIsIndirectStringMask = 0x1;
 578 const uint32_t kIsIndirectStringTag = 0x1;
 579 STATIC_ASSERT((kSeqStringTag & kIsIndirectStringMask) == 0);  // NOLINT
 580 STATIC_ASSERT((kExternalStringTag & kIsIndirectStringMask) == 0);  // NOLINT
 581 STATIC_ASSERT((kConsStringTag &
 582                kIsIndirectStringMask) == kIsIndirectStringTag);  // NOLINT
 583 STATIC_ASSERT((kSlicedStringTag &
 584                kIsIndirectStringMask) == kIsIndirectStringTag);  // NOLINT
 585
 586 // Use this mask to distinguish between cons and slice only after making
 587 // sure that the string is one of the two (an indirect string).
 588 const uint32_t kSlicedNotConsMask = kSlicedStringTag & ~kConsStringTag;
 589 STATIC_ASSERT(IS_POWER_OF_TWO(kSlicedNotConsMask));
 590
 591 // If bit 7 is clear, then bit 3 indicates whether this two-byte
 592 // string actually contains one byte data.
 593 const uint32_t kOneByteDataHintMask = 0x08;
 594 const uint32_t kOneByteDataHintTag = 0x08;
 595
 596 // If bit 7 is clear and string representation indicates an external string,
 597 // then bit 4 indicates whether the data pointer is cached.
 598 const uint32_t kShortExternalStringMask = 0x10;
 599 const uint32_t kShortExternalStringTag = 0x10;
 600
 601
 602 // A ConsString with an empty string as the right side is a candidate
 603 // for being shortcut by the garbage collector. We don't allocate any
 604 // non-flat internalized strings, so we do not shortcut them thereby
 605 // avoiding turning internalized strings into strings. The bit-masks
 606 // below contain the internalized bit as additional safety.
 607 // See heap.cc, mark-compact.cc and objects-visiting.cc.
 608 const uint32_t kShortcutTypeMask =
 609     kIsNotStringMask |
 610     kIsNotInternalizedMask |
 611     kStringRepresentationMask;
 612 const uint32_t kShortcutTypeTag = kConsStringTag | kNotInternalizedTag;
 613
 614 static inline bool IsShortcutCandidate(int type) {
 615   return ((type & kShortcutTypeMask) == kShortcutTypeTag);
 616 }
 617
 618
 619 enum InstanceType {
 620   // String types.
 621   INTERNALIZED_STRING_TYPE =
 622       kTwoByteStringTag | kSeqStringTag | kInternalizedTag,
 623   ONE_BYTE_INTERNALIZED_STRING_TYPE =
 624       kOneByteStringTag | kSeqStringTag | kInternalizedTag,
 625   EXTERNAL_INTERNALIZED_STRING_TYPE =
 626       kTwoByteStringTag | kExternalStringTag | kInternalizedTag,
 627   EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE =
 628       kOneByteStringTag | kExternalStringTag | kInternalizedTag,
 629   EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE =
 630       EXTERNAL_INTERNALIZED_STRING_TYPE | kOneByteDataHintTag |
 631       kInternalizedTag,
 632   SHORT_EXTERNAL_INTERNALIZED_STRING_TYPE = EXTERNAL_INTERNALIZED_STRING_TYPE |
 633                                             kShortExternalStringTag |
 634                                             kInternalizedTag,
 635   SHORT_EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE =
 636       EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE | kShortExternalStringTag |
 637       kInternalizedTag,
 638   SHORT_EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE =
 639       EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE |
 640       kShortExternalStringTag | kInternalizedTag,
 641   STRING_TYPE = INTERNALIZED_STRING_TYPE | kNotInternalizedTag,
 642   ONE_BYTE_STRING_TYPE =
 643       ONE_BYTE_INTERNALIZED_STRING_TYPE | kNotInternalizedTag,
 644   CONS_STRING_TYPE = kTwoByteStringTag | kConsStringTag | kNotInternalizedTag,
 645   CONS_ONE_BYTE_STRING_TYPE =
 646       kOneByteStringTag | kConsStringTag | kNotInternalizedTag,
 647   SLICED_STRING_TYPE =
 648       kTwoByteStringTag | kSlicedStringTag | kNotInternalizedTag,
 649   SLICED_ONE_BYTE_STRING_TYPE =
 650       kOneByteStringTag | kSlicedStringTag | kNotInternalizedTag,
 651   EXTERNAL_STRING_TYPE =
 652       EXTERNAL_INTERNALIZED_STRING_TYPE | kNotInternalizedTag,
 653   EXTERNAL_ONE_BYTE_STRING_TYPE =
 654       EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE | kNotInternalizedTag,
 655   EXTERNAL_STRING_WITH_ONE_BYTE_DATA_TYPE =
 656       EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE |
 657       kNotInternalizedTag,
 658   SHORT_EXTERNAL_STRING_TYPE =
 659       SHORT_EXTERNAL_INTERNALIZED_STRING_TYPE | kNotInternalizedTag,
 660   SHORT_EXTERNAL_ONE_BYTE_STRING_TYPE =
 661       SHORT_EXTERNAL_ONE_BYTE_INTERNALIZED_STRING_TYPE | kNotInternalizedTag,
 662   SHORT_EXTERNAL_STRING_WITH_ONE_BYTE_DATA_TYPE =
 663       SHORT_EXTERNAL_INTERNALIZED_STRING_WITH_ONE_BYTE_DATA_TYPE |
 664       kNotInternalizedTag,
 665
 666   // Non-string names
 667   SYMBOL_TYPE = kNotStringTag,  // FIRST_NONSTRING_TYPE, LAST_NAME_TYPE
 668
 669   // Objects allocated in their own spaces (never in new space).
 670   MAP_TYPE,
 671   CODE_TYPE,
 672   ODDBALL_TYPE,
 673
 674   // "Data", objects that cannot contain non-map-word pointers to heap
 675   // objects.
 676   HEAP_NUMBER_TYPE,
 677   MUTABLE_HEAP_NUMBER_TYPE,
 678   FLOAT32X4_TYPE,  // FIRST_SIMD_VALUE_TYPE
 679   INT32X4_TYPE,
 680   BOOL32X4_TYPE,
 681   INT16X8_TYPE,
 682   BOOL16X8_TYPE,
 683   INT8X16_TYPE,
 684   BOOL8X16_TYPE,  // LAST_SIMD_VALUE_TYPE
 685   FOREIGN_TYPE,
 686   BYTE_ARRAY_TYPE,
 687   BYTECODE_ARRAY_TYPE,
 688   FREE_SPACE_TYPE,
 689   FIXED_INT8_ARRAY_TYPE,  // FIRST_FIXED_TYPED_ARRAY_TYPE
 690   FIXED_UINT8_ARRAY_TYPE,
 691   FIXED_INT16_ARRAY_TYPE,
 692   FIXED_UINT16_ARRAY_TYPE,
 693   FIXED_INT32_ARRAY_TYPE,
 694   FIXED_UINT32_ARRAY_TYPE,
 695   FIXED_FLOAT32_ARRAY_TYPE,
 696   FIXED_FLOAT64_ARRAY_TYPE,
 697   FIXED_UINT8_CLAMPED_ARRAY_TYPE,  // LAST_FIXED_TYPED_ARRAY_TYPE
 698   FIXED_DOUBLE_ARRAY_TYPE,
 699   FILLER_TYPE,  // LAST_DATA_TYPE
 700
 701   // Structs.
 702   DECLARED_ACCESSOR_DESCRIPTOR_TYPE,
 703   DECLARED_ACCESSOR_INFO_TYPE,
 704   EXECUTABLE_ACCESSOR_INFO_TYPE,
 705   ACCESSOR_PAIR_TYPE,
 706   ACCESS_CHECK_INFO_TYPE,
 707   INTERCEPTOR_INFO_TYPE,
 708   CALL_HANDLER_INFO_TYPE,
 709   FUNCTION_TEMPLATE_INFO_TYPE,
 710   OBJECT_TEMPLATE_INFO_TYPE,
 711   SIGNATURE_INFO_TYPE,
 712   TYPE_SWITCH_INFO_TYPE,
 713   ALLOCATION_SITE_TYPE,
 714   ALLOCATION_MEMENTO_TYPE,
 715   SCRIPT_TYPE,
 716   CODE_CACHE_TYPE,
 717   POLYMORPHIC_CODE_CACHE_TYPE,
 718   TYPE_FEEDBACK_INFO_TYPE,
 719   ALIASED_ARGUMENTS_ENTRY_TYPE,
 720   BOX_TYPE,
 721   DEBUG_INFO_TYPE,
 722   BREAK_POINT_INFO_TYPE,
 723   FIXED_ARRAY_TYPE,
 724   SHARED_FUNCTION_INFO_TYPE,
 725   CELL_TYPE,
 726   WEAK_CELL_TYPE,
 727   PROPERTY_CELL_TYPE,
 728   PROTOTYPE_INFO_TYPE,
 729
 730   // All the following types are subtypes of JSReceiver, which corresponds to
 731   // objects in the JS sense. The first and the last type in this range are
 732   // the two forms of function. This organization enables using the same
 733   // compares for checking the JS_RECEIVER/SPEC_OBJECT range and the
 734   // NONCALLABLE_JS_OBJECT range.
 735   JS_FUNCTION_PROXY_TYPE,  // FIRST_JS_RECEIVER_TYPE, FIRST_JS_PROXY_TYPE
 736   JS_PROXY_TYPE,           // LAST_JS_PROXY_TYPE
 737   JS_VALUE_TYPE,           // FIRST_JS_OBJECT_TYPE
 738   JS_MESSAGE_OBJECT_TYPE,
 739   JS_DATE_TYPE,
 740   JS_OBJECT_TYPE,
 741   JS_CONTEXT_EXTENSION_OBJECT_TYPE,
 742   JS_GENERATOR_OBJECT_TYPE,
 743   JS_MODULE_TYPE,
 744   JS_GLOBAL_OBJECT_TYPE,
 745   JS_BUILTINS_OBJECT_TYPE,
 746   JS_GLOBAL_PROXY_TYPE,
 747   JS_ARRAY_TYPE,
 748   JS_ARRAY_BUFFER_TYPE,
 749   JS_TYPED_ARRAY_TYPE,
 750   JS_DATA_VIEW_TYPE,
 751   JS_SET_TYPE,
 752   JS_MAP_TYPE,
 753   JS_SET_ITERATOR_TYPE,
 754   JS_MAP_ITERATOR_TYPE,
 755   JS_WEAK_MAP_TYPE,
 756   JS_WEAK_SET_TYPE,
 757   JS_REGEXP_TYPE,
 758   JS_FUNCTION_TYPE,  // LAST_JS_OBJECT_TYPE, LAST_JS_RECEIVER_TYPE
 759
 760   // Pseudo-types
 761   FIRST_TYPE = 0x0,
 762   LAST_TYPE = JS_FUNCTION_TYPE,
 763   FIRST_NAME_TYPE = FIRST_TYPE,
 764   LAST_NAME_TYPE = SYMBOL_TYPE,
 765   FIRST_UNIQUE_NAME_TYPE = INTERNALIZED_STRING_TYPE,
 766   LAST_UNIQUE_NAME_TYPE = SYMBOL_TYPE,
 767   FIRST_NONSTRING_TYPE = SYMBOL_TYPE,
 768   // Boundaries for testing for a SIMD types.
 769   FIRST_SIMD_VALUE_TYPE = FLOAT32X4_TYPE,
 770   LAST_SIMD_VALUE_TYPE = BOOL8X16_TYPE,
 771   // Boundaries for testing for a fixed typed array.
 772   FIRST_FIXED_TYPED_ARRAY_TYPE = FIXED_INT8_ARRAY_TYPE,
 773   LAST_FIXED_TYPED_ARRAY_TYPE = FIXED_UINT8_CLAMPED_ARRAY_TYPE,
 774   // Boundary for promotion to old space.
 775   LAST_DATA_TYPE = FILLER_TYPE,
 776   // Boundary for objects represented as JSReceiver (i.e. JSObject or JSProxy).
 777   // Note that there is no range for JSObject or JSProxy, since their subtypes
 778   // are not continuous in this enum! The enum ranges instead reflect the
 779   // external class names, where proxies are treated as either ordinary objects,
 780   // or functions.
 781   FIRST_JS_RECEIVER_TYPE = JS_FUNCTION_PROXY_TYPE,
 782   LAST_JS_RECEIVER_TYPE = LAST_TYPE,
 783   // Boundaries for testing the types represented as JSObject
 784   FIRST_JS_OBJECT_TYPE = JS_VALUE_TYPE,
 785   LAST_JS_OBJECT_TYPE = LAST_TYPE,
 786   // Boundaries for testing the types represented as JSProxy
 787   FIRST_JS_PROXY_TYPE = JS_FUNCTION_PROXY_TYPE,
 788   LAST_JS_PROXY_TYPE = JS_PROXY_TYPE,
 789   // Boundaries for testing whether the type is a JavaScript object.
 790   FIRST_SPEC_OBJECT_TYPE = FIRST_JS_RECEIVER_TYPE,
 791   LAST_SPEC_OBJECT_TYPE = LAST_JS_RECEIVER_TYPE,
 792   // Boundaries for testing the types for which typeof is "object".
 793   FIRST_NONCALLABLE_SPEC_OBJECT_TYPE = JS_PROXY_TYPE,
 794   LAST_NONCALLABLE_SPEC_OBJECT_TYPE = JS_REGEXP_TYPE,
 795   // Note that the types for which typeof is "function" are not continuous.
 796   // Define this so that we can put assertions on discrete checks.
 797   NUM_OF_CALLABLE_SPEC_OBJECT_TYPES = 2
 798 };
 799
 800 STATIC_ASSERT(JS_OBJECT_TYPE == Internals::kJSObjectType);
 801 STATIC_ASSERT(FIRST_NONSTRING_TYPE == Internals::kFirstNonstringType);
 802 STATIC_ASSERT(ODDBALL_TYPE == Internals::kOddballType);
 803 STATIC_ASSERT(FOREIGN_TYPE == Internals::kForeignType);
 804
 805
 806 #define FIXED_ARRAY_SUB_INSTANCE_TYPE_LIST(V) \
 807   V(FAST_ELEMENTS_SUB_TYPE)                   \
 808   V(DICTIONARY_ELEMENTS_SUB_TYPE)             \
 809   V(FAST_PROPERTIES_SUB_TYPE)                 \
 810   V(DICTIONARY_PROPERTIES_SUB_TYPE)           \
 811   V(MAP_CODE_CACHE_SUB_TYPE)                  \
 812   V(SCOPE_INFO_SUB_TYPE)                      \
 813   V(STRING_TABLE_SUB_TYPE)                    \
 814   V(DESCRIPTOR_ARRAY_SUB_TYPE)                \
 815   V(TRANSITION_ARRAY_SUB_TYPE)
 816
 817 enum FixedArraySubInstanceType {
 818 #define DEFINE_FIXED_ARRAY_SUB_INSTANCE_TYPE(name) name,
 819   FIXED_ARRAY_SUB_INSTANCE_TYPE_LIST(DEFINE_FIXED_ARRAY_SUB_INSTANCE_TYPE)
 820 #undef DEFINE_FIXED_ARRAY_SUB_INSTANCE_TYPE
 821   LAST_FIXED_ARRAY_SUB_TYPE = TRANSITION_ARRAY_SUB_TYPE
 822 };
 823
 824
 825 enum CompareResult {
 826   LESS      = -1,
 827   EQUAL     =  0,
 828   GREATER   =  1,
 829
 830   NOT_EQUAL = GREATER
 831 };
 832
 833
 834 #define DECL_BOOLEAN_ACCESSORS(name)   \
 835   inline bool name() const;            \
 836   inline void set_##name(bool value);  \
 837
 838
 839 #define DECL_ACCESSORS(name, type)                                      \
 840   inline type* name() const;                                            \
 841   inline void set_##name(type* value,                                   \
 842                          WriteBarrierMode mode = UPDATE_WRITE_BARRIER); \
 843
 844
 845 #define DECLARE_CAST(type)                              \
 846   INLINE(static type* cast(Object* object));            \
 847   INLINE(static const type* cast(const Object* object));
 848
 849
 850 class AccessorPair;
 851 class AllocationSite;
 852 class AllocationSiteCreationContext;
 853 class AllocationSiteUsageContext;
 854 class Cell;
 855 class ConsString;
 856 class ElementsAccessor;
 857 class FixedArrayBase;
 858 class FunctionLiteral;
 859 class GlobalObject;
 860 class JSBuiltinsObject;
 861 class LayoutDescriptor;
 862 class LookupIterator;
 863 class ObjectHashTable;
 864 class ObjectVisitor;
 865 class PropertyCell;
 866 class SafepointEntry;
 867 class SharedFunctionInfo;
 868 class StringStream;
 869 class TypeFeedbackInfo;
 870 class TypeFeedbackVector;
 871 class WeakCell;
 872
 873 // We cannot just say "class HeapType;" if it is created from a template... =8-?
 874 template<class> class TypeImpl;
 875 struct HeapTypeConfig;
 876 typedef TypeImpl<HeapTypeConfig> HeapType;
 877
 878
 879 // A template-ized version of the IsXXX functions.
 880 template <class C> inline bool Is(Object* obj);
 881
 882 #ifdef VERIFY_HEAP
 883 #define DECLARE_VERIFIER(Name) void Name##Verify();
 884 #else
 885 #define DECLARE_VERIFIER(Name)
 886 #endif
 887
 888 #ifdef OBJECT_PRINT
 889 #define DECLARE_PRINTER(Name) void Name##Print(std::ostream& os);  // NOLINT
 890 #else
 891 #define DECLARE_PRINTER(Name)
 892 #endif
 893
 894
 895 #define OBJECT_TYPE_LIST(V) \
 896   V(Smi)                    \
 897   V(HeapObject)             \
 898   V(Number)
 899
 900 #define HEAP_OBJECT_TYPE_LIST(V)   \
 901   V(HeapNumber)                    \
 902   V(MutableHeapNumber)             \
 903   V(Simd128Value)                  \
 904   V(Float32x4)                     \
 905   V(Int32x4)                       \
 906   V(Bool32x4)                      \
 907   V(Int16x8)                       \
 908   V(Bool16x8)                      \
 909   V(Int8x16)                       \
 910   V(Bool8x16)                      \
 911   V(Name)                          \
 912   V(UniqueName)                    \
 913   V(String)                        \
 914   V(SeqString)                     \
 915   V(ExternalString)                \
 916   V(ConsString)                    \
 917   V(SlicedString)                  \
 918   V(ExternalTwoByteString)         \
 919   V(ExternalOneByteString)         \
 920   V(SeqTwoByteString)              \
 921   V(SeqOneByteString)              \
 922   V(InternalizedString)            \
 923   V(Symbol)                        \
 924                                    \
 925   V(FixedTypedArrayBase)           \
 926   V(FixedUint8Array)               \
 927   V(FixedInt8Array)                \
 928   V(FixedUint16Array)              \
 929   V(FixedInt16Array)               \
 930   V(FixedUint32Array)              \
 931   V(FixedInt32Array)               \
 932   V(FixedFloat32Array)             \
 933   V(FixedFloat64Array)             \
 934   V(FixedUint8ClampedArray)        \
 935   V(ByteArray)                     \
 936   V(BytecodeArray)                 \
 937   V(FreeSpace)                     \
 938   V(JSReceiver)                    \
 939   V(JSObject)                      \
 940   V(JSContextExtensionObject)      \
 941   V(JSGeneratorObject)             \
 942   V(JSModule)                      \
 943   V(LayoutDescriptor)              \
 944   V(Map)                           \
 945   V(DescriptorArray)               \
 946   V(TransitionArray)               \
 947   V(TypeFeedbackVector)            \
 948   V(DeoptimizationInputData)       \
 949   V(DeoptimizationOutputData)      \
 950   V(DependentCode)                 \
 951   V(HandlerTable)                  \
 952   V(FixedArray)                    \
 953   V(FixedDoubleArray)              \
 954   V(WeakFixedArray)                \
 955   V(ArrayList)                     \
 956   V(Context)                       \
 957   V(ScriptContextTable)            \
 958   V(NativeContext)                 \
 959   V(ScopeInfo)                     \
 960   V(JSFunction)                    \
 961   V(Code)                          \
 962   V(Oddball)                       \
 963   V(SharedFunctionInfo)            \
 964   V(JSValue)                       \
 965   V(JSDate)                        \
 966   V(JSMessageObject)               \
 967   V(StringWrapper)                 \
 968   V(Foreign)                       \
 969   V(Boolean)                       \
 970   V(JSArray)                       \
 971   V(JSArrayBuffer)                 \
 972   V(JSArrayBufferView)             \
 973   V(JSTypedArray)                  \
 974   V(JSDataView)                    \
 975   V(JSProxy)                       \
 976   V(JSFunctionProxy)               \
 977   V(JSSet)                         \
 978   V(JSMap)                         \
 979   V(JSSetIterator)                 \
 980   V(JSMapIterator)                 \
 981   V(JSWeakCollection)              \
 982   V(JSWeakMap)                     \
 983   V(JSWeakSet)                     \
 984   V(JSRegExp)                      \
 985   V(HashTable)                     \
 986   V(Dictionary)                    \
 987   V(StringTable)                   \
 988   V(NormalizedMapCache)            \
 989   V(CompilationCacheTable)         \
 990   V(CodeCacheHashTable)            \
 991   V(PolymorphicCodeCacheHashTable) \
 992   V(MapCache)                      \
 993   V(Primitive)                     \
 994   V(GlobalObject)                  \
 995   V(JSGlobalObject)                \
 996   V(JSBuiltinsObject)              \
 997   V(JSGlobalProxy)                 \
 998   V(UndetectableObject)            \
 999   V(AccessCheckNeeded)             \
1000   V(Cell)                          \
1001   V(PropertyCell)                  \
1002   V(WeakCell)                      \
1003   V(ObjectHashTable)               \
1004   V(WeakHashTable)                 \
1005   V(WeakValueHashTable)            \
1006   V(OrderedHashTable)
1007
1008 // Object is the abstract superclass for all classes in the
1009 // object hierarchy.
1010 // Object does not use any virtual functions to avoid the
1011 // allocation of the C++ vtable.
1012 // Since both Smi and HeapObject are subclasses of Object no
1013 // data members can be present in Object.
1014 class Object {
1015  public:
1016   // Type testing.
1017   bool IsObject() const { return true; }
1018
1019 #define IS_TYPE_FUNCTION_DECL(type_)  INLINE(bool Is##type_() const);
1020   OBJECT_TYPE_LIST(IS_TYPE_FUNCTION_DECL)
1021   HEAP_OBJECT_TYPE_LIST(IS_TYPE_FUNCTION_DECL)
1022 #undef IS_TYPE_FUNCTION_DECL
1023
1024   // A non-keyed store is of the form a.x = foo or a["x"] = foo whereas
1025   // a keyed store is of the form a[expression] = foo.
1026   enum StoreFromKeyed {
1027     MAY_BE_STORE_FROM_KEYED,
1028     CERTAINLY_NOT_STORE_FROM_KEYED
1029   };
1030
1031   INLINE(bool IsFixedArrayBase() const);
1032   INLINE(bool IsExternal() const);
1033   INLINE(bool IsAccessorInfo() const);
1034
1035   INLINE(bool IsStruct() const);
1036 #define DECLARE_STRUCT_PREDICATE(NAME, Name, name) \
1037   INLINE(bool Is##Name() const);
1038   STRUCT_LIST(DECLARE_STRUCT_PREDICATE)
1039 #undef DECLARE_STRUCT_PREDICATE
1040
1041   INLINE(bool IsSpecObject()) const;
1042   INLINE(bool IsSpecFunction()) const;
1043   INLINE(bool IsTemplateInfo()) const;
1044   INLINE(bool IsNameDictionary() const);
1045   INLINE(bool IsGlobalDictionary() const);
1046   INLINE(bool IsSeededNumberDictionary() const);
1047   INLINE(bool IsUnseededNumberDictionary() const);
1048   INLINE(bool IsOrderedHashSet() const);
1049   INLINE(bool IsOrderedHashMap() const);
1050   bool IsCallable() const;
1051   static bool IsPromise(Handle<Object> object);
1052
1053   // Oddball testing.
1054   INLINE(bool IsUndefined() const);
1055   INLINE(bool IsNull() const);
1056   INLINE(bool IsTheHole() const);
1057   INLINE(bool IsException() const);
1058   INLINE(bool IsUninitialized() const);
1059   INLINE(bool IsTrue() const);
1060   INLINE(bool IsFalse() const);
1061   INLINE(bool IsArgumentsMarker() const);
1062
1063   // Filler objects (fillers and free space objects).
1064   INLINE(bool IsFiller() const);
1065
1066   // Extract the number.
1067   inline double Number();
1068   INLINE(bool IsNaN() const);
1069   INLINE(bool IsMinusZero() const);
1070   bool ToInt32(int32_t* value);
1071   bool ToUint32(uint32_t* value);
1072
1073   inline Representation OptimalRepresentation() {
1074     if (!FLAG_track_fields) return Representation::Tagged();
1075     if (IsSmi()) {
1076       return Representation::Smi();
1077     } else if (FLAG_track_double_fields && IsHeapNumber()) {
1078       return Representation::Double();
1079     } else if (FLAG_track_computed_fields && IsUninitialized()) {
1080       return Representation::None();
1081     } else if (FLAG_track_heap_object_fields) {
1082       DCHECK(IsHeapObject());
1083       return Representation::HeapObject();
1084     } else {
1085       return Representation::Tagged();
1086     }
1087   }
1088
1089   inline ElementsKind OptimalElementsKind() {
1090     if (IsSmi()) return FAST_SMI_ELEMENTS;
1091     if (IsNumber()) return FAST_DOUBLE_ELEMENTS;
1092     return FAST_ELEMENTS;
1093   }
1094
1095   inline bool FitsRepresentation(Representation representation) {
1096     if (FLAG_track_fields && representation.IsNone()) {
1097       return false;
1098     } else if (FLAG_track_fields && representation.IsSmi()) {
1099       return IsSmi();
1100     } else if (FLAG_track_double_fields && representation.IsDouble()) {
1101       return IsMutableHeapNumber() || IsNumber();
1102     } else if (FLAG_track_heap_object_fields && representation.IsHeapObject()) {
1103       return IsHeapObject();
1104     }
1105     return true;
1106   }
1107
1108   // Checks whether two valid primitive encodings of a property name resolve to
1109   // the same logical property. E.g., the smi 1, the string "1" and the double
1110   // 1 all refer to the same property, so this helper will return true.
1111   inline bool KeyEquals(Object* other);
1112
1113   Handle<HeapType> OptimalType(Isolate* isolate, Representation representation);
1114
1115   inline static Handle<Object> NewStorageFor(Isolate* isolate,
1116                                              Handle<Object> object,
1117                                              Representation representation);
1118
1119   inline static Handle<Object> WrapForRead(Isolate* isolate,
1120                                            Handle<Object> object,
1121                                            Representation representation);
1122
1123   // Returns true if the object is of the correct type to be used as a
1124   // implementation of a JSObject's elements.
1125   inline bool HasValidElements();
1126
1127   inline bool HasSpecificClassOf(String* name);
1128
1129   bool BooleanValue();                                      // ECMA-262 9.2.
1130
1131   // Convert to a JSObject if needed.
1132   // native_context is used when creating wrapper object.
1133   static inline MaybeHandle<JSReceiver> ToObject(Isolate* isolate,
1134                                                  Handle<Object> object);
1135   static MaybeHandle<JSReceiver> ToObject(Isolate* isolate,
1136                                           Handle<Object> object,
1137                                           Handle<Context> context);
1138
1139   MUST_USE_RESULT static MaybeHandle<Object> GetProperty(
1140       LookupIterator* it, LanguageMode language_mode = SLOPPY);
1141
1142   // Implementation of [[Put]], ECMA-262 5th edition, section 8.12.5.
1143   MUST_USE_RESULT static MaybeHandle<Object> SetProperty(
1144       Handle<Object> object, Handle<Name> name, Handle<Object> value,
1145       LanguageMode language_mode,
1146       StoreFromKeyed store_mode = MAY_BE_STORE_FROM_KEYED);
1147
1148   MUST_USE_RESULT static MaybeHandle<Object> SetProperty(
1149       LookupIterator* it, Handle<Object> value, LanguageMode language_mode,
1150       StoreFromKeyed store_mode);
1151
1152   MUST_USE_RESULT static MaybeHandle<Object> SetSuperProperty(
1153       LookupIterator* it, Handle<Object> value, LanguageMode language_mode,
1154       StoreFromKeyed store_mode);
1155
1156   MUST_USE_RESULT static MaybeHandle<Object> ReadAbsentProperty(
1157       LookupIterator* it, LanguageMode language_mode);
1158   MUST_USE_RESULT static MaybeHandle<Object> ReadAbsentProperty(
1159       Isolate* isolate, Handle<Object> receiver, Handle<Object> name,
1160       LanguageMode language_mode);
1161   MUST_USE_RESULT static MaybeHandle<Object> WriteToReadOnlyProperty(
1162       LookupIterator* it, Handle<Object> value, LanguageMode language_mode);
1163   MUST_USE_RESULT static MaybeHandle<Object> WriteToReadOnlyProperty(
1164       Isolate* isolate, Handle<Object> receiver, Handle<Object> name,
1165       Handle<Object> value, LanguageMode language_mode);
1166   MUST_USE_RESULT static MaybeHandle<Object> RedefineNonconfigurableProperty(
1167       Isolate* isolate, Handle<Object> name, Handle<Object> value,
1168       LanguageMode language_mode);
1169   MUST_USE_RESULT static MaybeHandle<Object> SetDataProperty(
1170       LookupIterator* it, Handle<Object> value);
1171   MUST_USE_RESULT static MaybeHandle<Object> AddDataProperty(
1172       LookupIterator* it, Handle<Object> value, PropertyAttributes attributes,
1173       LanguageMode language_mode, StoreFromKeyed store_mode);
1174   MUST_USE_RESULT static inline MaybeHandle<Object> GetPropertyOrElement(
1175       Handle<Object> object, Handle<Name> name,
1176       LanguageMode language_mode = SLOPPY);
1177   MUST_USE_RESULT static inline MaybeHandle<Object> GetProperty(
1178       Isolate* isolate, Handle<Object> object, const char* key,
1179       LanguageMode language_mode = SLOPPY);
1180   MUST_USE_RESULT static inline MaybeHandle<Object> GetProperty(
1181       Handle<Object> object, Handle<Name> name,
1182       LanguageMode language_mode = SLOPPY);
1183
1184   MUST_USE_RESULT static MaybeHandle<Object> GetPropertyWithAccessor(
1185       LookupIterator* it, LanguageMode language_mode);
1186   MUST_USE_RESULT static MaybeHandle<Object> SetPropertyWithAccessor(
1187       LookupIterator* it, Handle<Object> value, LanguageMode language_mode);
1188
1189   MUST_USE_RESULT static MaybeHandle<Object> GetPropertyWithDefinedGetter(
1190       Handle<Object> receiver,
1191       Handle<JSReceiver> getter);
1192   MUST_USE_RESULT static MaybeHandle<Object> SetPropertyWithDefinedSetter(
1193       Handle<Object> receiver,
1194       Handle<JSReceiver> setter,
1195       Handle<Object> value);
1196
1197   MUST_USE_RESULT static inline MaybeHandle<Object> GetElement(
1198       Isolate* isolate, Handle<Object> object, uint32_t index,
1199       LanguageMode language_mode = SLOPPY);
1200
1201   MUST_USE_RESULT static inline MaybeHandle<Object> SetElement(
1202       Isolate* isolate, Handle<Object> object, uint32_t index,
1203       Handle<Object> value, LanguageMode language_mode);
1204
1205   static inline Handle<Object> GetPrototypeSkipHiddenPrototypes(
1206       Isolate* isolate, Handle<Object> receiver);
1207
1208   // Returns the permanent hash code associated with this object. May return
1209   // undefined if not yet created.
1210   Object* GetHash();
1211
1212   // Returns undefined for JSObjects, but returns the hash code for simple
1213   // objects.  This avoids a double lookup in the cases where we know we will
1214   // add the hash to the JSObject if it does not already exist.
1215   Object* GetSimpleHash();
1216
1217   // Returns the permanent hash code associated with this object depending on
1218   // the actual object type. May create and store a hash code if needed and none
1219   // exists.
1220   static Handle<Smi> GetOrCreateHash(Isolate* isolate, Handle<Object> object);
1221
1222   // Checks whether this object has the same value as the given one.  This
1223   // function is implemented according to ES5, section 9.12 and can be used
1224   // to implement the Harmony "egal" function.
1225   bool SameValue(Object* other);
1226
1227   // Checks whether this object has the same value as the given one.
1228   // +0 and -0 are treated equal. Everything else is the same as SameValue.
1229   // This function is implemented according to ES6, section 7.2.4 and is used
1230   // by ES6 Map and Set.
1231   bool SameValueZero(Object* other);
1232
1233   // Tries to convert an object to an array length. Returns true and sets the
1234   // output parameter if it succeeds.
1235   inline bool ToArrayLength(uint32_t* index);
1236
1237   // Tries to convert an object to an array index. Returns true and sets the
1238   // output parameter if it succeeds. Equivalent to ToArrayLength, but does not
1239   // allow kMaxUInt32.
1240   inline bool ToArrayIndex(uint32_t* index);
1241
1242   // Returns true if this is a JSValue containing a string and the index is
1243   // < the length of the string.  Used to implement [] on strings.
1244   inline bool IsStringObjectWithCharacterAt(uint32_t index);
1245
1246   DECLARE_VERIFIER(Object)
1247 #ifdef VERIFY_HEAP
1248   // Verify a pointer is a valid object pointer.
1249   static void VerifyPointer(Object* p);
1250 #endif
1251
1252   inline void VerifyApiCallResultType();
1253
1254   // Prints this object without details.
1255   void ShortPrint(FILE* out = stdout);
1256
1257   // Prints this object without details to a message accumulator.
1258   void ShortPrint(StringStream* accumulator);
1259
1260   void ShortPrint(std::ostream& os);  // NOLINT
1261
1262   DECLARE_CAST(Object)
1263
1264   // Layout description.
1265   static const int kHeaderSize = 0;  // Object does not take up any space.
1266
1267 #ifdef OBJECT_PRINT
1268   // For our gdb macros, we should perhaps change these in the future.
1269   void Print();
1270
1271   // Prints this object with details.
1272   void Print(std::ostream& os);  // NOLINT
1273 #else
1274   void Print() { ShortPrint(); }
1275   void Print(std::ostream& os) { ShortPrint(os); }  // NOLINT
1276 #endif
1277
1278  private:
1279   friend class LookupIterator;
1280   friend class PrototypeIterator;
1281
1282   // Return the map of the root of object's prototype chain.
1283   Map* GetRootMap(Isolate* isolate);
1284
1285   // Helper for SetProperty and SetSuperProperty.
1286   MUST_USE_RESULT static MaybeHandle<Object> SetPropertyInternal(
1287       LookupIterator* it, Handle<Object> value, LanguageMode language_mode,
1288       StoreFromKeyed store_mode, bool* found);
1289
1290   DISALLOW_IMPLICIT_CONSTRUCTORS(Object);
1291 };
1292
1293
1294 struct Brief {
1295   explicit Brief(const Object* const v) : value(v) {}
1296   const Object* value;
1297 };
1298
1299
1300 std::ostream& operator<<(std::ostream& os, const Brief& v);
1301
1302
1303 // Smi represents integer Numbers that can be stored in 31 bits.
1304 // Smis are immediate which means they are NOT allocated in the heap.
1305 // The this pointer has the following format: [31 bit signed int] 0
1306 // For long smis it has the following format:
1307 //     [32 bit signed int] [31 bits zero padding] 0
1308 // Smi stands for small integer.
1309 class Smi: public Object {
1310  public:
1311   // Returns the integer value.
1312   inline int value() const;
1313
1314   // Convert a value to a Smi object.
1315   static inline Smi* FromInt(int value);
1316
1317   static inline Smi* FromIntptr(intptr_t value);
1318
1319   // Returns whether value can be represented in a Smi.
1320   static inline bool IsValid(intptr_t value);
1321
1322   DECLARE_CAST(Smi)
1323
1324   // Dispatched behavior.
1325   void SmiPrint(std::ostream& os) const;  // NOLINT
1326   DECLARE_VERIFIER(Smi)
1327
1328   static const int kMinValue =
1329       (static_cast<unsigned int>(-1)) << (kSmiValueSize - 1);
1330   static const int kMaxValue = -(kMinValue + 1);
1331
1332  private:
1333   DISALLOW_IMPLICIT_CONSTRUCTORS(Smi);
1334 };
1335
1336
1337 // Heap objects typically have a map pointer in their first word.  However,
1338 // during GC other data (e.g. mark bits, forwarding addresses) is sometimes
1339 // encoded in the first word.  The class MapWord is an abstraction of the
1340 // value in a heap object's first word.
1341 class MapWord BASE_EMBEDDED {
1342  public:
1343   // Normal state: the map word contains a map pointer.
1344
1345   // Create a map word from a map pointer.
1346   static inline MapWord FromMap(const Map* map);
1347
1348   // View this map word as a map pointer.
1349   inline Map* ToMap();
1350
1351
1352   // Scavenge collection: the map word of live objects in the from space
1353   // contains a forwarding address (a heap object pointer in the to space).
1354
1355   // True if this map word is a forwarding address for a scavenge
1356   // collection.  Only valid during a scavenge collection (specifically,
1357   // when all map words are heap object pointers, i.e. not during a full GC).
1358   inline bool IsForwardingAddress();
1359
1360   // Create a map word from a forwarding address.
1361   static inline MapWord FromForwardingAddress(HeapObject* object);
1362
1363   // View this map word as a forwarding address.
1364   inline HeapObject* ToForwardingAddress();
1365
1366   static inline MapWord FromRawValue(uintptr_t value) {
1367     return MapWord(value);
1368   }
1369
1370   inline uintptr_t ToRawValue() {
1371     return value_;
1372   }
1373
1374  private:
1375   // HeapObject calls the private constructor and directly reads the value.
1376   friend class HeapObject;
1377
1378   explicit MapWord(uintptr_t value) : value_(value) {}
1379
1380   uintptr_t value_;
1381 };
1382
1383
1384 // The content of an heap object (except for the map pointer). kTaggedValues
1385 // objects can contain both heap pointers and Smis, kMixedValues can contain
1386 // heap pointers, Smis, and raw values (e.g. doubles or strings), and kRawValues
1387 // objects can contain raw values and Smis.
1388 enum class HeapObjectContents { kTaggedValues, kMixedValues, kRawValues };
1389
1390
1391 // HeapObject is the superclass for all classes describing heap allocated
1392 // objects.
1393 class HeapObject: public Object {
1394  public:
1395   // [map]: Contains a map which contains the object's reflective
1396   // information.
1397   inline Map* map() const;
1398   inline void set_map(Map* value);
1399   // The no-write-barrier version.  This is OK if the object is white and in
1400   // new space, or if the value is an immortal immutable object, like the maps
1401   // of primitive (non-JS) objects like strings, heap numbers etc.
1402   inline void set_map_no_write_barrier(Map* value);
1403
1404   // Get the map using acquire load.
1405   inline Map* synchronized_map();
1406   inline MapWord synchronized_map_word() const;
1407
1408   // Set the map using release store
1409   inline void synchronized_set_map(Map* value);
1410   inline void synchronized_set_map_no_write_barrier(Map* value);
1411   inline void synchronized_set_map_word(MapWord map_word);
1412
1413   // During garbage collection, the map word of a heap object does not
1414   // necessarily contain a map pointer.
1415   inline MapWord map_word() const;
1416   inline void set_map_word(MapWord map_word);
1417
1418   // The Heap the object was allocated in. Used also to access Isolate.
1419   inline Heap* GetHeap() const;
1420
1421   // Convenience method to get current isolate.
1422   inline Isolate* GetIsolate() const;
1423
1424   // Converts an address to a HeapObject pointer.
1425   static inline HeapObject* FromAddress(Address address);
1426
1427   // Returns the address of this HeapObject.
1428   inline Address address();
1429
1430   // Iterates over pointers contained in the object (including the Map)
1431   void Iterate(ObjectVisitor* v);
1432
1433   // Iterates over all pointers contained in the object except the
1434   // first map pointer.  The object type is given in the first
1435   // parameter. This function does not access the map pointer in the
1436   // object, and so is safe to call while the map pointer is modified.
1437   void IterateBody(InstanceType type, int object_size, ObjectVisitor* v);
1438
1439   // Returns the heap object's size in bytes
1440   inline int Size();
1441
1442   // Indicates what type of values this heap object may contain.
1443   inline HeapObjectContents ContentType();
1444
1445   // Given a heap object's map pointer, returns the heap size in bytes
1446   // Useful when the map pointer field is used for other purposes.
1447   // GC internal.
1448   inline int SizeFromMap(Map* map);
1449
1450   // Returns the field at offset in obj, as a read/write Object* reference.
1451   // Does no checking, and is safe to use during GC, while maps are invalid.
1452   // Does not invoke write barrier, so should only be assigned to
1453   // during marking GC.
1454   static inline Object** RawField(HeapObject* obj, int offset);
1455
1456   // Adds the |code| object related to |name| to the code cache of this map. If
1457   // this map is a dictionary map that is shared, the map copied and installed
1458   // onto the object.
1459   static void UpdateMapCodeCache(Handle<HeapObject> object,
1460                                  Handle<Name> name,
1461                                  Handle<Code> code);
1462
1463   DECLARE_CAST(HeapObject)
1464
1465   // Return the write barrier mode for this. Callers of this function
1466   // must be able to present a reference to an DisallowHeapAllocation
1467   // object as a sign that they are not going to use this function
1468   // from code that allocates and thus invalidates the returned write
1469   // barrier mode.
1470   inline WriteBarrierMode GetWriteBarrierMode(
1471       const DisallowHeapAllocation& promise);
1472
1473   // Dispatched behavior.
1474   void HeapObjectShortPrint(std::ostream& os);  // NOLINT
1475 #ifdef OBJECT_PRINT
1476   void PrintHeader(std::ostream& os, const char* id);  // NOLINT
1477 #endif
1478   DECLARE_PRINTER(HeapObject)
1479   DECLARE_VERIFIER(HeapObject)
1480 #ifdef VERIFY_HEAP
1481   inline void VerifyObjectField(int offset);
1482   inline void VerifySmiField(int offset);
1483
1484   // Verify a pointer is a valid HeapObject pointer that points to object
1485   // areas in the heap.
1486   static void VerifyHeapPointer(Object* p);
1487 #endif
1488
1489   inline AllocationAlignment RequiredAlignment();
1490
1491   // Layout description.
1492   // First field in a heap object is map.
1493   static const int kMapOffset = Object::kHeaderSize;
1494   static const int kHeaderSize = kMapOffset + kPointerSize;
1495
1496   STATIC_ASSERT(kMapOffset == Internals::kHeapObjectMapOffset);
1497
1498  protected:
1499   // helpers for calling an ObjectVisitor to iterate over pointers in the
1500   // half-open range [start, end) specified as integer offsets
1501   inline void IteratePointers(ObjectVisitor* v, int start, int end);
1502   // as above, for the single element at "offset"
1503   inline void IteratePointer(ObjectVisitor* v, int offset);
1504   // as above, for the next code link of a code object.
1505   inline void IterateNextCodeLink(ObjectVisitor* v, int offset);
1506
1507  private:
1508   DISALLOW_IMPLICIT_CONSTRUCTORS(HeapObject);
1509 };
1510
1511
1512 // This class describes a body of an object of a fixed size
1513 // in which all pointer fields are located in the [start_offset, end_offset)
1514 // interval.
1515 template<int start_offset, int end_offset, int size>
1516 class FixedBodyDescriptor {
1517  public:
1518   static const int kStartOffset = start_offset;
1519   static const int kEndOffset = end_offset;
1520   static const int kSize = size;
1521
1522   static inline void IterateBody(HeapObject* obj, ObjectVisitor* v);
1523
1524   template<typename StaticVisitor>
1525   static inline void IterateBody(HeapObject* obj) {
1526     StaticVisitor::VisitPointers(HeapObject::RawField(obj, start_offset),
1527                                  HeapObject::RawField(obj, end_offset));
1528   }
1529 };
1530
1531
1532 // This class describes a body of an object of a variable size
1533 // in which all pointer fields are located in the [start_offset, object_size)
1534 // interval.
1535 template<int start_offset>
1536 class FlexibleBodyDescriptor {
1537  public:
1538   static const int kStartOffset = start_offset;
1539
1540   static inline void IterateBody(HeapObject* obj,
1541                                  int object_size,
1542                                  ObjectVisitor* v);
1543
1544   template<typename StaticVisitor>
1545   static inline void IterateBody(HeapObject* obj, int object_size) {
1546     StaticVisitor::VisitPointers(HeapObject::RawField(obj, start_offset),
1547                                  HeapObject::RawField(obj, object_size));
1548   }
1549 };
1550
1551
1552 // The HeapNumber class describes heap allocated numbers that cannot be
1553 // represented in a Smi (small integer)
1554 class HeapNumber: public HeapObject {
1555  public:
1556   // [value]: number value.
1557   inline double value() const;
1558   inline void set_value(double value);
1559
1560   DECLARE_CAST(HeapNumber)
1561
1562   // Dispatched behavior.
1563   bool HeapNumberBooleanValue();
1564
1565   void HeapNumberPrint(std::ostream& os);  // NOLINT
1566   DECLARE_VERIFIER(HeapNumber)
1567
1568   inline int get_exponent();
1569   inline int get_sign();
1570
1571   // Layout description.
1572   static const int kValueOffset = HeapObject::kHeaderSize;
1573   // IEEE doubles are two 32 bit words.  The first is just mantissa, the second
1574   // is a mixture of sign, exponent and mantissa. The offsets of two 32 bit
1575   // words within double numbers are endian dependent and they are set
1576   // accordingly.
1577 #if defined(V8_TARGET_LITTLE_ENDIAN)
1578   static const int kMantissaOffset = kValueOffset;
1579   static const int kExponentOffset = kValueOffset + 4;
1580 #elif defined(V8_TARGET_BIG_ENDIAN)
1581   static const int kMantissaOffset = kValueOffset + 4;
1582   static const int kExponentOffset = kValueOffset;
1583 #else
1584 #error Unknown byte ordering
1585 #endif
1586
1587   static const int kSize = kValueOffset + kDoubleSize;
1588   static const uint32_t kSignMask = 0x80000000u;
1589   static const uint32_t kExponentMask = 0x7ff00000u;
1590   static const uint32_t kMantissaMask = 0xfffffu;
1591   static const int kMantissaBits = 52;
1592   static const int kExponentBits = 11;
1593   static const int kExponentBias = 1023;
1594   static const int kExponentShift = 20;
1595   static const int kInfinityOrNanExponent =
1596       (kExponentMask >> kExponentShift) - kExponentBias;
1597   static const int kMantissaBitsInTopWord = 20;
1598   static const int kNonMantissaBitsInTopWord = 12;
1599
1600  private:
1601   DISALLOW_IMPLICIT_CONSTRUCTORS(HeapNumber);
1602 };
1603
1604
1605 // The SimdValue128 class describes heap allocated 128 bit SIMD values.
1606 class Simd128Value : public HeapObject {
1607  public:
1608   DECLARE_CAST(Simd128Value)
1609
1610   // Checks that another instance is bit-wise equal.
1611   bool BitwiseEquals(const Simd128Value* other) const;
1612   // Computes a hash from the 128 bit value, viewed as 4 32-bit integers.
1613   uint32_t Hash() const;
1614
1615   // Layout description.
1616   static const int kValueOffset = HeapObject::kHeaderSize;
1617   static const int kSize = kValueOffset + kSimd128Size;
1618
1619  private:
1620   DISALLOW_IMPLICIT_CONSTRUCTORS(Simd128Value);
1621 };
1622
1623
1624 #define SIMD128_TYPES(V)            \
1625   V(Float32x4, float32x4, 4, float) \
1626   V(Int32x4, int32x4, 4, int32_t)   \
1627   V(Bool32x4, bool32x4, 4, bool)    \
1628   V(Int16x8, int16x8, 8, int16_t)   \
1629   V(Bool16x8, bool16x8, 8, bool)    \
1630   V(Int8x16, int8x16, 16, int8_t)   \
1631   V(Bool8x16, bool8x16, 16, bool)
1632
1633 #define SIMD128_VALUE_CLASS(name, type, lane_count, lane_type) \
1634   class name : public Simd128Value {                           \
1635    public:                                                     \
1636     inline lane_type get_lane(int lane) const;                 \
1637     inline void set_lane(int lane, lane_type value);           \
1638                                                                \
1639     DECLARE_CAST(name)                                         \
1640                                                                \
1641     DECLARE_PRINTER(name)                                      \
1642     DECLARE_VERIFIER(name)                                     \
1643                                                                \
1644    private:                                                    \
1645     DISALLOW_IMPLICIT_CONSTRUCTORS(name);                      \
1646   };
1647
1648 SIMD128_TYPES(SIMD128_VALUE_CLASS)
1649
1650
1651 enum EnsureElementsMode {
1652   DONT_ALLOW_DOUBLE_ELEMENTS,
1653   ALLOW_COPIED_DOUBLE_ELEMENTS,
1654   ALLOW_CONVERTED_DOUBLE_ELEMENTS
1655 };
1656
1657
1658 // Indicator for one component of an AccessorPair.
1659 enum AccessorComponent {
1660   ACCESSOR_GETTER,
1661   ACCESSOR_SETTER
1662 };
1663
1664
1665 // JSReceiver includes types on which properties can be defined, i.e.,
1666 // JSObject and JSProxy.
1667 class JSReceiver: public HeapObject {
1668  public:
1669   DECLARE_CAST(JSReceiver)
1670
1671   // Implementation of [[HasProperty]], ECMA-262 5th edition, section 8.12.6.
1672   MUST_USE_RESULT static inline Maybe<bool> HasProperty(
1673       Handle<JSReceiver> object, Handle<Name> name);
1674   MUST_USE_RESULT static inline Maybe<bool> HasOwnProperty(Handle<JSReceiver>,
1675                                                            Handle<Name> name);
1676   MUST_USE_RESULT static inline Maybe<bool> HasElement(
1677       Handle<JSReceiver> object, uint32_t index);
1678   MUST_USE_RESULT static inline Maybe<bool> HasOwnElement(
1679       Handle<JSReceiver> object, uint32_t index);
1680
1681   // Implementation of [[Delete]], ECMA-262 5th edition, section 8.12.7.
1682   MUST_USE_RESULT static MaybeHandle<Object> DeletePropertyOrElement(
1683       Handle<JSReceiver> object, Handle<Name> name,
1684       LanguageMode language_mode = SLOPPY);
1685   MUST_USE_RESULT static MaybeHandle<Object> DeleteProperty(
1686       Handle<JSReceiver> object, Handle<Name> name,
1687       LanguageMode language_mode = SLOPPY);
1688   MUST_USE_RESULT static MaybeHandle<Object> DeleteProperty(
1689       LookupIterator* it, LanguageMode language_mode);
1690   MUST_USE_RESULT static MaybeHandle<Object> DeleteElement(
1691       Handle<JSReceiver> object, uint32_t index,
1692       LanguageMode language_mode = SLOPPY);
1693
1694   // Tests for the fast common case for property enumeration.
1695   bool IsSimpleEnum();
1696
1697   // Returns the class name ([[Class]] property in the specification).
1698   String* class_name();
1699
1700   // Returns the constructor name (the name (possibly, inferred name) of the
1701   // function that was used to instantiate the object).
1702   String* constructor_name();
1703
1704   MUST_USE_RESULT static inline Maybe<PropertyAttributes> GetPropertyAttributes(
1705       Handle<JSReceiver> object, Handle<Name> name);
1706   MUST_USE_RESULT static inline Maybe<PropertyAttributes>
1707   GetOwnPropertyAttributes(Handle<JSReceiver> object, Handle<Name> name);
1708
1709   MUST_USE_RESULT static inline Maybe<PropertyAttributes> GetElementAttributes(
1710       Handle<JSReceiver> object, uint32_t index);
1711   MUST_USE_RESULT static inline Maybe<PropertyAttributes>
1712   GetOwnElementAttributes(Handle<JSReceiver> object, uint32_t index);
1713
1714   MUST_USE_RESULT static Maybe<PropertyAttributes> GetPropertyAttributes(
1715       LookupIterator* it);
1716
1717
1718   static Handle<Object> GetDataProperty(Handle<JSReceiver> object,
1719                                         Handle<Name> name);
1720   static Handle<Object> GetDataProperty(LookupIterator* it);
1721
1722
1723   // Retrieves a permanent object identity hash code. The undefined value might
1724   // be returned in case no hash was created yet.
1725   inline Object* GetIdentityHash();
1726
1727   // Retrieves a permanent object identity hash code. May create and store a
1728   // hash code if needed and none exists.
1729   inline static Handle<Smi> GetOrCreateIdentityHash(
1730       Handle<JSReceiver> object);
1731
1732   enum KeyCollectionType { OWN_ONLY, INCLUDE_PROTOS };
1733
1734   // Computes the enumerable keys for a JSObject. Used for implementing
1735   // "for (n in object) { }".
1736   MUST_USE_RESULT static MaybeHandle<FixedArray> GetKeys(
1737       Handle<JSReceiver> object,
1738       KeyCollectionType type);
1739
1740  private:
1741   DISALLOW_IMPLICIT_CONSTRUCTORS(JSReceiver);
1742 };
1743
1744
1745 // The JSObject describes real heap allocated JavaScript objects with
1746 // properties.
1747 // Note that the map of JSObject changes during execution to enable inline
1748 // caching.
1749 class JSObject: public JSReceiver {
1750  public:
1751   // [properties]: Backing storage for properties.
1752   // properties is a FixedArray in the fast case and a Dictionary in the
1753   // slow case.
1754   DECL_ACCESSORS(properties, FixedArray)  // Get and set fast properties.
1755   inline void initialize_properties();
1756   inline bool HasFastProperties();
1757   // Gets slow properties for non-global objects.
1758   inline NameDictionary* property_dictionary();
1759   // Gets global object properties.
1760   inline GlobalDictionary* global_dictionary();
1761
1762   // [elements]: The elements (properties with names that are integers).
1763   //
1764   // Elements can be in two general modes: fast and slow. Each mode
1765   // corrensponds to a set of object representations of elements that
1766   // have something in common.
1767   //
1768   // In the fast mode elements is a FixedArray and so each element can
1769   // be quickly accessed. This fact is used in the generated code. The
1770   // elements array can have one of three maps in this mode:
1771   // fixed_array_map, sloppy_arguments_elements_map or
1772   // fixed_cow_array_map (for copy-on-write arrays). In the latter case
1773   // the elements array may be shared by a few objects and so before
1774   // writing to any element the array must be copied. Use
1775   // EnsureWritableFastElements in this case.
1776   //
1777   // In the slow mode the elements is either a NumberDictionary, a
1778   // FixedArray parameter map for a (sloppy) arguments object.
1779   DECL_ACCESSORS(elements, FixedArrayBase)
1780   inline void initialize_elements();
1781   static void ResetElements(Handle<JSObject> object);
1782   static inline void SetMapAndElements(Handle<JSObject> object,
1783                                        Handle<Map> map,
1784                                        Handle<FixedArrayBase> elements);
1785   inline ElementsKind GetElementsKind();
1786   ElementsAccessor* GetElementsAccessor();
1787   // Returns true if an object has elements of FAST_SMI_ELEMENTS ElementsKind.
1788   inline bool HasFastSmiElements();
1789   // Returns true if an object has elements of FAST_ELEMENTS ElementsKind.
1790   inline bool HasFastObjectElements();
1791   // Returns true if an object has elements of FAST_ELEMENTS or
1792   // FAST_SMI_ONLY_ELEMENTS.
1793   inline bool HasFastSmiOrObjectElements();
1794   // Returns true if an object has any of the fast elements kinds.
1795   inline bool HasFastElements();
1796   // Returns true if an object has elements of FAST_DOUBLE_ELEMENTS
1797   // ElementsKind.
1798   inline bool HasFastDoubleElements();
1799   // Returns true if an object has elements of FAST_HOLEY_*_ELEMENTS
1800   // ElementsKind.
1801   inline bool HasFastHoleyElements();
1802   inline bool HasSloppyArgumentsElements();
1803   inline bool HasDictionaryElements();
1804
1805   inline bool HasFixedTypedArrayElements();
1806
1807   inline bool HasFixedUint8ClampedElements();
1808   inline bool HasFixedArrayElements();
1809   inline bool HasFixedInt8Elements();
1810   inline bool HasFixedUint8Elements();
1811   inline bool HasFixedInt16Elements();
1812   inline bool HasFixedUint16Elements();
1813   inline bool HasFixedInt32Elements();
1814   inline bool HasFixedUint32Elements();
1815   inline bool HasFixedFloat32Elements();
1816   inline bool HasFixedFloat64Elements();
1817
1818   inline bool HasFastArgumentsElements();
1819   inline bool HasSlowArgumentsElements();
1820   inline SeededNumberDictionary* element_dictionary();  // Gets slow elements.
1821
1822   // Requires: HasFastElements().
1823   static Handle<FixedArray> EnsureWritableFastElements(
1824       Handle<JSObject> object);
1825
1826   // Collects elements starting at index 0.
1827   // Undefined values are placed after non-undefined values.
1828   // Returns the number of non-undefined values.
1829   static Handle<Object> PrepareElementsForSort(Handle<JSObject> object,
1830                                                uint32_t limit);
1831   // As PrepareElementsForSort, but only on objects where elements is
1832   // a dictionary, and it will stay a dictionary.  Collates undefined and
1833   // unexisting elements below limit from position zero of the elements.
1834   static Handle<Object> PrepareSlowElementsForSort(Handle<JSObject> object,
1835                                                    uint32_t limit);
1836
1837   MUST_USE_RESULT static MaybeHandle<Object> SetPropertyWithInterceptor(
1838       LookupIterator* it, Handle<Object> value);
1839
1840   // SetLocalPropertyIgnoreAttributes converts callbacks to fields. We need to
1841   // grant an exemption to ExecutableAccessor callbacks in some cases.
1842   enum ExecutableAccessorInfoHandling { DEFAULT_HANDLING, DONT_FORCE_FIELD };
1843
1844   MUST_USE_RESULT static MaybeHandle<Object> DefineOwnPropertyIgnoreAttributes(
1845       LookupIterator* it, Handle<Object> value, PropertyAttributes attributes,
1846       ExecutableAccessorInfoHandling handling = DEFAULT_HANDLING);
1847
1848   MUST_USE_RESULT static MaybeHandle<Object> SetOwnPropertyIgnoreAttributes(
1849       Handle<JSObject> object, Handle<Name> name, Handle<Object> value,
1850       PropertyAttributes attributes,
1851       ExecutableAccessorInfoHandling handling = DEFAULT_HANDLING);
1852
1853   MUST_USE_RESULT static MaybeHandle<Object> SetOwnElementIgnoreAttributes(
1854       Handle<JSObject> object, uint32_t index, Handle<Object> value,
1855       PropertyAttributes attributes,
1856       ExecutableAccessorInfoHandling handling = DEFAULT_HANDLING);
1857
1858   // Equivalent to one of the above depending on whether |name| can be converted
1859   // to an array index.
1860   MUST_USE_RESULT static MaybeHandle<Object>
1861   DefinePropertyOrElementIgnoreAttributes(
1862       Handle<JSObject> object, Handle<Name> name, Handle<Object> value,
1863       PropertyAttributes attributes = NONE,
1864       ExecutableAccessorInfoHandling handling = DEFAULT_HANDLING);
1865
1866   // Adds or reconfigures a property to attributes NONE. It will fail when it
1867   // cannot.
1868   MUST_USE_RESULT static Maybe<bool> CreateDataProperty(LookupIterator* it,
1869                                                         Handle<Object> value);
1870
1871   static void AddProperty(Handle<JSObject> object, Handle<Name> name,
1872                           Handle<Object> value, PropertyAttributes attributes);
1873
1874   MUST_USE_RESULT static MaybeHandle<Object> AddDataElement(
1875       Handle<JSObject> receiver, uint32_t index, Handle<Object> value,
1876       PropertyAttributes attributes);
1877
1878   // Extend the receiver with a single fast property appeared first in the
1879   // passed map. This also extends the property backing store if necessary.
1880   static void AllocateStorageForMap(Handle<JSObject> object, Handle<Map> map);
1881
1882   // Migrates the given object to a map whose field representations are the
1883   // lowest upper bound of all known representations for that field.
1884   static void MigrateInstance(Handle<JSObject> instance);
1885
1886   // Migrates the given object only if the target map is already available,
1887   // or returns false if such a map is not yet available.
1888   static bool TryMigrateInstance(Handle<JSObject> instance);
1889
1890   // Sets the property value in a normalized object given (key, value, details).
1891   // Handles the special representation of JS global objects.
1892   static void SetNormalizedProperty(Handle<JSObject> object, Handle<Name> name,
1893                                     Handle<Object> value,
1894                                     PropertyDetails details);
1895   static void SetDictionaryElement(Handle<JSObject> object, uint32_t index,
1896                                    Handle<Object> value,
1897                                    PropertyAttributes attributes);
1898   static void SetDictionaryArgumentsElement(Handle<JSObject> object,
1899                                             uint32_t index,
1900                                             Handle<Object> value,
1901                                             PropertyAttributes attributes);
1902
1903   static void OptimizeAsPrototype(Handle<JSObject> object,
1904                                   PrototypeOptimizationMode mode);
1905   static void ReoptimizeIfPrototype(Handle<JSObject> object);
1906   static void LazyRegisterPrototypeUser(Handle<Map> user, Isolate* isolate);
1907   static bool RegisterPrototypeUserIfNotRegistered(Handle<JSObject> prototype,
1908                                                    Handle<HeapObject> user,
1909                                                    Isolate* isolate);
1910   static bool UnregisterPrototypeUser(Handle<JSObject> prototype,
1911                                       Handle<HeapObject> user);
1912   static void InvalidatePrototypeChains(Map* map);
1913
1914   // Retrieve interceptors.
1915   InterceptorInfo* GetNamedInterceptor();
1916   InterceptorInfo* GetIndexedInterceptor();
1917
1918   // Used from JSReceiver.
1919   MUST_USE_RESULT static Maybe<PropertyAttributes>
1920   GetPropertyAttributesWithInterceptor(LookupIterator* it);
1921   MUST_USE_RESULT static Maybe<PropertyAttributes>
1922       GetPropertyAttributesWithFailedAccessCheck(LookupIterator* it);
1923
1924   // Retrieves an AccessorPair property from the given object. Might return
1925   // undefined if the property doesn't exist or is of a different kind.
1926   MUST_USE_RESULT static MaybeHandle<Object> GetAccessor(
1927       Handle<JSObject> object,
1928       Handle<Name> name,
1929       AccessorComponent component);
1930
1931   // Defines an AccessorPair property on the given object.
1932   // TODO(mstarzinger): Rename to SetAccessor().
1933   static MaybeHandle<Object> DefineAccessor(Handle<JSObject> object,
1934                                             Handle<Name> name,
1935                                             Handle<Object> getter,
1936                                             Handle<Object> setter,
1937                                             PropertyAttributes attributes);
1938
1939   // Defines an AccessorInfo property on the given object.
1940   MUST_USE_RESULT static MaybeHandle<Object> SetAccessor(
1941       Handle<JSObject> object,
1942       Handle<AccessorInfo> info);
1943
1944   // The result must be checked first for exceptions. If there's no exception,
1945   // the output parameter |done| indicates whether the interceptor has a result
1946   // or not.
1947   MUST_USE_RESULT static MaybeHandle<Object> GetPropertyWithInterceptor(
1948       LookupIterator* it, bool* done);
1949
1950   // Accessors for hidden properties object.
1951   //
1952   // Hidden properties are not own properties of the object itself.
1953   // Instead they are stored in an auxiliary structure kept as an own
1954   // property with a special name Heap::hidden_string(). But if the
1955   // receiver is a JSGlobalProxy then the auxiliary object is a property
1956   // of its prototype, and if it's a detached proxy, then you can't have
1957   // hidden properties.
1958
1959   // Sets a hidden property on this object. Returns this object if successful,
1960   // undefined if called on a detached proxy.
1961   static Handle<Object> SetHiddenProperty(Handle<JSObject> object,
1962                                           Handle<Name> key,
1963                                           Handle<Object> value);
1964   // Gets the value of a hidden property with the given key. Returns the hole
1965   // if the property doesn't exist (or if called on a detached proxy),
1966   // otherwise returns the value set for the key.
1967   Object* GetHiddenProperty(Handle<Name> key);
1968   // Deletes a hidden property. Deleting a non-existing property is
1969   // considered successful.
1970   static void DeleteHiddenProperty(Handle<JSObject> object,
1971                                    Handle<Name> key);
1972   // Returns true if the object has a property with the hidden string as name.
1973   static bool HasHiddenProperties(Handle<JSObject> object);
1974
1975   static void SetIdentityHash(Handle<JSObject> object, Handle<Smi> hash);
1976
1977   static void ValidateElements(Handle<JSObject> object);
1978
1979   // Makes sure that this object can contain HeapObject as elements.
1980   static inline void EnsureCanContainHeapObjectElements(Handle<JSObject> obj);
1981
1982   // Makes sure that this object can contain the specified elements.
1983   static inline void EnsureCanContainElements(
1984       Handle<JSObject> object,
1985       Object** elements,
1986       uint32_t count,
1987       EnsureElementsMode mode);
1988   static inline void EnsureCanContainElements(
1989       Handle<JSObject> object,
1990       Handle<FixedArrayBase> elements,
1991       uint32_t length,
1992       EnsureElementsMode mode);
1993   static void EnsureCanContainElements(
1994       Handle<JSObject> object,
1995       Arguments* arguments,
1996       uint32_t first_arg,
1997       uint32_t arg_count,
1998       EnsureElementsMode mode);
1999
2000   // Would we convert a fast elements array to dictionary mode given
2001   // an access at key?
2002   bool WouldConvertToSlowElements(uint32_t index);
2003
2004   // Computes the new capacity when expanding the elements of a JSObject.
2005   static uint32_t NewElementsCapacity(uint32_t old_capacity) {
2006     // (old_capacity + 50%) + 16
2007     return old_capacity + (old_capacity >> 1) + 16;
2008   }
2009
2010   // These methods do not perform access checks!
2011   static void UpdateAllocationSite(Handle<JSObject> object,
2012                                    ElementsKind to_kind);
2013
2014   // Lookup interceptors are used for handling properties controlled by host
2015   // objects.
2016   inline bool HasNamedInterceptor();
2017   inline bool HasIndexedInterceptor();
2018
2019   // Computes the enumerable keys from interceptors. Used for debug mirrors and
2020   // by JSReceiver::GetKeys.
2021   MUST_USE_RESULT static MaybeHandle<JSObject> GetKeysForNamedInterceptor(
2022       Handle<JSObject> object,
2023       Handle<JSReceiver> receiver);
2024   MUST_USE_RESULT static MaybeHandle<JSObject> GetKeysForIndexedInterceptor(
2025       Handle<JSObject> object,
2026       Handle<JSReceiver> receiver);
2027
2028   // Support functions for v8 api (needed for correct interceptor behavior).
2029   MUST_USE_RESULT static Maybe<bool> HasRealNamedProperty(
2030       Handle<JSObject> object, Handle<Name> name);
2031   MUST_USE_RESULT static Maybe<bool> HasRealElementProperty(
2032       Handle<JSObject> object, uint32_t index);
2033   MUST_USE_RESULT static Maybe<bool> HasRealNamedCallbackProperty(
2034       Handle<JSObject> object, Handle<Name> name);
2035
2036   // Get the header size for a JSObject.  Used to compute the index of
2037   // internal fields as well as the number of internal fields.
2038   inline int GetHeaderSize();
2039
2040   inline int GetInternalFieldCount();
2041   inline int GetInternalFieldOffset(int index);
2042   inline Object* GetInternalField(int index);
2043   inline void SetInternalField(int index, Object* value);
2044   inline void SetInternalField(int index, Smi* value);
2045
2046   // Returns the number of properties on this object filtering out properties
2047   // with the specified attributes (ignoring interceptors).
2048   int NumberOfOwnProperties(PropertyAttributes filter = NONE);
2049   // Fill in details for properties into storage starting at the specified
2050   // index. Returns the number of properties added.
2051   int GetOwnPropertyNames(FixedArray* storage, int index,
2052                           PropertyAttributes filter = NONE);
2053
2054   // Returns the number of properties on this object filtering out properties
2055   // with the specified attributes (ignoring interceptors).
2056   int NumberOfOwnElements(PropertyAttributes filter);
2057   // Returns the number of enumerable elements (ignoring interceptors).
2058   int NumberOfEnumElements();
2059   // Returns the number of elements on this object filtering out elements
2060   // with the specified attributes (ignoring interceptors).
2061   int GetOwnElementKeys(FixedArray* storage, PropertyAttributes filter);
2062   // Count and fill in the enumerable elements into storage.
2063   // (storage->length() == NumberOfEnumElements()).
2064   // If storage is NULL, will count the elements without adding
2065   // them to any storage.
2066   // Returns the number of enumerable elements.
2067   int GetEnumElementKeys(FixedArray* storage);
2068
2069   static Handle<FixedArray> GetEnumPropertyKeys(Handle<JSObject> object,
2070                                                 bool cache_result);
2071
2072   // Returns a new map with all transitions dropped from the object's current
2073   // map and the ElementsKind set.
2074   static Handle<Map> GetElementsTransitionMap(Handle<JSObject> object,
2075                                               ElementsKind to_kind);
2076   static void TransitionElementsKind(Handle<JSObject> object,
2077                                      ElementsKind to_kind);
2078
2079   // Always use this to migrate an object to a new map.
2080   // |expected_additional_properties| is only used for fast-to-slow transitions
2081   // and ignored otherwise.
2082   static void MigrateToMap(Handle<JSObject> object, Handle<Map> new_map,
2083                            int expected_additional_properties = 0);
2084
2085   // Convert the object to use the canonical dictionary
2086   // representation. If the object is expected to have additional properties
2087   // added this number can be indicated to have the backing store allocated to
2088   // an initial capacity for holding these properties.
2089   static void NormalizeProperties(Handle<JSObject> object,
2090                                   PropertyNormalizationMode mode,
2091                                   int expected_additional_properties,
2092                                   const char* reason);
2093
2094   // Convert and update the elements backing store to be a
2095   // SeededNumberDictionary dictionary.  Returns the backing after conversion.
2096   static Handle<SeededNumberDictionary> NormalizeElements(
2097       Handle<JSObject> object);
2098
2099   void RequireSlowElements(SeededNumberDictionary* dictionary);
2100
2101   // Transform slow named properties to fast variants.
2102   static void MigrateSlowToFast(Handle<JSObject> object,
2103                                 int unused_property_fields, const char* reason);
2104
2105   inline bool IsUnboxedDoubleField(FieldIndex index);
2106
2107   // Access fast-case object properties at index.
2108   static Handle<Object> FastPropertyAt(Handle<JSObject> object,
2109                                        Representation representation,
2110                                        FieldIndex index);
2111   inline Object* RawFastPropertyAt(FieldIndex index);
2112   inline double RawFastDoublePropertyAt(FieldIndex index);
2113
2114   inline void FastPropertyAtPut(FieldIndex index, Object* value);
2115   inline void RawFastPropertyAtPut(FieldIndex index, Object* value);
2116   inline void RawFastDoublePropertyAtPut(FieldIndex index, double value);
2117   inline void WriteToField(int descriptor, Object* value);
2118
2119   // Access to in object properties.
2120   inline int GetInObjectPropertyOffset(int index);
2121   inline Object* InObjectPropertyAt(int index);
2122   inline Object* InObjectPropertyAtPut(int index,
2123                                        Object* value,
2124                                        WriteBarrierMode mode
2125                                        = UPDATE_WRITE_BARRIER);
2126
2127   // Set the object's prototype (only JSReceiver and null are allowed values).
2128   MUST_USE_RESULT static MaybeHandle<Object> SetPrototype(
2129       Handle<JSObject> object, Handle<Object> value, bool from_javascript);
2130
2131   // Initializes the body after properties slot, properties slot is
2132   // initialized by set_properties.  Fill the pre-allocated fields with
2133   // pre_allocated_value and the rest with filler_value.
2134   // Note: this call does not update write barrier, the caller is responsible
2135   // to ensure that |filler_value| can be collected without WB here.
2136   inline void InitializeBody(Map* map,
2137                              Object* pre_allocated_value,
2138                              Object* filler_value);
2139
2140   // Check whether this object references another object
2141   bool ReferencesObject(Object* obj);
2142
2143   // Disalow further properties to be added to the oject.
2144   MUST_USE_RESULT static MaybeHandle<Object> PreventExtensions(
2145       Handle<JSObject> object);
2146
2147   bool IsExtensible();
2148
2149   // ES5 Object.seal
2150   MUST_USE_RESULT static MaybeHandle<Object> Seal(Handle<JSObject> object);
2151
2152   // ES5 Object.freeze
2153   MUST_USE_RESULT static MaybeHandle<Object> Freeze(Handle<JSObject> object);
2154
2155   // Called the first time an object is observed with ES7 Object.observe.
2156   static void SetObserved(Handle<JSObject> object);
2157
2158   // Copy object.
2159   enum DeepCopyHints { kNoHints = 0, kObjectIsShallow = 1 };
2160
2161   MUST_USE_RESULT static MaybeHandle<JSObject> DeepCopy(
2162       Handle<JSObject> object,
2163       AllocationSiteUsageContext* site_context,
2164       DeepCopyHints hints = kNoHints);
2165   MUST_USE_RESULT static MaybeHandle<JSObject> DeepWalk(
2166       Handle<JSObject> object,
2167       AllocationSiteCreationContext* site_context);
2168
2169   DECLARE_CAST(JSObject)
2170
2171   // Dispatched behavior.
2172   void JSObjectShortPrint(StringStream* accumulator);
2173   DECLARE_PRINTER(JSObject)
2174   DECLARE_VERIFIER(JSObject)
2175 #ifdef OBJECT_PRINT
2176   void PrintProperties(std::ostream& os);   // NOLINT
2177   void PrintElements(std::ostream& os);     // NOLINT
2178 #endif
2179 #if defined(DEBUG) || defined(OBJECT_PRINT)
2180   void PrintTransitions(std::ostream& os);  // NOLINT
2181 #endif
2182
2183   static void PrintElementsTransition(
2184       FILE* file, Handle<JSObject> object,
2185       ElementsKind from_kind, Handle<FixedArrayBase> from_elements,
2186       ElementsKind to_kind, Handle<FixedArrayBase> to_elements);
2187
2188   void PrintInstanceMigration(FILE* file, Map* original_map, Map* new_map);
2189
2190 #ifdef DEBUG
2191   // Structure for collecting spill information about JSObjects.
2192   class SpillInformation {
2193    public:
2194     void Clear();
2195     void Print();
2196     int number_of_objects_;
2197     int number_of_objects_with_fast_properties_;
2198     int number_of_objects_with_fast_elements_;
2199     int number_of_fast_used_fields_;
2200     int number_of_fast_unused_fields_;
2201     int number_of_slow_used_properties_;
2202     int number_of_slow_unused_properties_;
2203     int number_of_fast_used_elements_;
2204     int number_of_fast_unused_elements_;
2205     int number_of_slow_used_elements_;
2206     int number_of_slow_unused_elements_;
2207   };
2208
2209   void IncrementSpillStatistics(SpillInformation* info);
2210 #endif
2211
2212 #ifdef VERIFY_HEAP
2213   // If a GC was caused while constructing this object, the elements pointer
2214   // may point to a one pointer filler map. The object won't be rooted, but
2215   // our heap verification code could stumble across it.
2216   bool ElementsAreSafeToExamine();
2217 #endif
2218
2219   Object* SlowReverseLookup(Object* value);
2220
2221   // Maximal number of elements (numbered 0 .. kMaxElementCount - 1).
2222   // Also maximal value of JSArray's length property.
2223   static const uint32_t kMaxElementCount = 0xffffffffu;
2224
2225   // Constants for heuristics controlling conversion of fast elements
2226   // to slow elements.
2227
2228   // Maximal gap that can be introduced by adding an element beyond
2229   // the current elements length.
2230   static const uint32_t kMaxGap = 1024;
2231
2232   // Maximal length of fast elements array that won't be checked for
2233   // being dense enough on expansion.
2234   static const int kMaxUncheckedFastElementsLength = 5000;
2235
2236   // Same as above but for old arrays. This limit is more strict. We
2237   // don't want to be wasteful with long lived objects.
2238   static const int kMaxUncheckedOldFastElementsLength = 500;
2239
2240   // Note that Page::kMaxRegularHeapObjectSize puts a limit on
2241   // permissible values (see the DCHECK in heap.cc).
2242   static const int kInitialMaxFastElementArray = 100000;
2243
2244   // This constant applies only to the initial map of "global.Object" and
2245   // not to arbitrary other JSObject maps.
2246   static const int kInitialGlobalObjectUnusedPropertiesCount = 4;
2247
2248   static const int kMaxInstanceSize = 255 * kPointerSize;
2249   // When extending the backing storage for property values, we increase
2250   // its size by more than the 1 entry necessary, so sequentially adding fields
2251   // to the same object requires fewer allocations and copies.
2252   static const int kFieldsAdded = 3;
2253
2254   // Layout description.
2255   static const int kPropertiesOffset = HeapObject::kHeaderSize;
2256   static const int kElementsOffset = kPropertiesOffset + kPointerSize;
2257   static const int kHeaderSize = kElementsOffset + kPointerSize;
2258
2259   STATIC_ASSERT(kHeaderSize == Internals::kJSObjectHeaderSize);
2260
2261   class BodyDescriptor : public FlexibleBodyDescriptor<kPropertiesOffset> {
2262    public:
2263     static inline int SizeOf(Map* map, HeapObject* object);
2264   };
2265
2266   Context* GetCreationContext();
2267
2268   // Enqueue change record for Object.observe. May cause GC.
2269   MUST_USE_RESULT static MaybeHandle<Object> EnqueueChangeRecord(
2270       Handle<JSObject> object, const char* type, Handle<Name> name,
2271       Handle<Object> old_value);
2272
2273   // Gets the number of currently used elements.
2274   int GetFastElementsUsage();
2275
2276   // Deletes an existing named property in a normalized object.
2277   static void DeleteNormalizedProperty(Handle<JSObject> object,
2278                                        Handle<Name> name, int entry);
2279
2280   static bool AllCanRead(LookupIterator* it);
2281   static bool AllCanWrite(LookupIterator* it);
2282
2283  private:
2284   friend class JSReceiver;
2285   friend class Object;
2286
2287   static void MigrateFastToFast(Handle<JSObject> object, Handle<Map> new_map);
2288   static void MigrateFastToSlow(Handle<JSObject> object,
2289                                 Handle<Map> new_map,
2290                                 int expected_additional_properties);
2291
2292   // Used from Object::GetProperty().
2293   MUST_USE_RESULT static MaybeHandle<Object> GetPropertyWithFailedAccessCheck(
2294       LookupIterator* it);
2295
2296   MUST_USE_RESULT static MaybeHandle<Object> SetPropertyWithFailedAccessCheck(
2297       LookupIterator* it, Handle<Object> value);
2298
2299   // Add a property to a slow-case object.
2300   static void AddSlowProperty(Handle<JSObject> object,
2301                               Handle<Name> name,
2302                               Handle<Object> value,
2303                               PropertyAttributes attributes);
2304
2305   MUST_USE_RESULT static MaybeHandle<Object> DeletePropertyWithInterceptor(
2306       LookupIterator* it);
2307
2308   bool ReferencesObjectFromElements(FixedArray* elements,
2309                                     ElementsKind kind,
2310                                     Object* object);
2311
2312   // Return the hash table backing store or the inline stored identity hash,
2313   // whatever is found.
2314   MUST_USE_RESULT Object* GetHiddenPropertiesHashTable();
2315
2316   // Return the hash table backing store for hidden properties.  If there is no
2317   // backing store, allocate one.
2318   static Handle<ObjectHashTable> GetOrCreateHiddenPropertiesHashtable(
2319       Handle<JSObject> object);
2320
2321   // Set the hidden property backing store to either a hash table or
2322   // the inline-stored identity hash.
2323   static Handle<Object> SetHiddenPropertiesHashTable(
2324       Handle<JSObject> object,
2325       Handle<Object> value);
2326
2327   MUST_USE_RESULT Object* GetIdentityHash();
2328
2329   static Handle<Smi> GetOrCreateIdentityHash(Handle<JSObject> object);
2330
2331   static Handle<SeededNumberDictionary> GetNormalizedElementDictionary(
2332       Handle<JSObject> object, Handle<FixedArrayBase> elements);
2333
2334   // Helper for fast versions of preventExtensions, seal, and freeze.
2335   // attrs is one of NONE, SEALED, or FROZEN (depending on the operation).
2336   template <PropertyAttributes attrs>
2337   MUST_USE_RESULT static MaybeHandle<Object> PreventExtensionsWithTransition(
2338       Handle<JSObject> object);
2339
2340   DISALLOW_IMPLICIT_CONSTRUCTORS(JSObject);
2341 };
2342
2343
2344 // Common superclass for FixedArrays that allow implementations to share
2345 // common accessors and some code paths.
2346 class FixedArrayBase: public HeapObject {
2347  public:
2348   // [length]: length of the array.
2349   inline int length() const;
2350   inline void set_length(int value);
2351
2352   // Get and set the length using acquire loads and release stores.
2353   inline int synchronized_length() const;
2354   inline void synchronized_set_length(int value);
2355
2356   DECLARE_CAST(FixedArrayBase)
2357
2358   // Layout description.
2359   // Length is smi tagged when it is stored.
2360   static const int kLengthOffset = HeapObject::kHeaderSize;
2361   static const int kHeaderSize = kLengthOffset + kPointerSize;
2362 };
2363
2364
2365 class FixedDoubleArray;
2366 class IncrementalMarking;
2367
2368
2369 // FixedArray describes fixed-sized arrays with element type Object*.
2370 class FixedArray: public FixedArrayBase {
2371  public:
2372   // Setter and getter for elements.
2373   inline Object* get(int index) const;
2374   void SetValue(uint32_t index, Object* value);
2375   static inline Handle<Object> get(Handle<FixedArray> array, int index);
2376   // Setter that uses write barrier.
2377   inline void set(int index, Object* value);
2378   inline bool is_the_hole(int index);
2379
2380   // Setter that doesn't need write barrier.
2381   inline void set(int index, Smi* value);
2382   // Setter with explicit barrier mode.
2383   inline void set(int index, Object* value, WriteBarrierMode mode);
2384
2385   // Setters for frequently used oddballs located in old space.
2386   inline void set_undefined(int index);
2387   inline void set_null(int index);
2388   inline void set_the_hole(int index);
2389
2390   inline Object** GetFirstElementAddress();
2391   inline bool ContainsOnlySmisOrHoles();
2392
2393   // Gives access to raw memory which stores the array's data.
2394   inline Object** data_start();
2395
2396   inline void FillWithHoles(int from, int to);
2397
2398   // Shrink length and insert filler objects.
2399   void Shrink(int length);
2400
2401   // Copy operation.
2402   static Handle<FixedArray> CopySize(Handle<FixedArray> array,
2403                                      int new_length,
2404                                      PretenureFlag pretenure = NOT_TENURED);
2405
2406   enum KeyFilter { ALL_KEYS, NON_SYMBOL_KEYS };
2407
2408   // Add the elements of a JSArray to this FixedArray.
2409   MUST_USE_RESULT static MaybeHandle<FixedArray> AddKeysFromArrayLike(
2410       Handle<FixedArray> content, Handle<JSObject> array,
2411       KeyFilter filter = ALL_KEYS);
2412
2413   // Computes the union of keys and return the result.
2414   // Used for implementing "for (n in object) { }"
2415   MUST_USE_RESULT static MaybeHandle<FixedArray> UnionOfKeys(
2416       Handle<FixedArray> first,
2417       Handle<FixedArray> second);
2418
2419   // Copy a sub array from the receiver to dest.
2420   void CopyTo(int pos, FixedArray* dest, int dest_pos, int len);
2421
2422   // Garbage collection support.
2423   static int SizeFor(int length) { return kHeaderSize + length * kPointerSize; }
2424
2425   // Code Generation support.
2426   static int OffsetOfElementAt(int index) { return SizeFor(index); }
2427
2428   // Garbage collection support.
2429   Object** RawFieldOfElementAt(int index) {
2430     return HeapObject::RawField(this, OffsetOfElementAt(index));
2431   }
2432
2433   DECLARE_CAST(FixedArray)
2434
2435   // Maximal allowed size, in bytes, of a single FixedArray.
2436   // Prevents overflowing size computations, as well as extreme memory
2437   // consumption.
2438   static const int kMaxSize = 128 * MB * kPointerSize;
2439   // Maximally allowed length of a FixedArray.
2440   static const int kMaxLength = (kMaxSize - kHeaderSize) / kPointerSize;
2441
2442   // Dispatched behavior.
2443   DECLARE_PRINTER(FixedArray)
2444   DECLARE_VERIFIER(FixedArray)
2445 #ifdef DEBUG
2446   // Checks if two FixedArrays have identical contents.
2447   bool IsEqualTo(FixedArray* other);
2448 #endif
2449
2450   // Swap two elements in a pair of arrays.  If this array and the
2451   // numbers array are the same object, the elements are only swapped
2452   // once.
2453   void SwapPairs(FixedArray* numbers, int i, int j);
2454
2455   // Sort prefix of this array and the numbers array as pairs wrt. the
2456   // numbers.  If the numbers array and the this array are the same
2457   // object, the prefix of this array is sorted.
2458   void SortPairs(FixedArray* numbers, uint32_t len);
2459
2460   class BodyDescriptor : public FlexibleBodyDescriptor<kHeaderSize> {
2461    public:
2462     static inline int SizeOf(Map* map, HeapObject* object) {
2463       return SizeFor(
2464           reinterpret_cast<FixedArray*>(object)->synchronized_length());
2465     }
2466   };
2467
2468  protected:
2469   // Set operation on FixedArray without using write barriers. Can
2470   // only be used for storing old space objects or smis.
2471   static inline void NoWriteBarrierSet(FixedArray* array,
2472                                        int index,
2473                                        Object* value);
2474
2475   // Set operation on FixedArray without incremental write barrier. Can
2476   // only be used if the object is guaranteed to be white (whiteness witness
2477   // is present).
2478   static inline void NoIncrementalWriteBarrierSet(FixedArray* array,
2479                                                   int index,
2480                                                   Object* value);
2481
2482  private:
2483   STATIC_ASSERT(kHeaderSize == Internals::kFixedArrayHeaderSize);
2484
2485   DISALLOW_IMPLICIT_CONSTRUCTORS(FixedArray);
2486 };
2487
2488
2489 // FixedDoubleArray describes fixed-sized arrays with element type double.
2490 class FixedDoubleArray: public FixedArrayBase {
2491  public:
2492   // Setter and getter for elements.
2493   inline double get_scalar(int index);
2494   inline uint64_t get_representation(int index);
2495   static inline Handle<Object> get(Handle<FixedDoubleArray> array, int index);
2496   // This accessor has to get a Number as |value|.
2497   void SetValue(uint32_t index, Object* value);
2498   inline void set(int index, double value);
2499   inline void set_the_hole(int index);
2500
2501   // Checking for the hole.
2502   inline bool is_the_hole(int index);
2503
2504   // Garbage collection support.
2505   inline static int SizeFor(int length) {
2506     return kHeaderSize + length * kDoubleSize;
2507   }
2508
2509   // Gives access to raw memory which stores the array's data.
2510   inline double* data_start();
2511
2512   inline void FillWithHoles(int from, int to);
2513
2514   // Code Generation support.
2515   static int OffsetOfElementAt(int index) { return SizeFor(index); }
2516
2517   DECLARE_CAST(FixedDoubleArray)
2518
2519   // Maximal allowed size, in bytes, of a single FixedDoubleArray.
2520   // Prevents overflowing size computations, as well as extreme memory
2521   // consumption.
2522   static const int kMaxSize = 512 * MB;
2523   // Maximally allowed length of a FixedArray.
2524   static const int kMaxLength = (kMaxSize - kHeaderSize) / kDoubleSize;
2525
2526   // Dispatched behavior.
2527   DECLARE_PRINTER(FixedDoubleArray)
2528   DECLARE_VERIFIER(FixedDoubleArray)
2529
2530  private:
2531   DISALLOW_IMPLICIT_CONSTRUCTORS(FixedDoubleArray);
2532 };
2533
2534
2535 class WeakFixedArray : public FixedArray {
2536  public:
2537   enum SearchForDuplicates { kAlwaysAdd, kAddIfNotFound };
2538
2539   // If |maybe_array| is not a WeakFixedArray, a fresh one will be allocated.
2540   static Handle<WeakFixedArray> Add(
2541       Handle<Object> maybe_array, Handle<HeapObject> value,
2542       SearchForDuplicates search_for_duplicates = kAlwaysAdd,
2543       bool* was_present = NULL);
2544
2545   // Returns true if an entry was found and removed.
2546   bool Remove(Handle<HeapObject> value);
2547
2548   void Compact();
2549
2550   inline Object* Get(int index) const;
2551   inline void Clear(int index);
2552   inline int Length() const;
2553
2554   inline bool IsEmptySlot(int index) const;
2555   static Object* Empty() { return Smi::FromInt(0); }
2556
2557   DECLARE_CAST(WeakFixedArray)
2558
2559  private:
2560   static const int kLastUsedIndexIndex = 0;
2561   static const int kFirstIndex = 1;
2562
2563   static Handle<WeakFixedArray> Allocate(
2564       Isolate* isolate, int size, Handle<WeakFixedArray> initialize_from);
2565
2566   static void Set(Handle<WeakFixedArray> array, int index,
2567                   Handle<HeapObject> value);
2568   inline void clear(int index);
2569
2570   inline int last_used_index() const;
2571   inline void set_last_used_index(int index);
2572
2573   // Disallow inherited setters.
2574   void set(int index, Smi* value);
2575   void set(int index, Object* value);
2576   void set(int index, Object* value, WriteBarrierMode mode);
2577   DISALLOW_IMPLICIT_CONSTRUCTORS(WeakFixedArray);
2578 };
2579
2580
2581 // Generic array grows dynamically with O(1) amortized insertion.
2582 class ArrayList : public FixedArray {
2583  public:
2584   enum AddMode {
2585     kNone,
2586     // Use this if GC can delete elements from the array.
2587     kReloadLengthAfterAllocation,
2588   };
2589   static Handle<ArrayList> Add(Handle<ArrayList> array, Handle<Object> obj,
2590                                AddMode mode = kNone);
2591   static Handle<ArrayList> Add(Handle<ArrayList> array, Handle<Object> obj1,
2592                                Handle<Object> obj2, AddMode = kNone);
2593   inline int Length();
2594   inline void SetLength(int length);
2595   inline Object* Get(int index);
2596   inline Object** Slot(int index);
2597   inline void Set(int index, Object* obj);
2598   inline void Clear(int index, Object* undefined);
2599   DECLARE_CAST(ArrayList)
2600
2601  private:
2602   static Handle<ArrayList> EnsureSpace(Handle<ArrayList> array, int length);
2603   static const int kLengthIndex = 0;
2604   static const int kFirstIndex = 1;
2605   DISALLOW_IMPLICIT_CONSTRUCTORS(ArrayList);
2606 };
2607
2608
2609 // DescriptorArrays are fixed arrays used to hold instance descriptors.
2610 // The format of the these objects is:
2611 //   [0]: Number of descriptors
2612 //   [1]: Either Smi(0) if uninitialized, or a pointer to small fixed array:
2613 //          [0]: pointer to fixed array with enum cache
2614 //          [1]: either Smi(0) or pointer to fixed array with indices
2615 //   [2]: first key
2616 //   [2 + number of descriptors * kDescriptorSize]: start of slack
2617 class DescriptorArray: public FixedArray {
2618  public:
2619   // Returns true for both shared empty_descriptor_array and for smis, which the
2620   // map uses to encode additional bit fields when the descriptor array is not
2621   // yet used.
2622   inline bool IsEmpty();
2623
2624   // Returns the number of descriptors in the array.
2625   int number_of_descriptors() {
2626     DCHECK(length() >= kFirstIndex || IsEmpty());
2627     int len = length();
2628     return len == 0 ? 0 : Smi::cast(get(kDescriptorLengthIndex))->value();
2629   }
2630
2631   int number_of_descriptors_storage() {
2632     int len = length();
2633     return len == 0 ? 0 : (len - kFirstIndex) / kDescriptorSize;
2634   }
2635
2636   int NumberOfSlackDescriptors() {
2637     return number_of_descriptors_storage() - number_of_descriptors();
2638   }
2639
2640   inline void SetNumberOfDescriptors(int number_of_descriptors);
2641   inline int number_of_entries() { return number_of_descriptors(); }
2642
2643   bool HasEnumCache() {
2644     return !IsEmpty() && !get(kEnumCacheIndex)->IsSmi();
2645   }
2646
2647   void CopyEnumCacheFrom(DescriptorArray* array) {
2648     set(kEnumCacheIndex, array->get(kEnumCacheIndex));
2649   }
2650
2651   FixedArray* GetEnumCache() {
2652     DCHECK(HasEnumCache());
2653     FixedArray* bridge = FixedArray::cast(get(kEnumCacheIndex));
2654     return FixedArray::cast(bridge->get(kEnumCacheBridgeCacheIndex));
2655   }
2656
2657   bool HasEnumIndicesCache() {
2658     if (IsEmpty()) return false;
2659     Object* object = get(kEnumCacheIndex);
2660     if (object->IsSmi()) return false;
2661     FixedArray* bridge = FixedArray::cast(object);
2662     return !bridge->get(kEnumCacheBridgeIndicesCacheIndex)->IsSmi();
2663   }
2664
2665   FixedArray* GetEnumIndicesCache() {
2666     DCHECK(HasEnumIndicesCache());
2667     FixedArray* bridge = FixedArray::cast(get(kEnumCacheIndex));
2668     return FixedArray::cast(bridge->get(kEnumCacheBridgeIndicesCacheIndex));
2669   }
2670
2671   Object** GetEnumCacheSlot() {
2672     DCHECK(HasEnumCache());
2673     return HeapObject::RawField(reinterpret_cast<HeapObject*>(this),
2674                                 kEnumCacheOffset);
2675   }
2676
2677   void ClearEnumCache();
2678
2679   // Initialize or change the enum cache,
2680   // using the supplied storage for the small "bridge".
2681   void SetEnumCache(FixedArray* bridge_storage,
2682                     FixedArray* new_cache,
2683                     Object* new_index_cache);
2684
2685   bool CanHoldValue(int descriptor, Object* value);
2686
2687   // Accessors for fetching instance descriptor at descriptor number.
2688   inline Name* GetKey(int descriptor_number);
2689   inline Object** GetKeySlot(int descriptor_number);
2690   inline Object* GetValue(int descriptor_number);
2691   inline void SetValue(int descriptor_number, Object* value);
2692   inline Object** GetValueSlot(int descriptor_number);
2693   static inline int GetValueOffset(int descriptor_number);
2694   inline Object** GetDescriptorStartSlot(int descriptor_number);
2695   inline Object** GetDescriptorEndSlot(int descriptor_number);
2696   inline PropertyDetails GetDetails(int descriptor_number);
2697   inline PropertyType GetType(int descriptor_number);
2698   inline int GetFieldIndex(int descriptor_number);
2699   inline HeapType* GetFieldType(int descriptor_number);
2700   inline Object* GetConstant(int descriptor_number);
2701   inline Object* GetCallbacksObject(int descriptor_number);
2702   inline AccessorDescriptor* GetCallbacks(int descriptor_number);
2703
2704   inline Name* GetSortedKey(int descriptor_number);
2705   inline int GetSortedKeyIndex(int descriptor_number);
2706   inline void SetSortedKey(int pointer, int descriptor_number);
2707   inline void SetRepresentation(int descriptor_number,
2708                                 Representation representation);
2709
2710   // Accessor for complete descriptor.
2711   inline void Get(int descriptor_number, Descriptor* desc);
2712   inline void Set(int descriptor_number, Descriptor* desc);
2713   void Replace(int descriptor_number, Descriptor* descriptor);
2714
2715   // Append automatically sets the enumeration index. This should only be used
2716   // to add descriptors in bulk at the end, followed by sorting the descriptor
2717   // array.
2718   inline void Append(Descriptor* desc);
2719
2720   static Handle<DescriptorArray> CopyUpTo(Handle<DescriptorArray> desc,
2721                                           int enumeration_index,
2722                                           int slack = 0);
2723
2724   static Handle<DescriptorArray> CopyUpToAddAttributes(
2725       Handle<DescriptorArray> desc,
2726       int enumeration_index,
2727       PropertyAttributes attributes,
2728       int slack = 0);
2729
2730   // Sort the instance descriptors by the hash codes of their keys.
2731   void Sort();
2732
2733   // Search the instance descriptors for given name.
2734   INLINE(int Search(Name* name, int number_of_own_descriptors));
2735
2736   // As the above, but uses DescriptorLookupCache and updates it when
2737   // necessary.
2738   INLINE(int SearchWithCache(Name* name, Map* map));
2739
2740   // Allocates a DescriptorArray, but returns the singleton
2741   // empty descriptor array object if number_of_descriptors is 0.
2742   static Handle<DescriptorArray> Allocate(Isolate* isolate,
2743                                           int number_of_descriptors,
2744                                           int slack = 0);
2745
2746   DECLARE_CAST(DescriptorArray)
2747
2748   // Constant for denoting key was not found.
2749   static const int kNotFound = -1;
2750
2751   static const int kDescriptorLengthIndex = 0;
2752   static const int kEnumCacheIndex = 1;
2753   static const int kFirstIndex = 2;
2754
2755   // The length of the "bridge" to the enum cache.
2756   static const int kEnumCacheBridgeLength = 2;
2757   static const int kEnumCacheBridgeCacheIndex = 0;
2758   static const int kEnumCacheBridgeIndicesCacheIndex = 1;
2759
2760   // Layout description.
2761   static const int kDescriptorLengthOffset = FixedArray::kHeaderSize;
2762   static const int kEnumCacheOffset = kDescriptorLengthOffset + kPointerSize;
2763   static const int kFirstOffset = kEnumCacheOffset + kPointerSize;
2764
2765   // Layout description for the bridge array.
2766   static const int kEnumCacheBridgeCacheOffset = FixedArray::kHeaderSize;
2767
2768   // Layout of descriptor.
2769   static const int kDescriptorKey = 0;
2770   static const int kDescriptorDetails = 1;
2771   static const int kDescriptorValue = 2;
2772   static const int kDescriptorSize = 3;
2773
2774 #if defined(DEBUG) || defined(OBJECT_PRINT)
2775   // For our gdb macros, we should perhaps change these in the future.
2776   void Print();
2777
2778   // Print all the descriptors.
2779   void PrintDescriptors(std::ostream& os);  // NOLINT
2780 #endif
2781
2782 #ifdef DEBUG
2783   // Is the descriptor array sorted and without duplicates?
2784   bool IsSortedNoDuplicates(int valid_descriptors = -1);
2785
2786   // Is the descriptor array consistent with the back pointers in targets?
2787   bool IsConsistentWithBackPointers(Map* current_map);
2788
2789   // Are two DescriptorArrays equal?
2790   bool IsEqualTo(DescriptorArray* other);
2791 #endif
2792
2793   // Returns the fixed array length required to hold number_of_descriptors
2794   // descriptors.
2795   static int LengthFor(int number_of_descriptors) {
2796     return ToKeyIndex(number_of_descriptors);
2797   }
2798
2799  private:
2800   // WhitenessWitness is used to prove that a descriptor array is white
2801   // (unmarked), so incremental write barriers can be skipped because the
2802   // marking invariant cannot be broken and slots pointing into evacuation
2803   // candidates will be discovered when the object is scanned. A witness is
2804   // always stack-allocated right after creating an array. By allocating a
2805   // witness, incremental marking is globally disabled. The witness is then
2806   // passed along wherever needed to statically prove that the array is known to
2807   // be white.
2808   class WhitenessWitness {
2809    public:
2810     inline explicit WhitenessWitness(DescriptorArray* array);
2811     inline ~WhitenessWitness();
2812
2813    private:
2814     IncrementalMarking* marking_;
2815   };
2816
2817   // An entry in a DescriptorArray, represented as an (array, index) pair.
2818   class Entry {
2819    public:
2820     inline explicit Entry(DescriptorArray* descs, int index) :
2821         descs_(descs), index_(index) { }
2822
2823     inline PropertyType type() { return descs_->GetType(index_); }
2824     inline Object* GetCallbackObject() { return descs_->GetValue(index_); }
2825
2826    private:
2827     DescriptorArray* descs_;
2828     int index_;
2829   };
2830
2831   // Conversion from descriptor number to array indices.
2832   static int ToKeyIndex(int descriptor_number) {
2833     return kFirstIndex +
2834            (descriptor_number * kDescriptorSize) +
2835            kDescriptorKey;
2836   }
2837
2838   static int ToDetailsIndex(int descriptor_number) {
2839     return kFirstIndex +
2840            (descriptor_number * kDescriptorSize) +
2841            kDescriptorDetails;
2842   }
2843
2844   static int ToValueIndex(int descriptor_number) {
2845     return kFirstIndex +
2846            (descriptor_number * kDescriptorSize) +
2847            kDescriptorValue;
2848   }
2849
2850   // Transfer a complete descriptor from the src descriptor array to this
2851   // descriptor array.
2852   void CopyFrom(int index, DescriptorArray* src, const WhitenessWitness&);
2853
2854   inline void Set(int descriptor_number,
2855                   Descriptor* desc,
2856                   const WhitenessWitness&);
2857
2858   // Swap first and second descriptor.
2859   inline void SwapSortedKeys(int first, int second);
2860
2861   DISALLOW_IMPLICIT_CONSTRUCTORS(DescriptorArray);
2862 };
2863
2864
2865 enum SearchMode { ALL_ENTRIES, VALID_ENTRIES };
2866
2867 template <SearchMode search_mode, typename T>
2868 inline int Search(T* array, Name* name, int valid_entries = 0,
2869                   int* out_insertion_index = NULL);
2870
2871
2872 // HashTable is a subclass of FixedArray that implements a hash table
2873 // that uses open addressing and quadratic probing.
2874 //
2875 // In order for the quadratic probing to work, elements that have not
2876 // yet been used and elements that have been deleted are
2877 // distinguished.  Probing continues when deleted elements are
2878 // encountered and stops when unused elements are encountered.
2879 //
2880 // - Elements with key == undefined have not been used yet.
2881 // - Elements with key == the_hole have been deleted.
2882 //
2883 // The hash table class is parameterized with a Shape and a Key.
2884 // Shape must be a class with the following interface:
2885 //   class ExampleShape {
2886 //    public:
2887 //      // Tells whether key matches other.
2888 //     static bool IsMatch(Key key, Object* other);
2889 //     // Returns the hash value for key.
2890 //     static uint32_t Hash(Key key);
2891 //     // Returns the hash value for object.
2892 //     static uint32_t HashForObject(Key key, Object* object);
2893 //     // Convert key to an object.
2894 //     static inline Handle<Object> AsHandle(Isolate* isolate, Key key);
2895 //     // The prefix size indicates number of elements in the beginning
2896 //     // of the backing storage.
2897 //     static const int kPrefixSize = ..;
2898 //     // The Element size indicates number of elements per entry.
2899 //     static const int kEntrySize = ..;
2900 //   };
2901 // The prefix size indicates an amount of memory in the
2902 // beginning of the backing storage that can be used for non-element
2903 // information by subclasses.
2904
2905 template<typename Key>
2906 class BaseShape {
2907  public:
2908   static const bool UsesSeed = false;
2909   static uint32_t Hash(Key key) { return 0; }
2910   static uint32_t SeededHash(Key key, uint32_t seed) {
2911     DCHECK(UsesSeed);
2912     return Hash(key);
2913   }
2914   static uint32_t HashForObject(Key key, Object* object) { return 0; }
2915   static uint32_t SeededHashForObject(Key key, uint32_t seed, Object* object) {
2916     DCHECK(UsesSeed);
2917     return HashForObject(key, object);
2918   }
2919 };
2920
2921
2922 class HashTableBase : public FixedArray {
2923  public:
2924   // Returns the number of elements in the hash table.
2925   int NumberOfElements() {
2926     return Smi::cast(get(kNumberOfElementsIndex))->value();
2927   }
2928
2929   // Returns the number of deleted elements in the hash table.
2930   int NumberOfDeletedElements() {
2931     return Smi::cast(get(kNumberOfDeletedElementsIndex))->value();
2932   }
2933
2934   // Returns the capacity of the hash table.
2935   int Capacity() {
2936     return Smi::cast(get(kCapacityIndex))->value();
2937   }
2938
2939   // ElementAdded should be called whenever an element is added to a
2940   // hash table.
2941   void ElementAdded() { SetNumberOfElements(NumberOfElements() + 1); }
2942
2943   // ElementRemoved should be called whenever an element is removed from
2944   // a hash table.
2945   void ElementRemoved() {
2946     SetNumberOfElements(NumberOfElements() - 1);
2947     SetNumberOfDeletedElements(NumberOfDeletedElements() + 1);
2948   }
2949   void ElementsRemoved(int n) {
2950     SetNumberOfElements(NumberOfElements() - n);
2951     SetNumberOfDeletedElements(NumberOfDeletedElements() + n);
2952   }
2953
2954   // Computes the required capacity for a table holding the given
2955   // number of elements. May be more than HashTable::kMaxCapacity.
2956   static inline int ComputeCapacity(int at_least_space_for);
2957
2958   // Tells whether k is a real key.  The hole and undefined are not allowed
2959   // as keys and can be used to indicate missing or deleted elements.
2960   bool IsKey(Object* k) {
2961     return !k->IsTheHole() && !k->IsUndefined();
2962   }
2963
2964   // Compute the probe offset (quadratic probing).
2965   INLINE(static uint32_t GetProbeOffset(uint32_t n)) {
2966     return (n + n * n) >> 1;
2967   }
2968
2969   static const int kNumberOfElementsIndex = 0;
2970   static const int kNumberOfDeletedElementsIndex = 1;
2971   static const int kCapacityIndex = 2;
2972   static const int kPrefixStartIndex = 3;
2973
2974   // Constant used for denoting a absent entry.
2975   static const int kNotFound = -1;
2976
2977  protected:
2978   // Update the number of elements in the hash table.
2979   void SetNumberOfElements(int nof) {
2980     set(kNumberOfElementsIndex, Smi::FromInt(nof));
2981   }
2982
2983   // Update the number of deleted elements in the hash table.
2984   void SetNumberOfDeletedElements(int nod) {
2985     set(kNumberOfDeletedElementsIndex, Smi::FromInt(nod));
2986   }
2987
2988   // Returns probe entry.
2989   static uint32_t GetProbe(uint32_t hash, uint32_t number, uint32_t size) {
2990     DCHECK(base::bits::IsPowerOfTwo32(size));
2991     return (hash + GetProbeOffset(number)) & (size - 1);
2992   }
2993
2994   inline static uint32_t FirstProbe(uint32_t hash, uint32_t size) {
2995     return hash & (size - 1);
2996   }
2997
2998   inline static uint32_t NextProbe(
2999       uint32_t last, uint32_t number, uint32_t size) {
3000     return (last + number) & (size - 1);
3001   }
3002 };
3003
3004
3005 template <typename Derived, typename Shape, typename Key>
3006 class HashTable : public HashTableBase {
3007  public:
3008   // Wrapper methods
3009   inline uint32_t Hash(Key key) {
3010     if (Shape::UsesSeed) {
3011       return Shape::SeededHash(key, GetHeap()->HashSeed());
3012     } else {
3013       return Shape::Hash(key);
3014     }
3015   }
3016
3017   inline uint32_t HashForObject(Key key, Object* object) {
3018     if (Shape::UsesSeed) {
3019       return Shape::SeededHashForObject(key, GetHeap()->HashSeed(), object);
3020     } else {
3021       return Shape::HashForObject(key, object);
3022     }
3023   }
3024
3025   // Returns a new HashTable object.
3026   MUST_USE_RESULT static Handle<Derived> New(
3027       Isolate* isolate, int at_least_space_for,
3028       MinimumCapacity capacity_option = USE_DEFAULT_MINIMUM_CAPACITY,
3029       PretenureFlag pretenure = NOT_TENURED);
3030
3031   DECLARE_CAST(HashTable)
3032
3033   // Garbage collection support.
3034   void IteratePrefix(ObjectVisitor* visitor);
3035   void IterateElements(ObjectVisitor* visitor);
3036
3037   // Find entry for key otherwise return kNotFound.
3038   inline int FindEntry(Key key);
3039   inline int FindEntry(Isolate* isolate, Key key, int32_t hash);
3040   int FindEntry(Isolate* isolate, Key key);
3041
3042   // Rehashes the table in-place.
3043   void Rehash(Key key);
3044
3045   // Returns the key at entry.
3046   Object* KeyAt(int entry) { return get(EntryToIndex(entry)); }
3047
3048   static const int kElementsStartIndex = kPrefixStartIndex + Shape::kPrefixSize;
3049   static const int kEntrySize = Shape::kEntrySize;
3050   static const int kElementsStartOffset =
3051       kHeaderSize + kElementsStartIndex * kPointerSize;
3052   static const int kCapacityOffset =
3053       kHeaderSize + kCapacityIndex * kPointerSize;
3054
3055   // Returns the index for an entry (of the key)
3056   static inline int EntryToIndex(int entry) {
3057     return (entry * kEntrySize) + kElementsStartIndex;
3058   }
3059
3060  protected:
3061   friend class ObjectHashTable;
3062
3063   // Find the entry at which to insert element with the given key that
3064   // has the given hash value.
3065   uint32_t FindInsertionEntry(uint32_t hash);
3066
3067   // Attempt to shrink hash table after removal of key.
3068   MUST_USE_RESULT static Handle<Derived> Shrink(Handle<Derived> table, Key key);
3069
3070   // Ensure enough space for n additional elements.
3071   MUST_USE_RESULT static Handle<Derived> EnsureCapacity(
3072       Handle<Derived> table,
3073       int n,
3074       Key key,
3075       PretenureFlag pretenure = NOT_TENURED);
3076
3077   // Sets the capacity of the hash table.
3078   void SetCapacity(int capacity) {
3079     // To scale a computed hash code to fit within the hash table, we
3080     // use bit-wise AND with a mask, so the capacity must be positive
3081     // and non-zero.
3082     DCHECK(capacity > 0);
3083     DCHECK(capacity <= kMaxCapacity);
3084     set(kCapacityIndex, Smi::FromInt(capacity));
3085   }
3086
3087   // Maximal capacity of HashTable. Based on maximal length of underlying
3088   // FixedArray. Staying below kMaxCapacity also ensures that EntryToIndex
3089   // cannot overflow.
3090   static const int kMaxCapacity =
3091       (FixedArray::kMaxLength - kElementsStartOffset) / kEntrySize;
3092
3093  private:
3094   // Returns _expected_ if one of entries given by the first _probe_ probes is
3095   // equal to  _expected_. Otherwise, returns the entry given by the probe
3096   // number _probe_.
3097   uint32_t EntryForProbe(Key key, Object* k, int probe, uint32_t expected);
3098
3099   void Swap(uint32_t entry1, uint32_t entry2, WriteBarrierMode mode);
3100
3101   // Rehashes this hash-table into the new table.
3102   void Rehash(Handle<Derived> new_table, Key key);
3103 };
3104
3105
3106 // HashTableKey is an abstract superclass for virtual key behavior.
3107 class HashTableKey {
3108  public:
3109   // Returns whether the other object matches this key.
3110   virtual bool IsMatch(Object* other) = 0;
3111   // Returns the hash value for this key.
3112   virtual uint32_t Hash() = 0;
3113   // Returns the hash value for object.
3114   virtual uint32_t HashForObject(Object* key) = 0;
3115   // Returns the key object for storing into the hash table.
3116   MUST_USE_RESULT virtual Handle<Object> AsHandle(Isolate* isolate) = 0;
3117   // Required.
3118   virtual ~HashTableKey() {}
3119 };
3120
3121
3122 class StringTableShape : public BaseShape<HashTableKey*> {
3123  public:
3124   static inline bool IsMatch(HashTableKey* key, Object* value) {
3125     return key->IsMatch(value);
3126   }
3127
3128   static inline uint32_t Hash(HashTableKey* key) {
3129     return key->Hash();
3130   }
3131
3132   static inline uint32_t HashForObject(HashTableKey* key, Object* object) {
3133     return key->HashForObject(object);
3134   }
3135
3136   static inline Handle<Object> AsHandle(Isolate* isolate, HashTableKey* key);
3137
3138   static const int kPrefixSize = 0;
3139   static const int kEntrySize = 1;
3140 };
3141
3142 class SeqOneByteString;
3143
3144 // StringTable.
3145 //
3146 // No special elements in the prefix and the element size is 1
3147 // because only the string itself (the key) needs to be stored.
3148 class StringTable: public HashTable<StringTable,
3149                                     StringTableShape,
3150                                     HashTableKey*> {
3151  public:
3152   // Find string in the string table. If it is not there yet, it is
3153   // added. The return value is the string found.
3154   static Handle<String> LookupString(Isolate* isolate, Handle<String> key);
3155   static Handle<String> LookupKey(Isolate* isolate, HashTableKey* key);
3156   static String* LookupKeyIfExists(Isolate* isolate, HashTableKey* key);
3157
3158   // Tries to internalize given string and returns string handle on success
3159   // or an empty handle otherwise.
3160   MUST_USE_RESULT static MaybeHandle<String> InternalizeStringIfExists(
3161       Isolate* isolate,
3162       Handle<String> string);
3163
3164   // Looks up a string that is equal to the given string and returns
3165   // string handle if it is found, or an empty handle otherwise.
3166   MUST_USE_RESULT static MaybeHandle<String> LookupStringIfExists(
3167       Isolate* isolate,
3168       Handle<String> str);
3169   MUST_USE_RESULT static MaybeHandle<String> LookupTwoCharsStringIfExists(
3170       Isolate* isolate,
3171       uint16_t c1,
3172       uint16_t c2);
3173
3174   static void EnsureCapacityForDeserialization(Isolate* isolate, int expected);
3175
3176   DECLARE_CAST(StringTable)
3177
3178  private:
3179   template <bool seq_one_byte>
3180   friend class JsonParser;
3181
3182   DISALLOW_IMPLICIT_CONSTRUCTORS(StringTable);
3183 };
3184
3185
3186 template <typename Derived, typename Shape, typename Key>
3187 class Dictionary: public HashTable<Derived, Shape, Key> {
3188   typedef HashTable<Derived, Shape, Key> DerivedHashTable;
3189
3190  public:
3191   // Returns the value at entry.
3192   Object* ValueAt(int entry) {
3193     return this->get(Derived::EntryToIndex(entry) + 1);
3194   }
3195
3196   // Set the value for entry.
3197   void ValueAtPut(int entry, Object* value) {
3198     this->set(Derived::EntryToIndex(entry) + 1, value);
3199   }
3200
3201   // Returns the property details for the property at entry.
3202   PropertyDetails DetailsAt(int entry) {
3203     return Shape::DetailsAt(static_cast<Derived*>(this), entry);
3204   }
3205
3206   // Set the details for entry.
3207   void DetailsAtPut(int entry, PropertyDetails value) {
3208     Shape::DetailsAtPut(static_cast<Derived*>(this), entry, value);
3209   }
3210
3211   // Returns true if property at given entry is deleted.
3212   bool IsDeleted(int entry) {
3213     return Shape::IsDeleted(static_cast<Derived*>(this), entry);
3214   }
3215
3216   // Delete a property from the dictionary.
3217   static Handle<Object> DeleteProperty(Handle<Derived> dictionary, int entry);
3218
3219   // Attempt to shrink the dictionary after deletion of key.
3220   MUST_USE_RESULT static inline Handle<Derived> Shrink(
3221       Handle<Derived> dictionary,
3222       Key key) {
3223     return DerivedHashTable::Shrink(dictionary, key);
3224   }
3225
3226   // Sorting support
3227   // TODO(dcarney): templatize or move to SeededNumberDictionary
3228   void CopyValuesTo(FixedArray* elements);
3229
3230   // Returns the number of elements in the dictionary filtering out properties
3231   // with the specified attributes.
3232   int NumberOfElementsFilterAttributes(PropertyAttributes filter);
3233
3234   // Returns the number of enumerable elements in the dictionary.
3235   int NumberOfEnumElements() {
3236     return NumberOfElementsFilterAttributes(
3237         static_cast<PropertyAttributes>(DONT_ENUM | SYMBOLIC));
3238   }
3239
3240   // Returns true if the dictionary contains any elements that are non-writable,
3241   // non-configurable, non-enumerable, or have getters/setters.
3242   bool HasComplexElements();
3243
3244   enum SortMode { UNSORTED, SORTED };
3245
3246   // Fill in details for properties into storage.
3247   // Returns the number of properties added.
3248   int CopyKeysTo(FixedArray* storage, int index, PropertyAttributes filter,
3249                  SortMode sort_mode);
3250
3251   // Copies enumerable keys to preallocated fixed array.
3252   void CopyEnumKeysTo(FixedArray* storage);
3253
3254   // Accessors for next enumeration index.
3255   void SetNextEnumerationIndex(int index) {
3256     DCHECK(index != 0);
3257     this->set(kNextEnumerationIndexIndex, Smi::FromInt(index));
3258   }
3259
3260   int NextEnumerationIndex() {
3261     return Smi::cast(this->get(kNextEnumerationIndexIndex))->value();
3262   }
3263
3264   // Creates a new dictionary.
3265   MUST_USE_RESULT static Handle<Derived> New(
3266       Isolate* isolate,
3267       int at_least_space_for,
3268       PretenureFlag pretenure = NOT_TENURED);
3269
3270   // Ensure enough space for n additional elements.
3271   static Handle<Derived> EnsureCapacity(Handle<Derived> obj, int n, Key key);
3272
3273 #ifdef OBJECT_PRINT
3274   void Print(std::ostream& os);  // NOLINT
3275 #endif
3276   // Returns the key (slow).
3277   Object* SlowReverseLookup(Object* value);
3278
3279   // Sets the entry to (key, value) pair.
3280   inline void SetEntry(int entry,
3281                        Handle<Object> key,
3282                        Handle<Object> value);
3283   inline void SetEntry(int entry,
3284                        Handle<Object> key,
3285                        Handle<Object> value,
3286                        PropertyDetails details);
3287
3288   MUST_USE_RESULT static Handle<Derived> Add(
3289       Handle<Derived> dictionary,
3290       Key key,
3291       Handle<Object> value,
3292       PropertyDetails details);
3293
3294   // Returns iteration indices array for the |dictionary|.
3295   // Values are direct indices in the |HashTable| array.
3296   static Handle<FixedArray> BuildIterationIndicesArray(
3297       Handle<Derived> dictionary);
3298
3299  protected:
3300   // Generic at put operation.
3301   MUST_USE_RESULT static Handle<Derived> AtPut(
3302       Handle<Derived> dictionary,
3303       Key key,
3304       Handle<Object> value);
3305
3306   // Add entry to dictionary.
3307   static void AddEntry(
3308       Handle<Derived> dictionary,
3309       Key key,
3310       Handle<Object> value,
3311       PropertyDetails details,
3312       uint32_t hash);
3313
3314   // Generate new enumeration indices to avoid enumeration index overflow.
3315   // Returns iteration indices array for the |dictionary|.
3316   static Handle<FixedArray> GenerateNewEnumerationIndices(
3317       Handle<Derived> dictionary);
3318   static const int kMaxNumberKeyIndex = DerivedHashTable::kPrefixStartIndex;
3319   static const int kNextEnumerationIndexIndex = kMaxNumberKeyIndex + 1;
3320 };
3321
3322
3323 template <typename Derived, typename Shape>
3324 class NameDictionaryBase : public Dictionary<Derived, Shape, Handle<Name> > {
3325   typedef Dictionary<Derived, Shape, Handle<Name> > DerivedDictionary;
3326
3327  public:
3328   // Find entry for key, otherwise return kNotFound. Optimized version of
3329   // HashTable::FindEntry.
3330   int FindEntry(Handle<Name> key);
3331 };
3332
3333
3334 template <typename Key>
3335 class BaseDictionaryShape : public BaseShape<Key> {
3336  public:
3337   template <typename Dictionary>
3338   static inline PropertyDetails DetailsAt(Dictionary* dict, int entry) {
3339     STATIC_ASSERT(Dictionary::kEntrySize == 3);
3340     DCHECK(entry >= 0);  // Not found is -1, which is not caught by get().
3341     return PropertyDetails(
3342         Smi::cast(dict->get(Dictionary::EntryToIndex(entry) + 2)));
3343   }
3344
3345   template <typename Dictionary>
3346   static inline void DetailsAtPut(Dictionary* dict, int entry,
3347                                   PropertyDetails value) {
3348     STATIC_ASSERT(Dictionary::kEntrySize == 3);
3349     dict->set(Dictionary::EntryToIndex(entry) + 2, value.AsSmi());
3350   }
3351
3352   template <typename Dictionary>
3353   static bool IsDeleted(Dictionary* dict, int entry) {
3354     return false;
3355   }
3356
3357   template <typename Dictionary>
3358   static inline void SetEntry(Dictionary* dict, int entry, Handle<Object> key,
3359                               Handle<Object> value, PropertyDetails details);
3360 };
3361
3362
3363 class NameDictionaryShape : public BaseDictionaryShape<Handle<Name> > {
3364  public:
3365   static inline bool IsMatch(Handle<Name> key, Object* other);
3366   static inline uint32_t Hash(Handle<Name> key);
3367   static inline uint32_t HashForObject(Handle<Name> key, Object* object);
3368   static inline Handle<Object> AsHandle(Isolate* isolate, Handle<Name> key);
3369   static const int kPrefixSize = 2;
3370   static const int kEntrySize = 3;
3371   static const bool kIsEnumerable = true;
3372 };
3373
3374
3375 class NameDictionary
3376     : public NameDictionaryBase<NameDictionary, NameDictionaryShape> {
3377   typedef NameDictionaryBase<NameDictionary, NameDictionaryShape>
3378       DerivedDictionary;
3379
3380  public:
3381   DECLARE_CAST(NameDictionary)
3382
3383   inline static Handle<FixedArray> DoGenerateNewEnumerationIndices(
3384       Handle<NameDictionary> dictionary);
3385 };
3386
3387
3388 class GlobalDictionaryShape : public NameDictionaryShape {
3389  public:
3390   static const int kEntrySize = 2;  // Overrides NameDictionaryShape::kEntrySize
3391
3392   template <typename Dictionary>
3393   static inline PropertyDetails DetailsAt(Dictionary* dict, int entry);
3394
3395   template <typename Dictionary>
3396   static inline void DetailsAtPut(Dictionary* dict, int entry,
3397                                   PropertyDetails value);
3398
3399   template <typename Dictionary>
3400   static bool IsDeleted(Dictionary* dict, int entry);
3401
3402   template <typename Dictionary>
3403   static inline void SetEntry(Dictionary* dict, int entry, Handle<Object> key,
3404                               Handle<Object> value, PropertyDetails details);
3405 };
3406
3407
3408 class GlobalDictionary
3409     : public NameDictionaryBase<GlobalDictionary, GlobalDictionaryShape> {
3410  public:
3411   DECLARE_CAST(GlobalDictionary)
3412 };
3413
3414
3415 class NumberDictionaryShape : public BaseDictionaryShape<uint32_t> {
3416  public:
3417   static inline bool IsMatch(uint32_t key, Object* other);
3418   static inline Handle<Object> AsHandle(Isolate* isolate, uint32_t key);
3419   static const int kEntrySize = 3;
3420   static const bool kIsEnumerable = false;
3421 };
3422
3423
3424 class SeededNumberDictionaryShape : public NumberDictionaryShape {
3425  public:
3426   static const bool UsesSeed = true;
3427   static const int kPrefixSize = 2;
3428
3429   static inline uint32_t SeededHash(uint32_t key, uint32_t seed);
3430   static inline uint32_t SeededHashForObject(uint32_t key,
3431                                              uint32_t seed,
3432                                              Object* object);
3433 };
3434
3435
3436 class UnseededNumberDictionaryShape : public NumberDictionaryShape {
3437  public:
3438   static const int kPrefixSize = 0;
3439
3440   static inline uint32_t Hash(uint32_t key);
3441   static inline uint32_t HashForObject(uint32_t key, Object* object);
3442 };
3443
3444
3445 class SeededNumberDictionary
3446     : public Dictionary<SeededNumberDictionary,
3447                         SeededNumberDictionaryShape,
3448                         uint32_t> {
3449  public:
3450   DECLARE_CAST(SeededNumberDictionary)
3451
3452   // Type specific at put (default NONE attributes is used when adding).
3453   MUST_USE_RESULT static Handle<SeededNumberDictionary> AtNumberPut(
3454       Handle<SeededNumberDictionary> dictionary,
3455       uint32_t key,
3456       Handle<Object> value);
3457   MUST_USE_RESULT static Handle<SeededNumberDictionary> AddNumberEntry(
3458       Handle<SeededNumberDictionary> dictionary,
3459       uint32_t key,
3460       Handle<Object> value,
3461       PropertyDetails details);
3462
3463   // Set an existing entry or add a new one if needed.
3464   // Return the updated dictionary.
3465   MUST_USE_RESULT static Handle<SeededNumberDictionary> Set(
3466       Handle<SeededNumberDictionary> dictionary,
3467       uint32_t key,
3468       Handle<Object> value,
3469       PropertyDetails details);
3470
3471   void UpdateMaxNumberKey(uint32_t key);
3472
3473   // If slow elements are required we will never go back to fast-case
3474   // for the elements kept in this dictionary.  We require slow
3475   // elements if an element has been added at an index larger than
3476   // kRequiresSlowElementsLimit or set_requires_slow_elements() has been called
3477   // when defining a getter or setter with a number key.
3478   inline bool requires_slow_elements();
3479   inline void set_requires_slow_elements();
3480
3481   // Get the value of the max number key that has been added to this
3482   // dictionary.  max_number_key can only be called if
3483   // requires_slow_elements returns false.
3484   inline uint32_t max_number_key();
3485
3486   // Bit masks.
3487   static const int kRequiresSlowElementsMask = 1;
3488   static const int kRequiresSlowElementsTagSize = 1;
3489   static const uint32_t kRequiresSlowElementsLimit = (1 << 29) - 1;
3490 };
3491
3492
3493 class UnseededNumberDictionary
3494     : public Dictionary<UnseededNumberDictionary,
3495                         UnseededNumberDictionaryShape,
3496                         uint32_t> {
3497  public:
3498   DECLARE_CAST(UnseededNumberDictionary)
3499
3500   // Type specific at put (default NONE attributes is used when adding).
3501   MUST_USE_RESULT static Handle<UnseededNumberDictionary> AtNumberPut(
3502       Handle<UnseededNumberDictionary> dictionary,
3503       uint32_t key,
3504       Handle<Object> value);
3505   MUST_USE_RESULT static Handle<UnseededNumberDictionary> AddNumberEntry(
3506       Handle<UnseededNumberDictionary> dictionary,
3507       uint32_t key,
3508       Handle<Object> value);
3509
3510   // Set an existing entry or add a new one if needed.
3511   // Return the updated dictionary.
3512   MUST_USE_RESULT static Handle<UnseededNumberDictionary> Set(
3513       Handle<UnseededNumberDictionary> dictionary,
3514       uint32_t key,
3515       Handle<Object> value);
3516 };
3517
3518
3519 class ObjectHashTableShape : public BaseShape<Handle<Object> > {
3520  public:
3521   static inline bool IsMatch(Handle<Object> key, Object* other);
3522   static inline uint32_t Hash(Handle<Object> key);
3523   static inline uint32_t HashForObject(Handle<Object> key, Object* object);
3524   static inline Handle<Object> AsHandle(Isolate* isolate, Handle<Object> key);
3525   static const int kPrefixSize = 0;
3526   static const int kEntrySize = 2;
3527 };
3528
3529
3530 // ObjectHashTable maps keys that are arbitrary objects to object values by
3531 // using the identity hash of the key for hashing purposes.
3532 class ObjectHashTable: public HashTable<ObjectHashTable,
3533                                         ObjectHashTableShape,
3534                                         Handle<Object> > {
3535   typedef HashTable<
3536       ObjectHashTable, ObjectHashTableShape, Handle<Object> > DerivedHashTable;
3537  public:
3538   DECLARE_CAST(ObjectHashTable)
3539
3540   // Attempt to shrink hash table after removal of key.
3541   MUST_USE_RESULT static inline Handle<ObjectHashTable> Shrink(
3542       Handle<ObjectHashTable> table,
3543       Handle<Object> key);
3544
3545   // Looks up the value associated with the given key. The hole value is
3546   // returned in case the key is not present.
3547   Object* Lookup(Handle<Object> key);
3548   Object* Lookup(Handle<Object> key, int32_t hash);
3549   Object* Lookup(Isolate* isolate, Handle<Object> key, int32_t hash);
3550
3551   // Adds (or overwrites) the value associated with the given key.
3552   static Handle<ObjectHashTable> Put(Handle<ObjectHashTable> table,
3553                                      Handle<Object> key,
3554                                      Handle<Object> value);
3555   static Handle<ObjectHashTable> Put(Handle<ObjectHashTable> table,
3556                                      Handle<Object> key, Handle<Object> value,
3557                                      int32_t hash);
3558
3559   // Returns an ObjectHashTable (possibly |table|) where |key| has been removed.
3560   static Handle<ObjectHashTable> Remove(Handle<ObjectHashTable> table,
3561                                         Handle<Object> key,
3562                                         bool* was_present);
3563   static Handle<ObjectHashTable> Remove(Handle<ObjectHashTable> table,
3564                                         Handle<Object> key, bool* was_present,
3565                                         int32_t hash);
3566
3567  protected:
3568   friend class MarkCompactCollector;
3569
3570   void AddEntry(int entry, Object* key, Object* value);
3571   void RemoveEntry(int entry);
3572
3573   // Returns the index to the value of an entry.
3574   static inline int EntryToValueIndex(int entry) {
3575     return EntryToIndex(entry) + 1;
3576   }
3577 };
3578
3579
3580 // OrderedHashTable is a HashTable with Object keys that preserves
3581 // insertion order. There are Map and Set interfaces (OrderedHashMap
3582 // and OrderedHashTable, below). It is meant to be used by JSMap/JSSet.
3583 //
3584 // Only Object* keys are supported, with Object::SameValueZero() used as the
3585 // equality operator and Object::GetHash() for the hash function.
3586 //
3587 // Based on the "Deterministic Hash Table" as described by Jason Orendorff at
3588 // https://wiki.mozilla.org/User:Jorend/Deterministic_hash_tables
3589 // Originally attributed to Tyler Close.
3590 //
3591 // Memory layout:
3592 //   [0]: bucket count
3593 //   [1]: element count
3594 //   [2]: deleted element count
3595 //   [3..(3 + NumberOfBuckets() - 1)]: "hash table", where each item is an
3596 //                            offset into the data table (see below) where the
3597 //                            first item in this bucket is stored.
3598 //   [3 + NumberOfBuckets()..length]: "data table", an array of length
3599 //                            Capacity() * kEntrySize, where the first entrysize
3600 //                            items are handled by the derived class and the
3601 //                            item at kChainOffset is another entry into the
3602 //                            data table indicating the next entry in this hash
3603 //                            bucket.
3604 //
3605 // When we transition the table to a new version we obsolete it and reuse parts
3606 // of the memory to store information how to transition an iterator to the new
3607 // table:
3608 //
3609 // Memory layout for obsolete table:
3610 //   [0]: bucket count
3611 //   [1]: Next newer table
3612 //   [2]: Number of removed holes or -1 when the table was cleared.
3613 //   [3..(3 + NumberOfRemovedHoles() - 1)]: The indexes of the removed holes.
3614 //   [3 + NumberOfRemovedHoles()..length]: Not used
3615 //
3616 template<class Derived, class Iterator, int entrysize>
3617 class OrderedHashTable: public FixedArray {
3618  public:
3619   // Returns an OrderedHashTable with a capacity of at least |capacity|.
3620   static Handle<Derived> Allocate(
3621       Isolate* isolate, int capacity, PretenureFlag pretenure = NOT_TENURED);
3622
3623   // Returns an OrderedHashTable (possibly |table|) with enough space
3624   // to add at least one new element.
3625   static Handle<Derived> EnsureGrowable(Handle<Derived> table);
3626
3627   // Returns an OrderedHashTable (possibly |table|) that's shrunken
3628   // if possible.
3629   static Handle<Derived> Shrink(Handle<Derived> table);
3630
3631   // Returns a new empty OrderedHashTable and records the clearing so that
3632   // exisiting iterators can be updated.
3633   static Handle<Derived> Clear(Handle<Derived> table);
3634
3635   int NumberOfElements() {
3636     return Smi::cast(get(kNumberOfElementsIndex))->value();
3637   }
3638
3639   int NumberOfDeletedElements() {
3640     return Smi::cast(get(kNumberOfDeletedElementsIndex))->value();
3641   }
3642
3643   int UsedCapacity() { return NumberOfElements() + NumberOfDeletedElements(); }
3644
3645   int NumberOfBuckets() {
3646     return Smi::cast(get(kNumberOfBucketsIndex))->value();
3647   }
3648
3649   // Returns an index into |this| for the given entry.
3650   int EntryToIndex(int entry) {
3651     return kHashTableStartIndex + NumberOfBuckets() + (entry * kEntrySize);
3652   }
3653
3654   Object* KeyAt(int entry) { return get(EntryToIndex(entry)); }
3655
3656   bool IsObsolete() {
3657     return !get(kNextTableIndex)->IsSmi();
3658   }
3659
3660   // The next newer table. This is only valid if the table is obsolete.
3661   Derived* NextTable() {
3662     return Derived::cast(get(kNextTableIndex));
3663   }
3664
3665   // When the table is obsolete we store the indexes of the removed holes.
3666   int RemovedIndexAt(int index) {
3667     return Smi::cast(get(kRemovedHolesIndex + index))->value();
3668   }
3669
3670   static const int kNotFound = -1;
3671   static const int kMinCapacity = 4;
3672
3673   static const int kNumberOfBucketsIndex = 0;
3674   static const int kNumberOfElementsIndex = kNumberOfBucketsIndex + 1;
3675   static const int kNumberOfDeletedElementsIndex = kNumberOfElementsIndex + 1;
3676   static const int kHashTableStartIndex = kNumberOfDeletedElementsIndex + 1;
3677   static const int kNextTableIndex = kNumberOfElementsIndex;
3678
3679   static const int kNumberOfBucketsOffset =
3680       kHeaderSize + kNumberOfBucketsIndex * kPointerSize;
3681   static const int kNumberOfElementsOffset =
3682       kHeaderSize + kNumberOfElementsIndex * kPointerSize;
3683   static const int kNumberOfDeletedElementsOffset =
3684       kHeaderSize + kNumberOfDeletedElementsIndex * kPointerSize;
3685   static const int kHashTableStartOffset =
3686       kHeaderSize + kHashTableStartIndex * kPointerSize;
3687   static const int kNextTableOffset =
3688       kHeaderSize + kNextTableIndex * kPointerSize;
3689
3690   static const int kEntrySize = entrysize + 1;
3691   static const int kChainOffset = entrysize;
3692
3693   static const int kLoadFactor = 2;
3694
3695   // NumberOfDeletedElements is set to kClearedTableSentinel when
3696   // the table is cleared, which allows iterator transitions to
3697   // optimize that case.
3698   static const int kClearedTableSentinel = -1;
3699
3700  private:
3701   static Handle<Derived> Rehash(Handle<Derived> table, int new_capacity);
3702
3703   void SetNumberOfBuckets(int num) {
3704     set(kNumberOfBucketsIndex, Smi::FromInt(num));
3705   }
3706
3707   void SetNumberOfElements(int num) {
3708     set(kNumberOfElementsIndex, Smi::FromInt(num));
3709   }
3710
3711   void SetNumberOfDeletedElements(int num) {
3712     set(kNumberOfDeletedElementsIndex, Smi::FromInt(num));
3713   }
3714
3715   int Capacity() {
3716     return NumberOfBuckets() * kLoadFactor;
3717   }
3718
3719   void SetNextTable(Derived* next_table) {
3720     set(kNextTableIndex, next_table);
3721   }
3722
3723   void SetRemovedIndexAt(int index, int removed_index) {
3724     return set(kRemovedHolesIndex + index, Smi::FromInt(removed_index));
3725   }
3726
3727   static const int kRemovedHolesIndex = kHashTableStartIndex;
3728
3729   static const int kMaxCapacity =
3730       (FixedArray::kMaxLength - kHashTableStartIndex)
3731       / (1 + (kEntrySize * kLoadFactor));
3732 };
3733
3734
3735 class JSSetIterator;
3736
3737
3738 class OrderedHashSet: public OrderedHashTable<
3739     OrderedHashSet, JSSetIterator, 1> {
3740  public:
3741   DECLARE_CAST(OrderedHashSet)
3742 };
3743
3744
3745 class JSMapIterator;
3746
3747
3748 class OrderedHashMap
3749     : public OrderedHashTable<OrderedHashMap, JSMapIterator, 2> {
3750  public:
3751   DECLARE_CAST(OrderedHashMap)
3752
3753   Object* ValueAt(int entry) {
3754     return get(EntryToIndex(entry) + kValueOffset);
3755   }
3756
3757   static const int kValueOffset = 1;
3758 };
3759
3760
3761 template <int entrysize>
3762 class WeakHashTableShape : public BaseShape<Handle<Object> > {
3763  public:
3764   static inline bool IsMatch(Handle<Object> key, Object* other);
3765   static inline uint32_t Hash(Handle<Object> key);
3766   static inline uint32_t HashForObject(Handle<Object> key, Object* object);
3767   static inline Handle<Object> AsHandle(Isolate* isolate, Handle<Object> key);
3768   static const int kPrefixSize = 0;
3769   static const int kEntrySize = entrysize;
3770 };
3771
3772
3773 // WeakHashTable maps keys that are arbitrary heap objects to heap object
3774 // values. The table wraps the keys in weak cells and store values directly.
3775 // Thus it references keys weakly and values strongly.
3776 class WeakHashTable: public HashTable<WeakHashTable,
3777                                       WeakHashTableShape<2>,
3778                                       Handle<Object> > {
3779   typedef HashTable<
3780       WeakHashTable, WeakHashTableShape<2>, Handle<Object> > DerivedHashTable;
3781  public:
3782   DECLARE_CAST(WeakHashTable)
3783
3784   // Looks up the value associated with the given key. The hole value is
3785   // returned in case the key is not present.
3786   Object* Lookup(Handle<HeapObject> key);
3787
3788   // Adds (or overwrites) the value associated with the given key. Mapping a
3789   // key to the hole value causes removal of the whole entry.
3790   MUST_USE_RESULT static Handle<WeakHashTable> Put(Handle<WeakHashTable> table,
3791                                                    Handle<HeapObject> key,
3792                                                    Handle<HeapObject> value);
3793
3794   static Handle<FixedArray> GetValues(Handle<WeakHashTable> table);
3795
3796  private:
3797   friend class MarkCompactCollector;
3798
3799   void AddEntry(int entry, Handle<WeakCell> key, Handle<HeapObject> value);
3800
3801   // Returns the index to the value of an entry.
3802   static inline int EntryToValueIndex(int entry) {
3803     return EntryToIndex(entry) + 1;
3804   }
3805 };
3806
3807
3808 class WeakValueHashTable : public ObjectHashTable {
3809  public:
3810   DECLARE_CAST(WeakValueHashTable)
3811
3812 #ifdef DEBUG
3813   // Looks up the value associated with the given key. The hole value is
3814   // returned in case the key is not present.
3815   Object* LookupWeak(Handle<Object> key);
3816 #endif  // DEBUG
3817
3818   // Adds (or overwrites) the value associated with the given key. Mapping a
3819   // key to the hole value causes removal of the whole entry.
3820   MUST_USE_RESULT static Handle<WeakValueHashTable> PutWeak(
3821       Handle<WeakValueHashTable> table, Handle<Object> key,
3822       Handle<HeapObject> value);
3823
3824   static Handle<FixedArray> GetWeakValues(Handle<WeakValueHashTable> table);
3825 };
3826
3827
3828 // ScopeInfo represents information about different scopes of a source
3829 // program  and the allocation of the scope's variables. Scope information
3830 // is stored in a compressed form in ScopeInfo objects and is used
3831 // at runtime (stack dumps, deoptimization, etc.).
3832
3833 // This object provides quick access to scope info details for runtime
3834 // routines.
3835 class ScopeInfo : public FixedArray {
3836  public:
3837   DECLARE_CAST(ScopeInfo)
3838
3839   // Return the type of this scope.
3840   ScopeType scope_type();
3841
3842   // Does this scope call eval?
3843   bool CallsEval();
3844
3845   // Return the language mode of this scope.
3846   LanguageMode language_mode();
3847
3848   // Does this scope make a sloppy eval call?
3849   bool CallsSloppyEval() { return CallsEval() && is_sloppy(language_mode()); }
3850
3851   // Return the total number of locals allocated on the stack and in the
3852   // context. This includes the parameters that are allocated in the context.
3853   int LocalCount();
3854
3855   // Return the number of stack slots for code. This number consists of two
3856   // parts:
3857   //  1. One stack slot per stack allocated local.
3858   //  2. One stack slot for the function name if it is stack allocated.
3859   int StackSlotCount();
3860
3861   // Return the number of context slots for code if a context is allocated. This
3862   // number consists of three parts:
3863   //  1. Size of fixed header for every context: Context::MIN_CONTEXT_SLOTS
3864   //  2. One context slot per context allocated local.
3865   //  3. One context slot for the function name if it is context allocated.
3866   // Parameters allocated in the context count as context allocated locals. If
3867   // no contexts are allocated for this scope ContextLength returns 0.
3868   int ContextLength();
3869
3870   // Does this scope declare a "this" binding?
3871   bool HasReceiver();
3872
3873   // Does this scope declare a "this" binding, and the "this" binding is stack-
3874   // or context-allocated?
3875   bool HasAllocatedReceiver();
3876
3877   // Is this scope the scope of a named function expression?
3878   bool HasFunctionName();
3879
3880   // Return if this has context allocated locals.
3881   bool HasHeapAllocatedLocals();
3882
3883   // Return if contexts are allocated for this scope.
3884   bool HasContext();
3885
3886   // Return if this is a function scope with "use asm".
3887   bool IsAsmModule() { return AsmModuleField::decode(Flags()); }
3888
3889   // Return if this is a nested function within an asm module scope.
3890   bool IsAsmFunction() { return AsmFunctionField::decode(Flags()); }
3891
3892   bool IsSimpleParameterList() {
3893     return IsSimpleParameterListField::decode(Flags());
3894   }
3895
3896   // Return the function_name if present.
3897   String* FunctionName();
3898
3899   // Return the name of the given parameter.
3900   String* ParameterName(int var);
3901
3902   // Return the name of the given local.
3903   String* LocalName(int var);
3904
3905   // Return the name of the given stack local.
3906   String* StackLocalName(int var);
3907
3908   // Return the name of the given stack local.
3909   int StackLocalIndex(int var);
3910
3911   // Return the name of the given context local.
3912   String* ContextLocalName(int var);
3913
3914   // Return the mode of the given context local.
3915   VariableMode ContextLocalMode(int var);
3916
3917   // Return the initialization flag of the given context local.
3918   InitializationFlag ContextLocalInitFlag(int var);
3919
3920   // Return the initialization flag of the given context local.
3921   MaybeAssignedFlag ContextLocalMaybeAssignedFlag(int var);
3922
3923   // Return true if this local was introduced by the compiler, and should not be
3924   // exposed to the user in a debugger.
3925   bool LocalIsSynthetic(int var);
3926
3927   String* StrongModeFreeVariableName(int var);
3928   int StrongModeFreeVariableStartPosition(int var);
3929   int StrongModeFreeVariableEndPosition(int var);
3930
3931   // Lookup support for serialized scope info. Returns the
3932   // the stack slot index for a given slot name if the slot is
3933   // present; otherwise returns a value < 0. The name must be an internalized
3934   // string.
3935   int StackSlotIndex(String* name);
3936
3937   // Lookup support for serialized scope info. Returns the
3938   // context slot index for a given slot name if the slot is present; otherwise
3939   // returns a value < 0. The name must be an internalized string.
3940   // If the slot is present and mode != NULL, sets *mode to the corresponding
3941   // mode for that variable.
3942   static int ContextSlotIndex(Handle<ScopeInfo> scope_info, Handle<String> name,
3943                               VariableMode* mode, VariableLocation* location,
3944                               InitializationFlag* init_flag,
3945                               MaybeAssignedFlag* maybe_assigned_flag);
3946
3947   // Lookup the name of a certain context slot by its index.
3948   String* ContextSlotName(int slot_index);
3949
3950   // Lookup support for serialized scope info. Returns the
3951   // parameter index for a given parameter name if the parameter is present;
3952   // otherwise returns a value < 0. The name must be an internalized string.
3953   int ParameterIndex(String* name);
3954
3955   // Lookup support for serialized scope info. Returns the function context
3956   // slot index if the function name is present and context-allocated (named
3957   // function expressions, only), otherwise returns a value < 0. The name
3958   // must be an internalized string.
3959   int FunctionContextSlotIndex(String* name, VariableMode* mode);
3960
3961   // Lookup support for serialized scope info.  Returns the receiver context
3962   // slot index if scope has a "this" binding, and the binding is
3963   // context-allocated.  Otherwise returns a value < 0.
3964   int ReceiverContextSlotIndex();
3965
3966   FunctionKind function_kind();
3967
3968   static Handle<ScopeInfo> Create(Isolate* isolate, Zone* zone, Scope* scope);
3969   static Handle<ScopeInfo> CreateGlobalThisBinding(Isolate* isolate);
3970
3971   // Serializes empty scope info.
3972   static ScopeInfo* Empty(Isolate* isolate);
3973
3974 #ifdef DEBUG
3975   void Print();
3976 #endif
3977
3978   // The layout of the static part of a ScopeInfo is as follows. Each entry is
3979   // numeric and occupies one array slot.
3980   // 1. A set of properties of the scope
3981   // 2. The number of parameters. This only applies to function scopes. For
3982   //    non-function scopes this is 0.
3983   // 3. The number of non-parameter variables allocated on the stack.
3984   // 4. The number of non-parameter and parameter variables allocated in the
3985   //    context.
3986 #define FOR_EACH_NUMERIC_FIELD(V) \
3987   V(Flags)                        \
3988   V(ParameterCount)               \
3989   V(StackLocalCount)              \
3990   V(ContextLocalCount)            \
3991   V(ContextGlobalCount)           \
3992   V(StrongModeFreeVariableCount)
3993
3994 #define FIELD_ACCESSORS(name)                            \
3995   void Set##name(int value) {                            \
3996     set(k##name, Smi::FromInt(value));                   \
3997   }                                                      \
3998   int name() {                                           \
3999     if (length() > 0) {                                  \
4000       return Smi::cast(get(k##name))->value();           \
4001     } else {                                             \
4002       return 0;                                          \
4003     }                                                    \
4004   }
4005   FOR_EACH_NUMERIC_FIELD(FIELD_ACCESSORS)
4006 #undef FIELD_ACCESSORS
4007
4008  private:
4009   enum {
4010 #define DECL_INDEX(name) k##name,
4011   FOR_EACH_NUMERIC_FIELD(DECL_INDEX)
4012 #undef DECL_INDEX
4013 #undef FOR_EACH_NUMERIC_FIELD
4014     kVariablePartIndex
4015   };
4016
4017   // The layout of the variable part of a ScopeInfo is as follows:
4018   // 1. ParameterEntries:
4019   //    This part stores the names of the parameters for function scopes. One
4020   //    slot is used per parameter, so in total this part occupies
4021   //    ParameterCount() slots in the array. For other scopes than function
4022   //    scopes ParameterCount() is 0.
4023   // 2. StackLocalFirstSlot:
4024   //    Index of a first stack slot for stack local. Stack locals belonging to
4025   //    this scope are located on a stack at slots starting from this index.
4026   // 3. StackLocalEntries:
4027   //    Contains the names of local variables that are allocated on the stack,
4028   //    in increasing order of the stack slot index. First local variable has
4029   //    a stack slot index defined in StackLocalFirstSlot (point 2 above).
4030   //    One slot is used per stack local, so in total this part occupies
4031   //    StackLocalCount() slots in the array.
4032   // 4. ContextLocalNameEntries:
4033   //    Contains the names of local variables and parameters that are allocated
4034   //    in the context. They are stored in increasing order of the context slot
4035   //    index starting with Context::MIN_CONTEXT_SLOTS. One slot is used per
4036   //    context local, so in total this part occupies ContextLocalCount() slots
4037   //    in the array.
4038   // 5. ContextLocalInfoEntries:
4039   //    Contains the variable modes and initialization flags corresponding to
4040   //    the context locals in ContextLocalNameEntries. One slot is used per
4041   //    context local, so in total this part occupies ContextLocalCount()
4042   //    slots in the array.
4043   // 6. StrongModeFreeVariableNameEntries:
4044   //    Stores the names of strong mode free variables.
4045   // 7. StrongModeFreeVariablePositionEntries:
4046   //    Stores the locations (start and end position) of strong mode free
4047   //    variables.
4048   // 8. RecieverEntryIndex:
4049   //    If the scope binds a "this" value, one slot is reserved to hold the
4050   //    context or stack slot index for the variable.
4051   // 9. FunctionNameEntryIndex:
4052   //    If the scope belongs to a named function expression this part contains
4053   //    information about the function variable. It always occupies two array
4054   //    slots:  a. The name of the function variable.
4055   //            b. The context or stack slot index for the variable.
4056   int ParameterEntriesIndex();
4057   int StackLocalFirstSlotIndex();
4058   int StackLocalEntriesIndex();
4059   int ContextLocalNameEntriesIndex();
4060   int ContextGlobalNameEntriesIndex();
4061   int ContextLocalInfoEntriesIndex();
4062   int ContextGlobalInfoEntriesIndex();
4063   int StrongModeFreeVariableNameEntriesIndex();
4064   int StrongModeFreeVariablePositionEntriesIndex();
4065   int ReceiverEntryIndex();
4066   int FunctionNameEntryIndex();
4067
4068   int Lookup(Handle<String> name, int start, int end, VariableMode* mode,
4069              VariableLocation* location, InitializationFlag* init_flag,
4070              MaybeAssignedFlag* maybe_assigned_flag);
4071
4072   // Used for the function name variable for named function expressions, and for
4073   // the receiver.
4074   enum VariableAllocationInfo { NONE, STACK, CONTEXT, UNUSED };
4075
4076   // Properties of scopes.
4077   class ScopeTypeField : public BitField<ScopeType, 0, 4> {};
4078   class CallsEvalField : public BitField<bool, ScopeTypeField::kNext, 1> {};
4079   STATIC_ASSERT(LANGUAGE_END == 3);
4080   class LanguageModeField
4081       : public BitField<LanguageMode, CallsEvalField::kNext, 2> {};
4082   class ReceiverVariableField
4083       : public BitField<VariableAllocationInfo, LanguageModeField::kNext, 2> {};
4084   class FunctionVariableField
4085       : public BitField<VariableAllocationInfo, ReceiverVariableField::kNext,
4086                         2> {};
4087   class FunctionVariableMode
4088       : public BitField<VariableMode, FunctionVariableField::kNext, 3> {};
4089   class AsmModuleField : public BitField<bool, FunctionVariableMode::kNext, 1> {
4090   };
4091   class AsmFunctionField : public BitField<bool, AsmModuleField::kNext, 1> {};
4092   class IsSimpleParameterListField
4093       : public BitField<bool, AsmFunctionField::kNext, 1> {};
4094   class FunctionKindField
4095       : public BitField<FunctionKind, IsSimpleParameterListField::kNext, 8> {};
4096
4097   // BitFields representing the encoded information for context locals in the
4098   // ContextLocalInfoEntries part.
4099   class ContextLocalMode:      public BitField<VariableMode,         0, 3> {};
4100   class ContextLocalInitFlag:  public BitField<InitializationFlag,   3, 1> {};
4101   class ContextLocalMaybeAssignedFlag
4102       : public BitField<MaybeAssignedFlag, 4, 1> {};
4103
4104   friend class ScopeIterator;
4105 };
4106
4107
4108 // The cache for maps used by normalized (dictionary mode) objects.
4109 // Such maps do not have property descriptors, so a typical program
4110 // needs very limited number of distinct normalized maps.
4111 class NormalizedMapCache: public FixedArray {
4112  public:
4113   static Handle<NormalizedMapCache> New(Isolate* isolate);
4114
4115   MUST_USE_RESULT MaybeHandle<Map> Get(Handle<Map> fast_map,
4116                                        PropertyNormalizationMode mode);
4117   void Set(Handle<Map> fast_map, Handle<Map> normalized_map);
4118
4119   void Clear();
4120
4121   DECLARE_CAST(NormalizedMapCache)
4122
4123   static inline bool IsNormalizedMapCache(const Object* obj);
4124
4125   DECLARE_VERIFIER(NormalizedMapCache)
4126  private:
4127   static const int kEntries = 64;
4128
4129   static inline int GetIndex(Handle<Map> map);
4130
4131   // The following declarations hide base class methods.
4132   Object* get(int index);
4133   void set(int index, Object* value);
4134 };
4135
4136
4137 // ByteArray represents fixed sized byte arrays.  Used for the relocation info
4138 // that is attached to code objects.
4139 class ByteArray: public FixedArrayBase {
4140  public:
4141   inline int Size() { return RoundUp(length() + kHeaderSize, kPointerSize); }
4142
4143   // Setter and getter.
4144   inline byte get(int index);
4145   inline void set(int index, byte value);
4146
4147   // Treat contents as an int array.
4148   inline int get_int(int index);
4149
4150   static int SizeFor(int length) {
4151     return OBJECT_POINTER_ALIGN(kHeaderSize + length);
4152   }
4153   // We use byte arrays for free blocks in the heap.  Given a desired size in
4154   // bytes that is a multiple of the word size and big enough to hold a byte
4155   // array, this function returns the number of elements a byte array should
4156   // have.
4157   static int LengthFor(int size_in_bytes) {
4158     DCHECK(IsAligned(size_in_bytes, kPointerSize));
4159     DCHECK(size_in_bytes >= kHeaderSize);
4160     return size_in_bytes - kHeaderSize;
4161   }
4162
4163   // Returns data start address.
4164   inline Address GetDataStartAddress();
4165
4166   // Returns a pointer to the ByteArray object for a given data start address.
4167   static inline ByteArray* FromDataStartAddress(Address address);
4168
4169   DECLARE_CAST(ByteArray)
4170
4171   // Dispatched behavior.
4172   inline int ByteArraySize() {
4173     return SizeFor(this->length());
4174   }
4175   DECLARE_PRINTER(ByteArray)
4176   DECLARE_VERIFIER(ByteArray)
4177
4178   // Layout description.
4179   static const int kAlignedSize = OBJECT_POINTER_ALIGN(kHeaderSize);
4180
4181   // Maximal memory consumption for a single ByteArray.
4182   static const int kMaxSize = 512 * MB;
4183   // Maximal length of a single ByteArray.
4184   static const int kMaxLength = kMaxSize - kHeaderSize;
4185
4186  private:
4187   DISALLOW_IMPLICIT_CONSTRUCTORS(ByteArray);
4188 };
4189
4190
4191 // BytecodeArray represents a sequence of interpreter bytecodes.
4192 class BytecodeArray : public FixedArrayBase {
4193  public:
4194   static int SizeFor(int length) {
4195     return OBJECT_POINTER_ALIGN(kHeaderSize + length);
4196   }
4197
4198   // Setter and getter
4199   inline byte get(int index);
4200   inline void set(int index, byte value);
4201
4202   // Returns data start address.
4203   inline Address GetFirstBytecodeAddress();
4204
4205   // Accessors for frame size and the number of locals
4206   inline int frame_size() const;
4207   inline void set_frame_size(int value);
4208
4209   DECLARE_CAST(BytecodeArray)
4210
4211   // Dispatched behavior.
4212   inline int BytecodeArraySize() { return SizeFor(this->length()); }
4213
4214   DECLARE_PRINTER(BytecodeArray)
4215   DECLARE_VERIFIER(BytecodeArray)
4216
4217   void Disassemble(std::ostream& os);
4218
4219   // Layout description.
4220   static const int kFrameSizeOffset = FixedArrayBase::kHeaderSize;
4221   static const int kHeaderSize = kFrameSizeOffset + kIntSize;
4222
4223   static const int kAlignedSize = OBJECT_POINTER_ALIGN(kHeaderSize);
4224
4225   // Maximal memory consumption for a single BytecodeArray.
4226   static const int kMaxSize = 512 * MB;
4227   // Maximal length of a single BytecodeArray.
4228   static const int kMaxLength = kMaxSize - kHeaderSize;
4229
4230  private:
4231   DISALLOW_IMPLICIT_CONSTRUCTORS(BytecodeArray);
4232 };
4233
4234
4235 // FreeSpace are fixed-size free memory blocks used by the heap and GC.
4236 // They look like heap objects (are heap object tagged and have a map) so that
4237 // the heap remains iterable.  They have a size and a next pointer.
4238 // The next pointer is the raw address of the next FreeSpace object (or NULL)
4239 // in the free list.
4240 class FreeSpace: public HeapObject {
4241  public:
4242   // [size]: size of the free space including the header.
4243   inline int size() const;
4244   inline void set_size(int value);
4245
4246   inline int nobarrier_size() const;
4247   inline void nobarrier_set_size(int value);
4248
4249   inline int Size() { return size(); }
4250
4251   // Accessors for the next field.
4252   inline FreeSpace* next();
4253   inline FreeSpace** next_address();
4254   inline void set_next(FreeSpace* next);
4255
4256   inline static FreeSpace* cast(HeapObject* obj);
4257
4258   // Dispatched behavior.
4259   DECLARE_PRINTER(FreeSpace)
4260   DECLARE_VERIFIER(FreeSpace)
4261
4262   // Layout description.
4263   // Size is smi tagged when it is stored.
4264   static const int kSizeOffset = HeapObject::kHeaderSize;
4265   static const int kNextOffset = POINTER_SIZE_ALIGN(kSizeOffset + kPointerSize);
4266
4267  private:
4268   DISALLOW_IMPLICIT_CONSTRUCTORS(FreeSpace);
4269 };
4270
4271
4272 // V has parameters (Type, type, TYPE, C type, element_size)
4273 #define TYPED_ARRAYS(V) \
4274   V(Uint8, uint8, UINT8, uint8_t, 1)                                           \
4275   V(Int8, int8, INT8, int8_t, 1)                                               \
4276   V(Uint16, uint16, UINT16, uint16_t, 2)                                       \
4277   V(Int16, int16, INT16, int16_t, 2)                                           \
4278   V(Uint32, uint32, UINT32, uint32_t, 4)                                       \
4279   V(Int32, int32, INT32, int32_t, 4)                                           \
4280   V(Float32, float32, FLOAT32, float, 4)                                       \
4281   V(Float64, float64, FLOAT64, double, 8)                                      \
4282   V(Uint8Clamped, uint8_clamped, UINT8_CLAMPED, uint8_t, 1)
4283
4284
4285 class FixedTypedArrayBase: public FixedArrayBase {
4286  public:
4287   // [base_pointer]: Either points to the FixedTypedArrayBase itself or nullptr.
4288   DECL_ACCESSORS(base_pointer, Object)
4289
4290   // [external_pointer]: Contains the offset between base_pointer and the start
4291   // of the data. If the base_pointer is a nullptr, the external_pointer
4292   // therefore points to the actual backing store.
4293   DECL_ACCESSORS(external_pointer, void)
4294
4295   // Dispatched behavior.
4296   inline void FixedTypedArrayBaseIterateBody(ObjectVisitor* v);
4297
4298   template <typename StaticVisitor>
4299   inline void FixedTypedArrayBaseIterateBody();
4300
4301   DECLARE_CAST(FixedTypedArrayBase)
4302
4303   static const int kBasePointerOffset = FixedArrayBase::kHeaderSize;
4304   static const int kExternalPointerOffset = kBasePointerOffset + kPointerSize;
4305   static const int kHeaderSize =
4306       DOUBLE_POINTER_ALIGN(kExternalPointerOffset + kPointerSize);
4307
4308   static const int kDataOffset = kHeaderSize;
4309
4310   inline int size();
4311
4312   static inline int TypedArraySize(InstanceType type, int length);
4313   inline int TypedArraySize(InstanceType type);
4314
4315   // Use with care: returns raw pointer into heap.
4316   inline void* DataPtr();
4317
4318   inline int DataSize();
4319
4320  private:
4321   static inline int ElementSize(InstanceType type);
4322
4323   inline int DataSize(InstanceType type);
4324
4325   DISALLOW_IMPLICIT_CONSTRUCTORS(FixedTypedArrayBase);
4326 };
4327
4328
4329 template <class Traits>
4330 class FixedTypedArray: public FixedTypedArrayBase {
4331  public:
4332   typedef typename Traits::ElementType ElementType;
4333   static const InstanceType kInstanceType = Traits::kInstanceType;
4334
4335   DECLARE_CAST(FixedTypedArray<Traits>)
4336
4337   inline ElementType get_scalar(int index);
4338   static inline Handle<Object> get(Handle<FixedTypedArray> array, int index);
4339   inline void set(int index, ElementType value);
4340
4341   static inline ElementType from_int(int value);
4342   static inline ElementType from_double(double value);
4343
4344   // This accessor applies the correct conversion from Smi, HeapNumber
4345   // and undefined.
4346   void SetValue(uint32_t index, Object* value);
4347
4348   DECLARE_PRINTER(FixedTypedArray)
4349   DECLARE_VERIFIER(FixedTypedArray)
4350
4351  private:
4352   DISALLOW_IMPLICIT_CONSTRUCTORS(FixedTypedArray);
4353 };
4354
4355 #define FIXED_TYPED_ARRAY_TRAITS(Type, type, TYPE, elementType, size)         \
4356   class Type##ArrayTraits {                                                   \
4357    public:   /* NOLINT */                                                     \
4358     typedef elementType ElementType;                                          \
4359     static const InstanceType kInstanceType = FIXED_##TYPE##_ARRAY_TYPE;      \
4360     static const char* Designator() { return #type " array"; }                \
4361     static inline Handle<Object> ToHandle(Isolate* isolate,                   \
4362                                           elementType scalar);                \
4363     static inline elementType defaultValue();                                 \
4364   };                                                                          \
4365                                                                               \
4366   typedef FixedTypedArray<Type##ArrayTraits> Fixed##Type##Array;
4367
4368 TYPED_ARRAYS(FIXED_TYPED_ARRAY_TRAITS)
4369
4370 #undef FIXED_TYPED_ARRAY_TRAITS
4371
4372
4373 // DeoptimizationInputData is a fixed array used to hold the deoptimization
4374 // data for code generated by the Hydrogen/Lithium compiler.  It also
4375 // contains information about functions that were inlined.  If N different
4376 // functions were inlined then first N elements of the literal array will
4377 // contain these functions.
4378 //
4379 // It can be empty.
4380 class DeoptimizationInputData: public FixedArray {
4381  public:
4382   // Layout description.  Indices in the array.
4383   static const int kTranslationByteArrayIndex = 0;
4384   static const int kInlinedFunctionCountIndex = 1;
4385   static const int kLiteralArrayIndex = 2;
4386   static const int kOsrAstIdIndex = 3;
4387   static const int kOsrPcOffsetIndex = 4;
4388   static const int kOptimizationIdIndex = 5;
4389   static const int kSharedFunctionInfoIndex = 6;
4390   static const int kWeakCellCacheIndex = 7;
4391   static const int kFirstDeoptEntryIndex = 8;
4392
4393   // Offsets of deopt entry elements relative to the start of the entry.
4394   static const int kAstIdRawOffset = 0;
4395   static const int kTranslationIndexOffset = 1;
4396   static const int kArgumentsStackHeightOffset = 2;
4397   static const int kPcOffset = 3;
4398   static const int kDeoptEntrySize = 4;
4399
4400   // Simple element accessors.
4401 #define DEFINE_ELEMENT_ACCESSORS(name, type)      \
4402   type* name() {                                  \
4403     return type::cast(get(k##name##Index));       \
4404   }                                               \
4405   void Set##name(type* value) {                   \
4406     set(k##name##Index, value);                   \
4407   }
4408
4409   DEFINE_ELEMENT_ACCESSORS(TranslationByteArray, ByteArray)
4410   DEFINE_ELEMENT_ACCESSORS(InlinedFunctionCount, Smi)
4411   DEFINE_ELEMENT_ACCESSORS(LiteralArray, FixedArray)
4412   DEFINE_ELEMENT_ACCESSORS(OsrAstId, Smi)
4413   DEFINE_ELEMENT_ACCESSORS(OsrPcOffset, Smi)
4414   DEFINE_ELEMENT_ACCESSORS(OptimizationId, Smi)
4415   DEFINE_ELEMENT_ACCESSORS(SharedFunctionInfo, Object)
4416   DEFINE_ELEMENT_ACCESSORS(WeakCellCache, Object)
4417
4418 #undef DEFINE_ELEMENT_ACCESSORS
4419
4420   // Accessors for elements of the ith deoptimization entry.
4421 #define DEFINE_ENTRY_ACCESSORS(name, type)                      \
4422   type* name(int i) {                                           \
4423     return type::cast(get(IndexForEntry(i) + k##name##Offset)); \
4424   }                                                             \
4425   void Set##name(int i, type* value) {                          \
4426     set(IndexForEntry(i) + k##name##Offset, value);             \
4427   }
4428
4429   DEFINE_ENTRY_ACCESSORS(AstIdRaw, Smi)
4430   DEFINE_ENTRY_ACCESSORS(TranslationIndex, Smi)
4431   DEFINE_ENTRY_ACCESSORS(ArgumentsStackHeight, Smi)
4432   DEFINE_ENTRY_ACCESSORS(Pc, Smi)
4433
4434 #undef DEFINE_DEOPT_ENTRY_ACCESSORS
4435
4436   BailoutId AstId(int i) {
4437     return BailoutId(AstIdRaw(i)->value());
4438   }
4439
4440   void SetAstId(int i, BailoutId value) {
4441     SetAstIdRaw(i, Smi::FromInt(value.ToInt()));
4442   }
4443
4444   int DeoptCount() {
4445     return (length() - kFirstDeoptEntryIndex) / kDeoptEntrySize;
4446   }
4447
4448   // Allocates a DeoptimizationInputData.
4449   static Handle<DeoptimizationInputData> New(Isolate* isolate,
4450                                              int deopt_entry_count,
4451                                              PretenureFlag pretenure);
4452
4453   DECLARE_CAST(DeoptimizationInputData)
4454
4455 #ifdef ENABLE_DISASSEMBLER
4456   void DeoptimizationInputDataPrint(std::ostream& os);  // NOLINT
4457 #endif
4458
4459  private:
4460   static int IndexForEntry(int i) {
4461     return kFirstDeoptEntryIndex + (i * kDeoptEntrySize);
4462   }
4463
4464
4465   static int LengthFor(int entry_count) { return IndexForEntry(entry_count); }
4466 };
4467
4468
4469 // DeoptimizationOutputData is a fixed array used to hold the deoptimization
4470 // data for code generated by the full compiler.
4471 // The format of the these objects is
4472 //   [i * 2]: Ast ID for ith deoptimization.
4473 //   [i * 2 + 1]: PC and state of ith deoptimization
4474 class DeoptimizationOutputData: public FixedArray {
4475  public:
4476   int DeoptPoints() { return length() / 2; }
4477
4478   BailoutId AstId(int index) {
4479     return BailoutId(Smi::cast(get(index * 2))->value());
4480   }
4481
4482   void SetAstId(int index, BailoutId id) {
4483     set(index * 2, Smi::FromInt(id.ToInt()));
4484   }
4485
4486   Smi* PcAndState(int index) { return Smi::cast(get(1 + index * 2)); }
4487   void SetPcAndState(int index, Smi* offset) { set(1 + index * 2, offset); }
4488
4489   static int LengthOfFixedArray(int deopt_points) {
4490     return deopt_points * 2;
4491   }
4492
4493   // Allocates a DeoptimizationOutputData.
4494   static Handle<DeoptimizationOutputData> New(Isolate* isolate,
4495                                               int number_of_deopt_points,
4496                                               PretenureFlag pretenure);
4497
4498   DECLARE_CAST(DeoptimizationOutputData)
4499
4500 #if defined(OBJECT_PRINT) || defined(ENABLE_DISASSEMBLER)
4501   void DeoptimizationOutputDataPrint(std::ostream& os);  // NOLINT
4502 #endif
4503 };
4504
4505
4506 // HandlerTable is a fixed array containing entries for exception handlers in
4507 // the code object it is associated with. The tables comes in two flavors:
4508 // 1) Based on ranges: Used for unoptimized code. Contains one entry per
4509 //    exception handler and a range representing the try-block covered by that
4510 //    handler. Layout looks as follows:
4511 //      [ range-start , range-end , handler-offset , stack-depth ]
4512 // 2) Based on return addresses: Used for turbofanned code. Contains one entry
4513 //    per call-site that could throw an exception. Layout looks as follows:
4514 //      [ return-address-offset , handler-offset ]
4515 class HandlerTable : public FixedArray {
4516  public:
4517   // Conservative prediction whether a given handler will locally catch an
4518   // exception or cause a re-throw to outside the code boundary. Since this is
4519   // undecidable it is merely an approximation (e.g. useful for debugger).
4520   enum CatchPrediction { UNCAUGHT, CAUGHT };
4521
4522   // Accessors for handler table based on ranges.
4523   void SetRangeStart(int index, int value) {
4524     set(index * kRangeEntrySize + kRangeStartIndex, Smi::FromInt(value));
4525   }
4526   void SetRangeEnd(int index, int value) {
4527     set(index * kRangeEntrySize + kRangeEndIndex, Smi::FromInt(value));
4528   }
4529   void SetRangeHandler(int index, int offset, CatchPrediction prediction) {
4530     int value = HandlerOffsetField::encode(offset) |
4531                 HandlerPredictionField::encode(prediction);
4532     set(index * kRangeEntrySize + kRangeHandlerIndex, Smi::FromInt(value));
4533   }
4534   void SetRangeDepth(int index, int value) {
4535     set(index * kRangeEntrySize + kRangeDepthIndex, Smi::FromInt(value));
4536   }
4537
4538   // Accessors for handler table based on return addresses.
4539   void SetReturnOffset(int index, int value) {
4540     set(index * kReturnEntrySize + kReturnOffsetIndex, Smi::FromInt(value));
4541   }
4542   void SetReturnHandler(int index, int offset, CatchPrediction prediction) {
4543     int value = HandlerOffsetField::encode(offset) |
4544                 HandlerPredictionField::encode(prediction);
4545     set(index * kReturnEntrySize + kReturnHandlerIndex, Smi::FromInt(value));
4546   }
4547
4548   // Lookup handler in a table based on ranges.
4549   int LookupRange(int pc_offset, int* stack_depth, CatchPrediction* prediction);
4550
4551   // Lookup handler in a table based on return addresses.
4552   int LookupReturn(int pc_offset, CatchPrediction* prediction);
4553
4554   // Returns the required length of the underlying fixed array.
4555   static int LengthForRange(int entries) { return entries * kRangeEntrySize; }
4556   static int LengthForReturn(int entries) { return entries * kReturnEntrySize; }
4557
4558   DECLARE_CAST(HandlerTable)
4559
4560 #if defined(OBJECT_PRINT) || defined(ENABLE_DISASSEMBLER)
4561   void HandlerTableRangePrint(std::ostream& os);   // NOLINT
4562   void HandlerTableReturnPrint(std::ostream& os);  // NOLINT
4563 #endif
4564
4565  private:
4566   // Layout description for handler table based on ranges.
4567   static const int kRangeStartIndex = 0;
4568   static const int kRangeEndIndex = 1;
4569   static const int kRangeHandlerIndex = 2;
4570   static const int kRangeDepthIndex = 3;
4571   static const int kRangeEntrySize = 4;
4572
4573   // Layout description for handler table based on return addresses.
4574   static const int kReturnOffsetIndex = 0;
4575   static const int kReturnHandlerIndex = 1;
4576   static const int kReturnEntrySize = 2;
4577
4578   // Encoding of the {handler} field.
4579   class HandlerPredictionField : public BitField<CatchPrediction, 0, 1> {};
4580   class HandlerOffsetField : public BitField<int, 1, 30> {};
4581 };
4582
4583
4584 // Code describes objects with on-the-fly generated machine code.
4585 class Code: public HeapObject {
4586  public:
4587   // Opaque data type for encapsulating code flags like kind, inline
4588   // cache state, and arguments count.
4589   typedef uint32_t Flags;
4590
4591 #define NON_IC_KIND_LIST(V) \
4592   V(FUNCTION)               \
4593   V(OPTIMIZED_FUNCTION)     \
4594   V(STUB)                   \
4595   V(HANDLER)                \
4596   V(BUILTIN)                \
4597   V(REGEXP)
4598
4599 #define IC_KIND_LIST(V) \
4600   V(LOAD_IC)            \
4601   V(KEYED_LOAD_IC)      \
4602   V(CALL_IC)            \
4603   V(STORE_IC)           \
4604   V(KEYED_STORE_IC)     \
4605   V(BINARY_OP_IC)       \
4606   V(COMPARE_IC)         \
4607   V(COMPARE_NIL_IC)     \
4608   V(TO_BOOLEAN_IC)
4609
4610 #define CODE_KIND_LIST(V) \
4611   NON_IC_KIND_LIST(V)     \
4612   IC_KIND_LIST(V)
4613
4614   enum Kind {
4615 #define DEFINE_CODE_KIND_ENUM(name) name,
4616     CODE_KIND_LIST(DEFINE_CODE_KIND_ENUM)
4617 #undef DEFINE_CODE_KIND_ENUM
4618     NUMBER_OF_KINDS
4619   };
4620
4621   // No more than 16 kinds. The value is currently encoded in four bits in
4622   // Flags.
4623   STATIC_ASSERT(NUMBER_OF_KINDS <= 16);
4624
4625   static const char* Kind2String(Kind kind);
4626
4627   // Types of stubs.
4628   enum StubType {
4629     NORMAL,
4630     FAST
4631   };
4632
4633   static const int kPrologueOffsetNotSet = -1;
4634
4635 #ifdef ENABLE_DISASSEMBLER
4636   // Printing
4637   static const char* ICState2String(InlineCacheState state);
4638   static const char* StubType2String(StubType type);
4639   static void PrintExtraICState(std::ostream& os,  // NOLINT
4640                                 Kind kind, ExtraICState extra);
4641   void Disassemble(const char* name, std::ostream& os);  // NOLINT
4642 #endif  // ENABLE_DISASSEMBLER
4643
4644   // [instruction_size]: Size of the native instructions
4645   inline int instruction_size() const;
4646   inline void set_instruction_size(int value);
4647
4648   // [relocation_info]: Code relocation information
4649   DECL_ACCESSORS(relocation_info, ByteArray)
4650   void InvalidateRelocation();
4651   void InvalidateEmbeddedObjects();
4652
4653   // [handler_table]: Fixed array containing offsets of exception handlers.
4654   DECL_ACCESSORS(handler_table, FixedArray)
4655
4656   // [deoptimization_data]: Array containing data for deopt.
4657   DECL_ACCESSORS(deoptimization_data, FixedArray)
4658
4659   // [raw_type_feedback_info]: This field stores various things, depending on
4660   // the kind of the code object.
4661   //   FUNCTION           => type feedback information.
4662   //   STUB and ICs       => major/minor key as Smi.
4663   DECL_ACCESSORS(raw_type_feedback_info, Object)
4664   inline Object* type_feedback_info();
4665   inline void set_type_feedback_info(
4666       Object* value, WriteBarrierMode mode = UPDATE_WRITE_BARRIER);
4667   inline uint32_t stub_key();
4668   inline void set_stub_key(uint32_t key);
4669
4670   // [next_code_link]: Link for lists of optimized or deoptimized code.
4671   // Note that storage for this field is overlapped with typefeedback_info.
4672   DECL_ACCESSORS(next_code_link, Object)
4673
4674   // [gc_metadata]: Field used to hold GC related metadata. The contents of this
4675   // field does not have to be traced during garbage collection since
4676   // it is only used by the garbage collector itself.
4677   DECL_ACCESSORS(gc_metadata, Object)
4678
4679   // [ic_age]: Inline caching age: the value of the Heap::global_ic_age
4680   // at the moment when this object was created.
4681   inline void set_ic_age(int count);
4682   inline int ic_age() const;
4683
4684   // [prologue_offset]: Offset of the function prologue, used for aging
4685   // FUNCTIONs and OPTIMIZED_FUNCTIONs.
4686   inline int prologue_offset() const;
4687   inline void set_prologue_offset(int offset);
4688
4689   // [constant_pool offset]: Offset of the constant pool.
4690   // Valid for FLAG_enable_embedded_constant_pool only
4691   inline int constant_pool_offset() const;
4692   inline void set_constant_pool_offset(int offset);
4693
4694   // Unchecked accessors to be used during GC.
4695   inline ByteArray* unchecked_relocation_info();
4696
4697   inline int relocation_size();
4698
4699   // [flags]: Various code flags.
4700   inline Flags flags();
4701   inline void set_flags(Flags flags);
4702
4703   // [flags]: Access to specific code flags.
4704   inline Kind kind();
4705   inline InlineCacheState ic_state();  // Only valid for IC stubs.
4706   inline ExtraICState extra_ic_state();  // Only valid for IC stubs.
4707
4708   inline StubType type();  // Only valid for monomorphic IC stubs.
4709
4710   // Testers for IC stub kinds.
4711   inline bool is_inline_cache_stub();
4712   inline bool is_debug_stub();
4713   inline bool is_handler() { return kind() == HANDLER; }
4714   inline bool is_load_stub() { return kind() == LOAD_IC; }
4715   inline bool is_keyed_load_stub() { return kind() == KEYED_LOAD_IC; }
4716   inline bool is_store_stub() { return kind() == STORE_IC; }
4717   inline bool is_keyed_store_stub() { return kind() == KEYED_STORE_IC; }
4718   inline bool is_call_stub() { return kind() == CALL_IC; }
4719   inline bool is_binary_op_stub() { return kind() == BINARY_OP_IC; }
4720   inline bool is_compare_ic_stub() { return kind() == COMPARE_IC; }
4721   inline bool is_compare_nil_ic_stub() { return kind() == COMPARE_NIL_IC; }
4722   inline bool is_to_boolean_ic_stub() { return kind() == TO_BOOLEAN_IC; }
4723   inline bool is_keyed_stub();
4724   inline bool is_optimized_code() { return kind() == OPTIMIZED_FUNCTION; }
4725   inline bool embeds_maps_weakly() {
4726     Kind k = kind();
4727     return (k == LOAD_IC || k == STORE_IC || k == KEYED_LOAD_IC ||
4728             k == KEYED_STORE_IC || k == COMPARE_NIL_IC) &&
4729            ic_state() == MONOMORPHIC;
4730   }
4731
4732   inline bool IsCodeStubOrIC();
4733
4734   inline void set_raw_kind_specific_flags1(int value);
4735   inline void set_raw_kind_specific_flags2(int value);
4736
4737   // [is_crankshafted]: For kind STUB or ICs, tells whether or not a code
4738   // object was generated by either the hydrogen or the TurboFan optimizing
4739   // compiler (but it may not be an optimized function).
4740   inline bool is_crankshafted();
4741   inline bool is_hydrogen_stub();  // Crankshafted, but not a function.
4742   inline void set_is_crankshafted(bool value);
4743
4744   // [is_turbofanned]: For kind STUB or OPTIMIZED_FUNCTION, tells whether the
4745   // code object was generated by the TurboFan optimizing compiler.
4746   inline bool is_turbofanned();
4747   inline void set_is_turbofanned(bool value);
4748
4749   // [can_have_weak_objects]: For kind OPTIMIZED_FUNCTION, tells whether the
4750   // embedded objects in code should be treated weakly.
4751   inline bool can_have_weak_objects();
4752   inline void set_can_have_weak_objects(bool value);
4753
4754   // [has_deoptimization_support]: For FUNCTION kind, tells if it has
4755   // deoptimization support.
4756   inline bool has_deoptimization_support();
4757   inline void set_has_deoptimization_support(bool value);
4758
4759   // [has_debug_break_slots]: For FUNCTION kind, tells if it has
4760   // been compiled with debug break slots.
4761   inline bool has_debug_break_slots();
4762   inline void set_has_debug_break_slots(bool value);
4763
4764   // [has_reloc_info_for_serialization]: For FUNCTION kind, tells if its
4765   // reloc info includes runtime and external references to support
4766   // serialization/deserialization.
4767   inline bool has_reloc_info_for_serialization();
4768   inline void set_has_reloc_info_for_serialization(bool value);
4769
4770   // [allow_osr_at_loop_nesting_level]: For FUNCTION kind, tells for
4771   // how long the function has been marked for OSR and therefore which
4772   // level of loop nesting we are willing to do on-stack replacement
4773   // for.
4774   inline void set_allow_osr_at_loop_nesting_level(int level);
4775   inline int allow_osr_at_loop_nesting_level();
4776
4777   // [profiler_ticks]: For FUNCTION kind, tells for how many profiler ticks
4778   // the code object was seen on the stack with no IC patching going on.
4779   inline int profiler_ticks();
4780   inline void set_profiler_ticks(int ticks);
4781
4782   // [builtin_index]: For BUILTIN kind, tells which builtin index it has.
4783   // For builtins, tells which builtin index it has.
4784   // Note that builtins can have a code kind other than BUILTIN, which means
4785   // that for arbitrary code objects, this index value may be random garbage.
4786   // To verify in that case, compare the code object to the indexed builtin.
4787   inline int builtin_index();
4788   inline void set_builtin_index(int id);
4789
4790   // [stack_slots]: For kind OPTIMIZED_FUNCTION, the number of stack slots
4791   // reserved in the code prologue.
4792   inline unsigned stack_slots();
4793   inline void set_stack_slots(unsigned slots);
4794
4795   // [safepoint_table_start]: For kind OPTIMIZED_FUNCTION, the offset in
4796   // the instruction stream where the safepoint table starts.
4797   inline unsigned safepoint_table_offset();
4798   inline void set_safepoint_table_offset(unsigned offset);
4799
4800   // [back_edge_table_start]: For kind FUNCTION, the offset in the
4801   // instruction stream where the back edge table starts.
4802   inline unsigned back_edge_table_offset();
4803   inline void set_back_edge_table_offset(unsigned offset);
4804
4805   inline bool back_edges_patched_for_osr();
4806
4807   // [to_boolean_foo]: For kind TO_BOOLEAN_IC tells what state the stub is in.
4808   inline uint16_t to_boolean_state();
4809
4810   // [has_function_cache]: For kind STUB tells whether there is a function
4811   // cache is passed to the stub.
4812   inline bool has_function_cache();
4813   inline void set_has_function_cache(bool flag);
4814
4815
4816   // [marked_for_deoptimization]: For kind OPTIMIZED_FUNCTION tells whether
4817   // the code is going to be deoptimized because of dead embedded maps.
4818   inline bool marked_for_deoptimization();
4819   inline void set_marked_for_deoptimization(bool flag);
4820
4821   // [constant_pool]: The constant pool for this function.
4822   inline Address constant_pool();
4823
4824   // Get the safepoint entry for the given pc.
4825   SafepointEntry GetSafepointEntry(Address pc);
4826
4827   // Find an object in a stub with a specified map
4828   Object* FindNthObject(int n, Map* match_map);
4829
4830   // Find the first allocation site in an IC stub.
4831   AllocationSite* FindFirstAllocationSite();
4832
4833   // Find the first map in an IC stub.
4834   Map* FindFirstMap();
4835   void FindAllMaps(MapHandleList* maps);
4836
4837   // Find the first handler in an IC stub.
4838   Code* FindFirstHandler();
4839
4840   // Find |length| handlers and put them into |code_list|. Returns false if not
4841   // enough handlers can be found.
4842   bool FindHandlers(CodeHandleList* code_list, int length = -1);
4843
4844   // Find the handler for |map|.
4845   MaybeHandle<Code> FindHandlerForMap(Map* map);
4846
4847   // Find the first name in an IC stub.
4848   Name* FindFirstName();
4849
4850   class FindAndReplacePattern;
4851   // For each (map-to-find, object-to-replace) pair in the pattern, this
4852   // function replaces the corresponding placeholder in the code with the
4853   // object-to-replace. The function assumes that pairs in the pattern come in
4854   // the same order as the placeholders in the code.
4855   // If the placeholder is a weak cell, then the value of weak cell is matched
4856   // against the map-to-find.
4857   void FindAndReplace(const FindAndReplacePattern& pattern);
4858
4859   // The entire code object including its header is copied verbatim to the
4860   // snapshot so that it can be written in one, fast, memcpy during
4861   // deserialization. The deserializer will overwrite some pointers, rather
4862   // like a runtime linker, but the random allocation addresses used in the
4863   // mksnapshot process would still be present in the unlinked snapshot data,
4864   // which would make snapshot production non-reproducible. This method wipes
4865   // out the to-be-overwritten header data for reproducible snapshots.
4866   inline void WipeOutHeader();
4867
4868   // Flags operations.
4869   static inline Flags ComputeFlags(
4870       Kind kind, InlineCacheState ic_state = UNINITIALIZED,
4871       ExtraICState extra_ic_state = kNoExtraICState, StubType type = NORMAL,
4872       CacheHolderFlag holder = kCacheOnReceiver);
4873
4874   static inline Flags ComputeMonomorphicFlags(
4875       Kind kind, ExtraICState extra_ic_state = kNoExtraICState,
4876       CacheHolderFlag holder = kCacheOnReceiver, StubType type = NORMAL);
4877
4878   static inline Flags ComputeHandlerFlags(
4879       Kind handler_kind, StubType type = NORMAL,
4880       CacheHolderFlag holder = kCacheOnReceiver);
4881
4882   static inline InlineCacheState ExtractICStateFromFlags(Flags flags);
4883   static inline StubType ExtractTypeFromFlags(Flags flags);
4884   static inline CacheHolderFlag ExtractCacheHolderFromFlags(Flags flags);
4885   static inline Kind ExtractKindFromFlags(Flags flags);
4886   static inline ExtraICState ExtractExtraICStateFromFlags(Flags flags);
4887
4888   static inline Flags RemoveTypeFromFlags(Flags flags);
4889   static inline Flags RemoveTypeAndHolderFromFlags(Flags flags);
4890
4891   // Convert a target address into a code object.
4892   static inline Code* GetCodeFromTargetAddress(Address address);
4893
4894   // Convert an entry address into an object.
4895   static inline Object* GetObjectFromEntryAddress(Address location_of_address);
4896
4897   // Returns the address of the first instruction.
4898   inline byte* instruction_start();
4899
4900   // Returns the address right after the last instruction.
4901   inline byte* instruction_end();
4902
4903   // Returns the size of the instructions, padding, and relocation information.
4904   inline int body_size();
4905
4906   // Returns the address of the first relocation info (read backwards!).
4907   inline byte* relocation_start();
4908
4909   // Code entry point.
4910   inline byte* entry();
4911
4912   // Returns true if pc is inside this object's instructions.
4913   inline bool contains(byte* pc);
4914
4915   // Relocate the code by delta bytes. Called to signal that this code
4916   // object has been moved by delta bytes.
4917   void Relocate(intptr_t delta);
4918
4919   // Migrate code described by desc.
4920   void CopyFrom(const CodeDesc& desc);
4921
4922   // Returns the object size for a given body (used for allocation).
4923   static int SizeFor(int body_size) {
4924     DCHECK_SIZE_TAG_ALIGNED(body_size);
4925     return RoundUp(kHeaderSize + body_size, kCodeAlignment);
4926   }
4927
4928   // Calculate the size of the code object to report for log events. This takes
4929   // the layout of the code object into account.
4930   int ExecutableSize() {
4931     // Check that the assumptions about the layout of the code object holds.
4932     DCHECK_EQ(static_cast<int>(instruction_start() - address()),
4933               Code::kHeaderSize);
4934     return instruction_size() + Code::kHeaderSize;
4935   }
4936
4937   // Locating source position.
4938   int SourcePosition(Address pc);
4939   int SourceStatementPosition(Address pc);
4940
4941   DECLARE_CAST(Code)
4942
4943   // Dispatched behavior.
4944   int CodeSize() { return SizeFor(body_size()); }
4945   inline void CodeIterateBody(ObjectVisitor* v);
4946
4947   template<typename StaticVisitor>
4948   inline void CodeIterateBody(Heap* heap);
4949
4950   DECLARE_PRINTER(Code)
4951   DECLARE_VERIFIER(Code)
4952
4953   void ClearInlineCaches();
4954   void ClearInlineCaches(Kind kind);
4955
4956   BailoutId TranslatePcOffsetToAstId(uint32_t pc_offset);
4957   uint32_t TranslateAstIdToPcOffset(BailoutId ast_id);
4958
4959 #define DECLARE_CODE_AGE_ENUM(X) k##X##CodeAge,
4960   enum Age {
4961     kToBeExecutedOnceCodeAge = -3,
4962     kNotExecutedCodeAge = -2,
4963     kExecutedOnceCodeAge = -1,
4964     kNoAgeCodeAge = 0,
4965     CODE_AGE_LIST(DECLARE_CODE_AGE_ENUM)
4966     kAfterLastCodeAge,
4967     kFirstCodeAge = kToBeExecutedOnceCodeAge,
4968     kLastCodeAge = kAfterLastCodeAge - 1,
4969     kCodeAgeCount = kAfterLastCodeAge - kFirstCodeAge - 1,
4970     kIsOldCodeAge = kSexagenarianCodeAge,
4971     kPreAgedCodeAge = kIsOldCodeAge - 1
4972   };
4973 #undef DECLARE_CODE_AGE_ENUM
4974
4975   // Code aging.  Indicates how many full GCs this code has survived without
4976   // being entered through the prologue.  Used to determine when it is
4977   // relatively safe to flush this code object and replace it with the lazy
4978   // compilation stub.
4979   static void MakeCodeAgeSequenceYoung(byte* sequence, Isolate* isolate);
4980   static void MarkCodeAsExecuted(byte* sequence, Isolate* isolate);
4981   void MakeYoung(Isolate* isolate);
4982   void MarkToBeExecutedOnce(Isolate* isolate);
4983   void MakeOlder(MarkingParity);
4984   static bool IsYoungSequence(Isolate* isolate, byte* sequence);
4985   bool IsOld();
4986   Age GetAge();
4987   static inline Code* GetPreAgedCodeAgeStub(Isolate* isolate) {
4988     return GetCodeAgeStub(isolate, kNotExecutedCodeAge, NO_MARKING_PARITY);
4989   }
4990
4991   void PrintDeoptLocation(FILE* out, Address pc);
4992   bool CanDeoptAt(Address pc);
4993
4994 #ifdef VERIFY_HEAP
4995   void VerifyEmbeddedObjectsDependency();
4996 #endif
4997
4998 #ifdef DEBUG
4999   enum VerifyMode { kNoContextSpecificPointers, kNoContextRetainingPointers };
5000   void VerifyEmbeddedObjects(VerifyMode mode = kNoContextRetainingPointers);
5001   static void VerifyRecompiledCode(Code* old_code, Code* new_code);
5002 #endif  // DEBUG
5003
5004   inline bool CanContainWeakObjects() {
5005     // is_turbofanned() implies !can_have_weak_objects().
5006     DCHECK(!is_optimized_code() || !is_turbofanned() ||
5007            !can_have_weak_objects());
5008     return is_optimized_code() && can_have_weak_objects();
5009   }
5010
5011   inline bool IsWeakObject(Object* object) {
5012     return (CanContainWeakObjects() && IsWeakObjectInOptimizedCode(object));
5013   }
5014
5015   static inline bool IsWeakObjectInOptimizedCode(Object* object);
5016
5017   static Handle<WeakCell> WeakCellFor(Handle<Code> code);
5018   WeakCell* CachedWeakCell();
5019
5020   // Max loop nesting marker used to postpose OSR. We don't take loop
5021   // nesting that is deeper than 5 levels into account.
5022   static const int kMaxLoopNestingMarker = 6;
5023
5024   static const int kConstantPoolSize =
5025       FLAG_enable_embedded_constant_pool ? kIntSize : 0;
5026
5027   // Layout description.
5028   static const int kRelocationInfoOffset = HeapObject::kHeaderSize;
5029   static const int kHandlerTableOffset = kRelocationInfoOffset + kPointerSize;
5030   static const int kDeoptimizationDataOffset =
5031       kHandlerTableOffset + kPointerSize;
5032   // For FUNCTION kind, we store the type feedback info here.
5033   static const int kTypeFeedbackInfoOffset =
5034       kDeoptimizationDataOffset + kPointerSize;
5035   static const int kNextCodeLinkOffset = kTypeFeedbackInfoOffset + kPointerSize;
5036   static const int kGCMetadataOffset = kNextCodeLinkOffset + kPointerSize;
5037   static const int kInstructionSizeOffset = kGCMetadataOffset + kPointerSize;
5038   static const int kICAgeOffset = kInstructionSizeOffset + kIntSize;
5039   static const int kFlagsOffset = kICAgeOffset + kIntSize;
5040   static const int kKindSpecificFlags1Offset = kFlagsOffset + kIntSize;
5041   static const int kKindSpecificFlags2Offset =
5042       kKindSpecificFlags1Offset + kIntSize;
5043   // Note: We might be able to squeeze this into the flags above.
5044   static const int kPrologueOffset = kKindSpecificFlags2Offset + kIntSize;
5045   static const int kConstantPoolOffset = kPrologueOffset + kIntSize;
5046   static const int kHeaderPaddingStart =
5047       kConstantPoolOffset + kConstantPoolSize;
5048
5049   // Add padding to align the instruction start following right after
5050   // the Code object header.
5051   static const int kHeaderSize =
5052       (kHeaderPaddingStart + kCodeAlignmentMask) & ~kCodeAlignmentMask;
5053
5054   // Byte offsets within kKindSpecificFlags1Offset.
5055   static const int kFullCodeFlags = kKindSpecificFlags1Offset;
5056   class FullCodeFlagsHasDeoptimizationSupportField:
5057       public BitField<bool, 0, 1> {};  // NOLINT
5058   class FullCodeFlagsHasDebugBreakSlotsField: public BitField<bool, 1, 1> {};
5059   class FullCodeFlagsHasRelocInfoForSerialization
5060       : public BitField<bool, 2, 1> {};
5061   // Bit 3 in this bitfield is unused.
5062   class ProfilerTicksField : public BitField<int, 4, 28> {};
5063
5064   // Flags layout.  BitField<type, shift, size>.
5065   class ICStateField : public BitField<InlineCacheState, 0, 4> {};
5066   class TypeField : public BitField<StubType, 4, 1> {};
5067   class CacheHolderField : public BitField<CacheHolderFlag, 5, 2> {};
5068   class KindField : public BitField<Kind, 7, 4> {};
5069   class ExtraICStateField: public BitField<ExtraICState, 11,
5070       PlatformSmiTagging::kSmiValueSize - 11 + 1> {};  // NOLINT
5071
5072   // KindSpecificFlags1 layout (STUB and OPTIMIZED_FUNCTION)
5073   static const int kStackSlotsFirstBit = 0;
5074   static const int kStackSlotsBitCount = 24;
5075   static const int kHasFunctionCacheBit =
5076       kStackSlotsFirstBit + kStackSlotsBitCount;
5077   static const int kMarkedForDeoptimizationBit = kHasFunctionCacheBit + 1;
5078   static const int kIsTurbofannedBit = kMarkedForDeoptimizationBit + 1;
5079   static const int kCanHaveWeakObjects = kIsTurbofannedBit + 1;
5080
5081   STATIC_ASSERT(kStackSlotsFirstBit + kStackSlotsBitCount <= 32);
5082   STATIC_ASSERT(kCanHaveWeakObjects + 1 <= 32);
5083
5084   class StackSlotsField: public BitField<int,
5085       kStackSlotsFirstBit, kStackSlotsBitCount> {};  // NOLINT
5086   class HasFunctionCacheField : public BitField<bool, kHasFunctionCacheBit, 1> {
5087   };  // NOLINT
5088   class MarkedForDeoptimizationField
5089       : public BitField<bool, kMarkedForDeoptimizationBit, 1> {};   // NOLINT
5090   class IsTurbofannedField : public BitField<bool, kIsTurbofannedBit, 1> {
5091   };  // NOLINT
5092   class CanHaveWeakObjectsField
5093       : public BitField<bool, kCanHaveWeakObjects, 1> {};  // NOLINT
5094
5095   // KindSpecificFlags2 layout (ALL)
5096   static const int kIsCrankshaftedBit = 0;
5097   class IsCrankshaftedField: public BitField<bool,
5098       kIsCrankshaftedBit, 1> {};  // NOLINT
5099
5100   // KindSpecificFlags2 layout (STUB and OPTIMIZED_FUNCTION)
5101   static const int kSafepointTableOffsetFirstBit = kIsCrankshaftedBit + 1;
5102   static const int kSafepointTableOffsetBitCount = 30;
5103
5104   STATIC_ASSERT(kSafepointTableOffsetFirstBit +
5105                 kSafepointTableOffsetBitCount <= 32);
5106   STATIC_ASSERT(1 + kSafepointTableOffsetBitCount <= 32);
5107
5108   class SafepointTableOffsetField: public BitField<int,
5109       kSafepointTableOffsetFirstBit,
5110       kSafepointTableOffsetBitCount> {};  // NOLINT
5111
5112   // KindSpecificFlags2 layout (FUNCTION)
5113   class BackEdgeTableOffsetField: public BitField<int,
5114       kIsCrankshaftedBit + 1, 27> {};  // NOLINT
5115   class AllowOSRAtLoopNestingLevelField: public BitField<int,
5116       kIsCrankshaftedBit + 1 + 27, 4> {};  // NOLINT
5117   STATIC_ASSERT(AllowOSRAtLoopNestingLevelField::kMax >= kMaxLoopNestingMarker);
5118
5119   static const int kArgumentsBits = 16;
5120   static const int kMaxArguments = (1 << kArgumentsBits) - 1;
5121
5122   // This constant should be encodable in an ARM instruction.
5123   static const int kFlagsNotUsedInLookup =
5124       TypeField::kMask | CacheHolderField::kMask;
5125
5126  private:
5127   friend class RelocIterator;
5128   friend class Deoptimizer;  // For FindCodeAgeSequence.
5129
5130   void ClearInlineCaches(Kind* kind);
5131
5132   // Code aging
5133   byte* FindCodeAgeSequence();
5134   static void GetCodeAgeAndParity(Code* code, Age* age,
5135                                   MarkingParity* parity);
5136   static void GetCodeAgeAndParity(Isolate* isolate, byte* sequence, Age* age,
5137                                   MarkingParity* parity);
5138   static Code* GetCodeAgeStub(Isolate* isolate, Age age, MarkingParity parity);
5139
5140   // Code aging -- platform-specific
5141   static void PatchPlatformCodeAge(Isolate* isolate,
5142                                    byte* sequence, Age age,
5143                                    MarkingParity parity);
5144
5145   DISALLOW_IMPLICIT_CONSTRUCTORS(Code);
5146 };
5147
5148
5149 // This class describes the layout of dependent codes array of a map. The
5150 // array is partitioned into several groups of dependent codes. Each group
5151 // contains codes with the same dependency on the map. The array has the
5152 // following layout for n dependency groups:
5153 //
5154 // +----+----+-----+----+---------+----------+-----+---------+-----------+
5155 // | C1 | C2 | ... | Cn | group 1 |  group 2 | ... | group n | undefined |
5156 // +----+----+-----+----+---------+----------+-----+---------+-----------+
5157 //
5158 // The first n elements are Smis, each of them specifies the number of codes
5159 // in the corresponding group. The subsequent elements contain grouped code
5160 // objects in weak cells. The suffix of the array can be filled with the
5161 // undefined value if the number of codes is less than the length of the
5162 // array. The order of the code objects within a group is not preserved.
5163 //
5164 // All code indexes used in the class are counted starting from the first
5165 // code object of the first group. In other words, code index 0 corresponds
5166 // to array index n = kCodesStartIndex.
5167
5168 class DependentCode: public FixedArray {
5169  public:
5170   enum DependencyGroup {
5171     // Group of code that weakly embed this map and depend on being
5172     // deoptimized when the map is garbage collected.
5173     kWeakCodeGroup,
5174     // Group of code that embed a transition to this map, and depend on being
5175     // deoptimized when the transition is replaced by a new version.
5176     kTransitionGroup,
5177     // Group of code that omit run-time prototype checks for prototypes
5178     // described by this map. The group is deoptimized whenever an object
5179     // described by this map changes shape (and transitions to a new map),
5180     // possibly invalidating the assumptions embedded in the code.
5181     kPrototypeCheckGroup,
5182     // Group of code that depends on global property values in property cells
5183     // not being changed.
5184     kPropertyCellChangedGroup,
5185     // Group of code that omit run-time type checks for the field(s) introduced
5186     // by this map.
5187     kFieldTypeGroup,
5188     // Group of code that omit run-time type checks for initial maps of
5189     // constructors.
5190     kInitialMapChangedGroup,
5191     // Group of code that depends on tenuring information in AllocationSites
5192     // not being changed.
5193     kAllocationSiteTenuringChangedGroup,
5194     // Group of code that depends on element transition information in
5195     // AllocationSites not being changed.
5196     kAllocationSiteTransitionChangedGroup
5197   };
5198
5199   static const int kGroupCount = kAllocationSiteTransitionChangedGroup + 1;
5200
5201   // Array for holding the index of the first code object of each group.
5202   // The last element stores the total number of code objects.
5203   class GroupStartIndexes {
5204    public:
5205     explicit GroupStartIndexes(DependentCode* entries);
5206     void Recompute(DependentCode* entries);
5207     int at(int i) { return start_indexes_[i]; }
5208     int number_of_entries() { return start_indexes_[kGroupCount]; }
5209    private:
5210     int start_indexes_[kGroupCount + 1];
5211   };
5212
5213   bool Contains(DependencyGroup group, WeakCell* code_cell);
5214
5215   static Handle<DependentCode> InsertCompilationDependencies(
5216       Handle<DependentCode> entries, DependencyGroup group,
5217       Handle<Foreign> info);
5218
5219   static Handle<DependentCode> InsertWeakCode(Handle<DependentCode> entries,
5220                                               DependencyGroup group,
5221                                               Handle<WeakCell> code_cell);
5222
5223   void UpdateToFinishedCode(DependencyGroup group, Foreign* info,
5224                             WeakCell* code_cell);
5225
5226   void RemoveCompilationDependencies(DependentCode::DependencyGroup group,
5227                                      Foreign* info);
5228
5229   void DeoptimizeDependentCodeGroup(Isolate* isolate,
5230                                     DependentCode::DependencyGroup group);
5231
5232   bool MarkCodeForDeoptimization(Isolate* isolate,
5233                                  DependentCode::DependencyGroup group);
5234
5235   // The following low-level accessors should only be used by this class
5236   // and the mark compact collector.
5237   inline int number_of_entries(DependencyGroup group);
5238   inline void set_number_of_entries(DependencyGroup group, int value);
5239   inline Object* object_at(int i);
5240   inline void set_object_at(int i, Object* object);
5241   inline void clear_at(int i);
5242   inline void copy(int from, int to);
5243   DECLARE_CAST(DependentCode)
5244
5245   static const char* DependencyGroupName(DependencyGroup group);
5246   static void SetMarkedForDeoptimization(Code* code, DependencyGroup group);
5247
5248  private:
5249   static Handle<DependentCode> Insert(Handle<DependentCode> entries,
5250                                       DependencyGroup group,
5251                                       Handle<Object> object);
5252   static Handle<DependentCode> EnsureSpace(Handle<DependentCode> entries);
5253   // Make a room at the end of the given group by moving out the first
5254   // code objects of the subsequent groups.
5255   inline void ExtendGroup(DependencyGroup group);
5256   // Compact by removing cleared weak cells and return true if there was
5257   // any cleared weak cell.
5258   bool Compact();
5259   static int Grow(int number_of_entries) {
5260     if (number_of_entries < 5) return number_of_entries + 1;
5261     return number_of_entries * 5 / 4;
5262   }
5263   static const int kCodesStartIndex = kGroupCount;
5264 };
5265
5266
5267 class PrototypeInfo;
5268
5269
5270 // All heap objects have a Map that describes their structure.
5271 //  A Map contains information about:
5272 //  - Size information about the object
5273 //  - How to iterate over an object (for garbage collection)
5274 class Map: public HeapObject {
5275  public:
5276   // Instance size.
5277   // Size in bytes or kVariableSizeSentinel if instances do not have
5278   // a fixed size.
5279   inline int instance_size();
5280   inline void set_instance_size(int value);
5281
5282   // Only to clear an unused byte, remove once byte is used.
5283   inline void clear_unused();
5284
5285   // Count of properties allocated in the object.
5286   inline int inobject_properties();
5287   inline void set_inobject_properties(int value);
5288
5289   // Instance type.
5290   inline InstanceType instance_type();
5291   inline void set_instance_type(InstanceType value);
5292
5293   // Tells how many unused property fields are available in the
5294   // instance (only used for JSObject in fast mode).
5295   inline int unused_property_fields();
5296   inline void set_unused_property_fields(int value);
5297
5298   // Bit field.
5299   inline byte bit_field() const;
5300   inline void set_bit_field(byte value);
5301
5302   // Bit field 2.
5303   inline byte bit_field2() const;
5304   inline void set_bit_field2(byte value);
5305
5306   // Bit field 3.
5307   inline uint32_t bit_field3() const;
5308   inline void set_bit_field3(uint32_t bits);
5309
5310   class EnumLengthBits:             public BitField<int,
5311       0, kDescriptorIndexBitCount> {};  // NOLINT
5312   class NumberOfOwnDescriptorsBits: public BitField<int,
5313       kDescriptorIndexBitCount, kDescriptorIndexBitCount> {};  // NOLINT
5314   STATIC_ASSERT(kDescriptorIndexBitCount + kDescriptorIndexBitCount == 20);
5315   class DictionaryMap : public BitField<bool, 20, 1> {};
5316   class OwnsDescriptors : public BitField<bool, 21, 1> {};
5317   class HasInstanceCallHandler : public BitField<bool, 22, 1> {};
5318   class Deprecated : public BitField<bool, 23, 1> {};
5319   class IsUnstable : public BitField<bool, 24, 1> {};
5320   class IsMigrationTarget : public BitField<bool, 25, 1> {};
5321   class IsStrong : public BitField<bool, 26, 1> {};
5322   // Bit 27 is free.
5323
5324   // Keep this bit field at the very end for better code in
5325   // Builtins::kJSConstructStubGeneric stub.
5326   // This counter is used for in-object slack tracking and for map aging.
5327   // The in-object slack tracking is considered enabled when the counter is
5328   // in the range [kSlackTrackingCounterStart, kSlackTrackingCounterEnd].
5329   class Counter : public BitField<int, 28, 4> {};
5330   static const int kSlackTrackingCounterStart = 14;
5331   static const int kSlackTrackingCounterEnd = 8;
5332   static const int kRetainingCounterStart = kSlackTrackingCounterEnd - 1;
5333   static const int kRetainingCounterEnd = 0;
5334
5335   // Tells whether the object in the prototype property will be used
5336   // for instances created from this function.  If the prototype
5337   // property is set to a value that is not a JSObject, the prototype
5338   // property will not be used to create instances of the function.
5339   // See ECMA-262, 13.2.2.
5340   inline void set_non_instance_prototype(bool value);
5341   inline bool has_non_instance_prototype();
5342
5343   // Tells whether function has special prototype property. If not, prototype
5344   // property will not be created when accessed (will return undefined),
5345   // and construction from this function will not be allowed.
5346   inline void set_function_with_prototype(bool value);
5347   inline bool function_with_prototype();
5348
5349   // Tells whether the instance with this map should be ignored by the
5350   // Object.getPrototypeOf() function and the __proto__ accessor.
5351   inline void set_is_hidden_prototype() {
5352     set_bit_field(bit_field() | (1 << kIsHiddenPrototype));
5353   }
5354
5355   inline bool is_hidden_prototype() {
5356     return ((1 << kIsHiddenPrototype) & bit_field()) != 0;
5357   }
5358
5359   // Records and queries whether the instance has a named interceptor.
5360   inline void set_has_named_interceptor() {
5361     set_bit_field(bit_field() | (1 << kHasNamedInterceptor));
5362   }
5363
5364   inline bool has_named_interceptor() {
5365     return ((1 << kHasNamedInterceptor) & bit_field()) != 0;
5366   }
5367
5368   // Records and queries whether the instance has an indexed interceptor.
5369   inline void set_has_indexed_interceptor() {
5370     set_bit_field(bit_field() | (1 << kHasIndexedInterceptor));
5371   }
5372
5373   inline bool has_indexed_interceptor() {
5374     return ((1 << kHasIndexedInterceptor) & bit_field()) != 0;
5375   }
5376
5377   // Tells whether the instance is undetectable.
5378   // An undetectable object is a special class of JSObject: 'typeof' operator
5379   // returns undefined, ToBoolean returns false. Otherwise it behaves like
5380   // a normal JS object.  It is useful for implementing undetectable
5381   // document.all in Firefox & Safari.
5382   // See https://bugzilla.mozilla.org/show_bug.cgi?id=248549.
5383   inline void set_is_undetectable() {
5384     set_bit_field(bit_field() | (1 << kIsUndetectable));
5385   }
5386
5387   inline bool is_undetectable() {
5388     return ((1 << kIsUndetectable) & bit_field()) != 0;
5389   }
5390
5391   // Tells whether the instance has a call-as-function handler.
5392   inline void set_is_observed() {
5393     set_bit_field(bit_field() | (1 << kIsObserved));
5394   }
5395
5396   inline bool is_observed() {
5397     return ((1 << kIsObserved) & bit_field()) != 0;
5398   }
5399
5400   inline void set_is_strong();
5401   inline bool is_strong();
5402   inline void set_is_extensible(bool value);
5403   inline bool is_extensible();
5404   inline void set_is_prototype_map(bool value);
5405   inline bool is_prototype_map() const;
5406
5407   inline void set_elements_kind(ElementsKind elements_kind) {
5408     DCHECK(static_cast<int>(elements_kind) < kElementsKindCount);
5409     DCHECK(kElementsKindCount <= (1 << Map::ElementsKindBits::kSize));
5410     set_bit_field2(Map::ElementsKindBits::update(bit_field2(), elements_kind));
5411     DCHECK(this->elements_kind() == elements_kind);
5412   }
5413
5414   inline ElementsKind elements_kind() {
5415     return Map::ElementsKindBits::decode(bit_field2());
5416   }
5417
5418   // Tells whether the instance has fast elements that are only Smis.
5419   inline bool has_fast_smi_elements() {
5420     return IsFastSmiElementsKind(elements_kind());
5421   }
5422
5423   // Tells whether the instance has fast elements.
5424   inline bool has_fast_object_elements() {
5425     return IsFastObjectElementsKind(elements_kind());
5426   }
5427
5428   inline bool has_fast_smi_or_object_elements() {
5429     return IsFastSmiOrObjectElementsKind(elements_kind());
5430   }
5431
5432   inline bool has_fast_double_elements() {
5433     return IsFastDoubleElementsKind(elements_kind());
5434   }
5435
5436   inline bool has_fast_elements() {
5437     return IsFastElementsKind(elements_kind());
5438   }
5439
5440   inline bool has_sloppy_arguments_elements() {
5441     return IsSloppyArgumentsElements(elements_kind());
5442   }
5443
5444   inline bool has_fixed_typed_array_elements() {
5445     return IsFixedTypedArrayElementsKind(elements_kind());
5446   }
5447
5448   inline bool has_dictionary_elements() {
5449     return IsDictionaryElementsKind(elements_kind());
5450   }
5451
5452   static bool IsValidElementsTransition(ElementsKind from_kind,
5453                                         ElementsKind to_kind);
5454
5455   // Returns true if the current map doesn't have DICTIONARY_ELEMENTS but if a
5456   // map with DICTIONARY_ELEMENTS was found in the prototype chain.
5457   bool DictionaryElementsInPrototypeChainOnly();
5458
5459   inline Map* ElementsTransitionMap();
5460
5461   inline FixedArrayBase* GetInitialElements();
5462
5463   // [raw_transitions]: Provides access to the transitions storage field.
5464   // Don't call set_raw_transitions() directly to overwrite transitions, use
5465   // the TransitionArray::ReplaceTransitions() wrapper instead!
5466   DECL_ACCESSORS(raw_transitions, Object)
5467   // [prototype_info]: Per-prototype metadata. Aliased with transitions
5468   // (which prototype maps don't have).
5469   DECL_ACCESSORS(prototype_info, Object)
5470   // PrototypeInfo is created lazily using this helper (which installs it on
5471   // the given prototype's map).
5472   static Handle<PrototypeInfo> GetOrCreatePrototypeInfo(
5473       Handle<JSObject> prototype, Isolate* isolate);
5474
5475   // [prototype chain validity cell]: Associated with a prototype object,
5476   // stored in that object's map's PrototypeInfo, indicates that prototype
5477   // chains through this object are currently valid. The cell will be
5478   // invalidated and replaced when the prototype chain changes.
5479   static Handle<Cell> GetOrCreatePrototypeChainValidityCell(Handle<Map> map,
5480                                                             Isolate* isolate);
5481   static const int kPrototypeChainValid = 0;
5482   static const int kPrototypeChainInvalid = 1;
5483
5484   Map* FindRootMap();
5485   Map* FindFieldOwner(int descriptor);
5486
5487   inline int GetInObjectPropertyOffset(int index);
5488
5489   int NumberOfFields();
5490
5491   // TODO(ishell): candidate with JSObject::MigrateToMap().
5492   bool InstancesNeedRewriting(Map* target, int target_number_of_fields,
5493                               int target_inobject, int target_unused,
5494                               int* old_number_of_fields);
5495   // TODO(ishell): moveit!
5496   static Handle<Map> GeneralizeAllFieldRepresentations(Handle<Map> map);
5497   MUST_USE_RESULT static Handle<HeapType> GeneralizeFieldType(
5498       Handle<HeapType> type1,
5499       Handle<HeapType> type2,
5500       Isolate* isolate);
5501   static void GeneralizeFieldType(Handle<Map> map, int modify_index,
5502                                   Representation new_representation,
5503                                   Handle<HeapType> new_field_type);
5504   static Handle<Map> ReconfigureProperty(Handle<Map> map, int modify_index,
5505                                          PropertyKind new_kind,
5506                                          PropertyAttributes new_attributes,
5507                                          Representation new_representation,
5508                                          Handle<HeapType> new_field_type,
5509                                          StoreMode store_mode);
5510   static Handle<Map> CopyGeneralizeAllRepresentations(
5511       Handle<Map> map, int modify_index, StoreMode store_mode,
5512       PropertyKind kind, PropertyAttributes attributes, const char* reason);
5513
5514   static Handle<Map> PrepareForDataProperty(Handle<Map> old_map,
5515                                             int descriptor_number,
5516                                             Handle<Object> value);
5517
5518   static Handle<Map> Normalize(Handle<Map> map, PropertyNormalizationMode mode,
5519                                const char* reason);
5520
5521   // Returns the constructor name (the name (possibly, inferred name) of the
5522   // function that was used to instantiate the object).
5523   String* constructor_name();
5524
5525   // Tells whether the map is used for JSObjects in dictionary mode (ie
5526   // normalized objects, ie objects for which HasFastProperties returns false).
5527   // A map can never be used for both dictionary mode and fast mode JSObjects.
5528   // False by default and for HeapObjects that are not JSObjects.
5529   inline void set_dictionary_map(bool value);
5530   inline bool is_dictionary_map();
5531
5532   // Tells whether the instance needs security checks when accessing its
5533   // properties.
5534   inline void set_is_access_check_needed(bool access_check_needed);
5535   inline bool is_access_check_needed();
5536
5537   // Returns true if map has a non-empty stub code cache.
5538   inline bool has_code_cache();
5539
5540   // [prototype]: implicit prototype object.
5541   DECL_ACCESSORS(prototype, Object)
5542   // TODO(jkummerow): make set_prototype private.
5543   static void SetPrototype(
5544       Handle<Map> map, Handle<Object> prototype,
5545       PrototypeOptimizationMode proto_mode = FAST_PROTOTYPE);
5546
5547   // [constructor]: points back to the function responsible for this map.
5548   // The field overlaps with the back pointer. All maps in a transition tree
5549   // have the same constructor, so maps with back pointers can walk the
5550   // back pointer chain until they find the map holding their constructor.
5551   DECL_ACCESSORS(constructor_or_backpointer, Object)
5552   inline Object* GetConstructor() const;
5553   inline void SetConstructor(Object* constructor,
5554                              WriteBarrierMode mode = UPDATE_WRITE_BARRIER);
5555   // [back pointer]: points back to the parent map from which a transition
5556   // leads to this map. The field overlaps with the constructor (see above).
5557   inline Object* GetBackPointer();
5558   inline void SetBackPointer(Object* value,
5559                              WriteBarrierMode mode = UPDATE_WRITE_BARRIER);
5560
5561   // [instance descriptors]: describes the object.
5562   DECL_ACCESSORS(instance_descriptors, DescriptorArray)
5563
5564   // [layout descriptor]: describes the object layout.
5565   DECL_ACCESSORS(layout_descriptor, LayoutDescriptor)
5566   // |layout descriptor| accessor which can be used from GC.
5567   inline LayoutDescriptor* layout_descriptor_gc_safe();
5568   inline bool HasFastPointerLayout() const;
5569
5570   // |layout descriptor| accessor that is safe to call even when
5571   // FLAG_unbox_double_fields is disabled (in this case Map does not contain
5572   // |layout_descriptor| field at all).
5573   inline LayoutDescriptor* GetLayoutDescriptor();
5574
5575   inline void UpdateDescriptors(DescriptorArray* descriptors,
5576                                 LayoutDescriptor* layout_descriptor);
5577   inline void InitializeDescriptors(DescriptorArray* descriptors,
5578                                     LayoutDescriptor* layout_descriptor);
5579
5580   // [stub cache]: contains stubs compiled for this map.
5581   DECL_ACCESSORS(code_cache, Object)
5582
5583   // [dependent code]: list of optimized codes that weakly embed this map.
5584   DECL_ACCESSORS(dependent_code, DependentCode)
5585
5586   // [weak cell cache]: cache that stores a weak cell pointing to this map.
5587   DECL_ACCESSORS(weak_cell_cache, Object)
5588
5589   inline PropertyDetails GetLastDescriptorDetails();
5590
5591   int LastAdded() {
5592     int number_of_own_descriptors = NumberOfOwnDescriptors();
5593     DCHECK(number_of_own_descriptors > 0);
5594     return number_of_own_descriptors - 1;
5595   }
5596
5597   int NumberOfOwnDescriptors() {
5598     return NumberOfOwnDescriptorsBits::decode(bit_field3());
5599   }
5600
5601   void SetNumberOfOwnDescriptors(int number) {
5602     DCHECK(number <= instance_descriptors()->number_of_descriptors());
5603     set_bit_field3(NumberOfOwnDescriptorsBits::update(bit_field3(), number));
5604   }
5605
5606   inline Cell* RetrieveDescriptorsPointer();
5607
5608   int EnumLength() {
5609     return EnumLengthBits::decode(bit_field3());
5610   }
5611
5612   void SetEnumLength(int length) {
5613     if (length != kInvalidEnumCacheSentinel) {
5614       DCHECK(length >= 0);
5615       DCHECK(length == 0 || instance_descriptors()->HasEnumCache());
5616       DCHECK(length <= NumberOfOwnDescriptors());
5617     }
5618     set_bit_field3(EnumLengthBits::update(bit_field3(), length));
5619   }
5620
5621   inline bool owns_descriptors();
5622   inline void set_owns_descriptors(bool owns_descriptors);
5623   inline bool has_instance_call_handler();
5624   inline void set_has_instance_call_handler();
5625   inline void mark_unstable();
5626   inline bool is_stable();
5627   inline void set_migration_target(bool value);
5628   inline bool is_migration_target();
5629   inline void set_counter(int value);
5630   inline int counter();
5631   inline void deprecate();
5632   inline bool is_deprecated();
5633   inline bool CanBeDeprecated();
5634   // Returns a non-deprecated version of the input. If the input was not
5635   // deprecated, it is directly returned. Otherwise, the non-deprecated version
5636   // is found by re-transitioning from the root of the transition tree using the
5637   // descriptor array of the map. Returns MaybeHandle<Map>() if no updated map
5638   // is found.
5639   static MaybeHandle<Map> TryUpdate(Handle<Map> map) WARN_UNUSED_RESULT;
5640
5641   // Returns a non-deprecated version of the input. This method may deprecate
5642   // existing maps along the way if encodings conflict. Not for use while
5643   // gathering type feedback. Use TryUpdate in those cases instead.
5644   static Handle<Map> Update(Handle<Map> map);
5645
5646   static Handle<Map> CopyDropDescriptors(Handle<Map> map);
5647   static Handle<Map> CopyInsertDescriptor(Handle<Map> map,
5648                                           Descriptor* descriptor,
5649                                           TransitionFlag flag);
5650
5651   MUST_USE_RESULT static MaybeHandle<Map> CopyWithField(
5652       Handle<Map> map,
5653       Handle<Name> name,
5654       Handle<HeapType> type,
5655       PropertyAttributes attributes,
5656       Representation representation,
5657       TransitionFlag flag);
5658
5659   MUST_USE_RESULT static MaybeHandle<Map> CopyWithConstant(
5660       Handle<Map> map,
5661       Handle<Name> name,
5662       Handle<Object> constant,
5663       PropertyAttributes attributes,
5664       TransitionFlag flag);
5665
5666   // Returns a new map with all transitions dropped from the given map and
5667   // the ElementsKind set.
5668   static Handle<Map> TransitionElementsTo(Handle<Map> map,
5669                                           ElementsKind to_kind);
5670
5671   static Handle<Map> AsElementsKind(Handle<Map> map, ElementsKind kind);
5672
5673   static Handle<Map> CopyAsElementsKind(Handle<Map> map,
5674                                         ElementsKind kind,
5675                                         TransitionFlag flag);
5676
5677   static Handle<Map> CopyForObserved(Handle<Map> map);
5678
5679   static Handle<Map> CopyForPreventExtensions(Handle<Map> map,
5680                                               PropertyAttributes attrs_to_add,
5681                                               Handle<Symbol> transition_marker,
5682                                               const char* reason);
5683
5684   static Handle<Map> FixProxy(Handle<Map> map, InstanceType type, int size);
5685
5686
5687   // Maximal number of fast properties. Used to restrict the number of map
5688   // transitions to avoid an explosion in the number of maps for objects used as
5689   // dictionaries.
5690   inline bool TooManyFastProperties(StoreFromKeyed store_mode);
5691   static Handle<Map> TransitionToDataProperty(Handle<Map> map,
5692                                               Handle<Name> name,
5693                                               Handle<Object> value,
5694                                               PropertyAttributes attributes,
5695                                               StoreFromKeyed store_mode);
5696   static Handle<Map> TransitionToAccessorProperty(
5697       Handle<Map> map, Handle<Name> name, AccessorComponent component,
5698       Handle<Object> accessor, PropertyAttributes attributes);
5699   static Handle<Map> ReconfigureExistingProperty(Handle<Map> map,
5700                                                  int descriptor,
5701                                                  PropertyKind kind,
5702                                                  PropertyAttributes attributes);
5703
5704   inline void AppendDescriptor(Descriptor* desc);
5705
5706   // Returns a copy of the map, prepared for inserting into the transition
5707   // tree (if the |map| owns descriptors then the new one will share
5708   // descriptors with |map|).
5709   static Handle<Map> CopyForTransition(Handle<Map> map, const char* reason);
5710
5711   // Returns a copy of the map, with all transitions dropped from the
5712   // instance descriptors.
5713   static Handle<Map> Copy(Handle<Map> map, const char* reason);
5714   static Handle<Map> Create(Isolate* isolate, int inobject_properties);
5715
5716   // Returns the next free property index (only valid for FAST MODE).
5717   int NextFreePropertyIndex();
5718
5719   // Returns the number of properties described in instance_descriptors
5720   // filtering out properties with the specified attributes.
5721   int NumberOfDescribedProperties(DescriptorFlag which = OWN_DESCRIPTORS,
5722                                   PropertyAttributes filter = NONE);
5723
5724   DECLARE_CAST(Map)
5725
5726   // Code cache operations.
5727
5728   // Clears the code cache.
5729   inline void ClearCodeCache(Heap* heap);
5730
5731   // Update code cache.
5732   static void UpdateCodeCache(Handle<Map> map,
5733                               Handle<Name> name,
5734                               Handle<Code> code);
5735
5736   // Extend the descriptor array of the map with the list of descriptors.
5737   // In case of duplicates, the latest descriptor is used.
5738   static void AppendCallbackDescriptors(Handle<Map> map,
5739                                         Handle<Object> descriptors);
5740
5741   static inline int SlackForArraySize(int old_size, int size_limit);
5742
5743   static void EnsureDescriptorSlack(Handle<Map> map, int slack);
5744
5745   // Returns the found code or undefined if absent.
5746   Object* FindInCodeCache(Name* name, Code::Flags flags);
5747
5748   // Returns the non-negative index of the code object if it is in the
5749   // cache and -1 otherwise.
5750   int IndexInCodeCache(Object* name, Code* code);
5751
5752   // Removes a code object from the code cache at the given index.
5753   void RemoveFromCodeCache(Name* name, Code* code, int index);
5754
5755   // Computes a hash value for this map, to be used in HashTables and such.
5756   int Hash();
5757
5758   // Returns the map that this map transitions to if its elements_kind
5759   // is changed to |elements_kind|, or NULL if no such map is cached yet.
5760   // |safe_to_add_transitions| is set to false if adding transitions is not
5761   // allowed.
5762   Map* LookupElementsTransitionMap(ElementsKind elements_kind);
5763
5764   // Returns the transitioned map for this map with the most generic
5765   // elements_kind that's found in |candidates|, or null handle if no match is
5766   // found at all.
5767   static Handle<Map> FindTransitionedMap(Handle<Map> map,
5768                                          MapHandleList* candidates);
5769
5770   bool CanTransition() {
5771     // Only JSObject and subtypes have map transitions and back pointers.
5772     STATIC_ASSERT(LAST_TYPE == LAST_JS_OBJECT_TYPE);
5773     return instance_type() >= FIRST_JS_OBJECT_TYPE;
5774   }
5775
5776   bool IsJSObjectMap() {
5777     return instance_type() >= FIRST_JS_OBJECT_TYPE;
5778   }
5779   bool IsJSArrayMap() { return instance_type() == JS_ARRAY_TYPE; }
5780   bool IsStringMap() { return instance_type() < FIRST_NONSTRING_TYPE; }
5781   bool IsJSProxyMap() {
5782     InstanceType type = instance_type();
5783     return FIRST_JS_PROXY_TYPE <= type && type <= LAST_JS_PROXY_TYPE;
5784   }
5785   bool IsJSGlobalProxyMap() {
5786     return instance_type() == JS_GLOBAL_PROXY_TYPE;
5787   }
5788   bool IsJSGlobalObjectMap() {
5789     return instance_type() == JS_GLOBAL_OBJECT_TYPE;
5790   }
5791   bool IsGlobalObjectMap() {
5792     const InstanceType type = instance_type();
5793     return type == JS_GLOBAL_OBJECT_TYPE || type == JS_BUILTINS_OBJECT_TYPE;
5794   }
5795
5796   inline bool CanOmitMapChecks();
5797
5798   static void AddDependentCode(Handle<Map> map,
5799                                DependentCode::DependencyGroup group,
5800                                Handle<Code> code);
5801
5802   bool IsMapInArrayPrototypeChain();
5803
5804   static Handle<WeakCell> WeakCellForMap(Handle<Map> map);
5805
5806   // Dispatched behavior.
5807   DECLARE_PRINTER(Map)
5808   DECLARE_VERIFIER(Map)
5809
5810 #ifdef VERIFY_HEAP
5811   void DictionaryMapVerify();
5812   void VerifyOmittedMapChecks();
5813 #endif
5814
5815   inline int visitor_id();
5816   inline void set_visitor_id(int visitor_id);
5817
5818   static Handle<Map> TransitionToPrototype(Handle<Map> map,
5819                                            Handle<Object> prototype,
5820                                            PrototypeOptimizationMode mode);
5821
5822   static const int kMaxPreAllocatedPropertyFields = 255;
5823
5824   // Layout description.
5825   static const int kInstanceSizesOffset = HeapObject::kHeaderSize;
5826   static const int kInstanceAttributesOffset = kInstanceSizesOffset + kIntSize;
5827   static const int kBitField3Offset = kInstanceAttributesOffset + kIntSize;
5828   static const int kPrototypeOffset = kBitField3Offset + kPointerSize;
5829   static const int kConstructorOrBackPointerOffset =
5830       kPrototypeOffset + kPointerSize;
5831   // When there is only one transition, it is stored directly in this field;
5832   // otherwise a transition array is used.
5833   // For prototype maps, this slot is used to store this map's PrototypeInfo
5834   // struct.
5835   static const int kTransitionsOrPrototypeInfoOffset =
5836       kConstructorOrBackPointerOffset + kPointerSize;
5837   static const int kDescriptorsOffset =
5838       kTransitionsOrPrototypeInfoOffset + kPointerSize;
5839 #if V8_DOUBLE_FIELDS_UNBOXING
5840   static const int kLayoutDecriptorOffset = kDescriptorsOffset + kPointerSize;
5841   static const int kCodeCacheOffset = kLayoutDecriptorOffset + kPointerSize;
5842 #else
5843   static const int kLayoutDecriptorOffset = 1;  // Must not be ever accessed.
5844   static const int kCodeCacheOffset = kDescriptorsOffset + kPointerSize;
5845 #endif
5846   static const int kDependentCodeOffset = kCodeCacheOffset + kPointerSize;
5847   static const int kWeakCellCacheOffset = kDependentCodeOffset + kPointerSize;
5848   static const int kSize = kWeakCellCacheOffset + kPointerSize;
5849
5850   // Layout of pointer fields. Heap iteration code relies on them
5851   // being continuously allocated.
5852   static const int kPointerFieldsBeginOffset = Map::kPrototypeOffset;
5853   static const int kPointerFieldsEndOffset = kSize;
5854
5855   // Byte offsets within kInstanceSizesOffset.
5856   static const int kInstanceSizeOffset = kInstanceSizesOffset + 0;
5857   static const int kInObjectPropertiesByte = 1;
5858   static const int kInObjectPropertiesOffset =
5859       kInstanceSizesOffset + kInObjectPropertiesByte;
5860   // Note there is one byte available for use here.
5861   static const int kUnusedByte = 2;
5862   static const int kUnusedOffset = kInstanceSizesOffset + kUnusedByte;
5863   static const int kVisitorIdByte = 3;
5864   static const int kVisitorIdOffset = kInstanceSizesOffset + kVisitorIdByte;
5865
5866   // Byte offsets within kInstanceAttributesOffset attributes.
5867 #if V8_TARGET_LITTLE_ENDIAN
5868   // Order instance type and bit field together such that they can be loaded
5869   // together as a 16-bit word with instance type in the lower 8 bits regardless
5870   // of endianess. Also provide endian-independent offset to that 16-bit word.
5871   static const int kInstanceTypeOffset = kInstanceAttributesOffset + 0;
5872   static const int kBitFieldOffset = kInstanceAttributesOffset + 1;
5873 #else
5874   static const int kBitFieldOffset = kInstanceAttributesOffset + 0;
5875   static const int kInstanceTypeOffset = kInstanceAttributesOffset + 1;
5876 #endif
5877   static const int kInstanceTypeAndBitFieldOffset =
5878       kInstanceAttributesOffset + 0;
5879   static const int kBitField2Offset = kInstanceAttributesOffset + 2;
5880   static const int kUnusedPropertyFieldsByte = 3;
5881   static const int kUnusedPropertyFieldsOffset = kInstanceAttributesOffset + 3;
5882
5883   STATIC_ASSERT(kInstanceTypeAndBitFieldOffset ==
5884                 Internals::kMapInstanceTypeAndBitFieldOffset);
5885
5886   // Bit positions for bit field.
5887   static const int kHasNonInstancePrototype = 0;
5888   static const int kIsHiddenPrototype = 1;
5889   static const int kHasNamedInterceptor = 2;
5890   static const int kHasIndexedInterceptor = 3;
5891   static const int kIsUndetectable = 4;
5892   static const int kIsObserved = 5;
5893   static const int kIsAccessCheckNeeded = 6;
5894   class FunctionWithPrototype: public BitField<bool, 7,  1> {};
5895
5896   // Bit positions for bit field 2
5897   static const int kIsExtensible = 0;
5898   static const int kStringWrapperSafeForDefaultValueOf = 1;
5899   class IsPrototypeMapBits : public BitField<bool, 2, 1> {};
5900   class ElementsKindBits: public BitField<ElementsKind, 3, 5> {};
5901
5902   // Derived values from bit field 2
5903   static const int8_t kMaximumBitField2FastElementValue = static_cast<int8_t>(
5904       (FAST_ELEMENTS + 1) << Map::ElementsKindBits::kShift) - 1;
5905   static const int8_t kMaximumBitField2FastSmiElementValue =
5906       static_cast<int8_t>((FAST_SMI_ELEMENTS + 1) <<
5907                           Map::ElementsKindBits::kShift) - 1;
5908   static const int8_t kMaximumBitField2FastHoleyElementValue =
5909       static_cast<int8_t>((FAST_HOLEY_ELEMENTS + 1) <<
5910                           Map::ElementsKindBits::kShift) - 1;
5911   static const int8_t kMaximumBitField2FastHoleySmiElementValue =
5912       static_cast<int8_t>((FAST_HOLEY_SMI_ELEMENTS + 1) <<
5913                           Map::ElementsKindBits::kShift) - 1;
5914
5915   typedef FixedBodyDescriptor<kPointerFieldsBeginOffset,
5916                               kPointerFieldsEndOffset,
5917                               kSize> BodyDescriptor;
5918
5919   // Compares this map to another to see if they describe equivalent objects.
5920   // If |mode| is set to CLEAR_INOBJECT_PROPERTIES, |other| is treated as if
5921   // it had exactly zero inobject properties.
5922   // The "shared" flags of both this map and |other| are ignored.
5923   bool EquivalentToForNormalization(Map* other, PropertyNormalizationMode mode);
5924
5925   // Returns true if given field is unboxed double.
5926   inline bool IsUnboxedDoubleField(FieldIndex index);
5927
5928 #if TRACE_MAPS
5929   static void TraceTransition(const char* what, Map* from, Map* to, Name* name);
5930   static void TraceAllTransitions(Map* map);
5931 #endif
5932
5933   static inline Handle<Map> CopyInstallDescriptorsForTesting(
5934       Handle<Map> map, int new_descriptor, Handle<DescriptorArray> descriptors,
5935       Handle<LayoutDescriptor> layout_descriptor);
5936
5937  private:
5938   static void ConnectTransition(Handle<Map> parent, Handle<Map> child,
5939                                 Handle<Name> name, SimpleTransitionFlag flag);
5940
5941   bool EquivalentToForTransition(Map* other);
5942   static Handle<Map> RawCopy(Handle<Map> map, int instance_size);
5943   static Handle<Map> ShareDescriptor(Handle<Map> map,
5944                                      Handle<DescriptorArray> descriptors,
5945                                      Descriptor* descriptor);
5946   static Handle<Map> CopyInstallDescriptors(
5947       Handle<Map> map, int new_descriptor, Handle<DescriptorArray> descriptors,
5948       Handle<LayoutDescriptor> layout_descriptor);
5949   static Handle<Map> CopyAddDescriptor(Handle<Map> map,
5950                                        Descriptor* descriptor,
5951                                        TransitionFlag flag);
5952   static Handle<Map> CopyReplaceDescriptors(
5953       Handle<Map> map, Handle<DescriptorArray> descriptors,
5954       Handle<LayoutDescriptor> layout_descriptor, TransitionFlag flag,
5955       MaybeHandle<Name> maybe_name, const char* reason,
5956       SimpleTransitionFlag simple_flag);
5957
5958   static Handle<Map> CopyReplaceDescriptor(Handle<Map> map,
5959                                            Handle<DescriptorArray> descriptors,
5960                                            Descriptor* descriptor,
5961                                            int index,
5962                                            TransitionFlag flag);
5963   static MUST_USE_RESULT MaybeHandle<Map> TryReconfigureExistingProperty(
5964       Handle<Map> map, int descriptor, PropertyKind kind,
5965       PropertyAttributes attributes, const char** reason);
5966
5967   static Handle<Map> CopyNormalized(Handle<Map> map,
5968                                     PropertyNormalizationMode mode);
5969
5970   // Fires when the layout of an object with a leaf map changes.
5971   // This includes adding transitions to the leaf map or changing
5972   // the descriptor array.
5973   inline void NotifyLeafMapLayoutChange();
5974
5975   void DeprecateTransitionTree();
5976   bool DeprecateTarget(PropertyKind kind, Name* key,
5977                        PropertyAttributes attributes,
5978                        DescriptorArray* new_descriptors,
5979                        LayoutDescriptor* new_layout_descriptor);
5980
5981   Map* FindLastMatchMap(int verbatim, int length, DescriptorArray* descriptors);
5982
5983   // Update field type of the given descriptor to new representation and new
5984   // type. The type must be prepared for storing in descriptor array:
5985   // it must be either a simple type or a map wrapped in a weak cell.
5986   void UpdateFieldType(int descriptor_number, Handle<Name> name,
5987                        Representation new_representation,
5988                        Handle<Object> new_wrapped_type);
5989
5990   void PrintReconfiguration(FILE* file, int modify_index, PropertyKind kind,
5991                             PropertyAttributes attributes);
5992   void PrintGeneralization(FILE* file,
5993                            const char* reason,
5994                            int modify_index,
5995                            int split,
5996                            int descriptors,
5997                            bool constant_to_field,
5998                            Representation old_representation,
5999                            Representation new_representation,
6000                            HeapType* old_field_type,
6001                            HeapType* new_field_type);
6002
6003   static const int kFastPropertiesSoftLimit = 12;
6004   static const int kMaxFastProperties = 128;
6005
6006   DISALLOW_IMPLICIT_CONSTRUCTORS(Map);
6007 };
6008
6009
6010 // An abstract superclass, a marker class really, for simple structure classes.
6011 // It doesn't carry much functionality but allows struct classes to be
6012 // identified in the type system.
6013 class Struct: public HeapObject {
6014  public:
6015   inline void InitializeBody(int object_size);
6016   DECLARE_CAST(Struct)
6017 };
6018
6019
6020 // A simple one-element struct, useful where smis need to be boxed.
6021 class Box : public Struct {
6022  public:
6023   // [value]: the boxed contents.
6024   DECL_ACCESSORS(value, Object)
6025
6026   DECLARE_CAST(Box)
6027
6028   // Dispatched behavior.
6029   DECLARE_PRINTER(Box)
6030   DECLARE_VERIFIER(Box)
6031
6032   static const int kValueOffset = HeapObject::kHeaderSize;
6033   static const int kSize = kValueOffset + kPointerSize;
6034
6035  private:
6036   DISALLOW_IMPLICIT_CONSTRUCTORS(Box);
6037 };
6038
6039
6040 // Container for metadata stored on each prototype map.
6041 class PrototypeInfo : public Struct {
6042  public:
6043   // [prototype_users]: WeakFixedArray containing maps using this prototype,
6044   // or Smi(0) if uninitialized.
6045   DECL_ACCESSORS(prototype_users, Object)
6046   // [validity_cell]: Cell containing the validity bit for prototype chains
6047   // going through this object, or Smi(0) if uninitialized.
6048   DECL_ACCESSORS(validity_cell, Object)
6049   // [constructor_name]: User-friendly name of the original constructor.
6050   DECL_ACCESSORS(constructor_name, Object)
6051
6052   DECLARE_CAST(PrototypeInfo)
6053
6054   // Dispatched behavior.
6055   DECLARE_PRINTER(PrototypeInfo)
6056   DECLARE_VERIFIER(PrototypeInfo)
6057
6058   static const int kPrototypeUsersOffset = HeapObject::kHeaderSize;
6059   static const int kValidityCellOffset = kPrototypeUsersOffset + kPointerSize;
6060   static const int kConstructorNameOffset = kValidityCellOffset + kPointerSize;
6061   static const int kSize = kConstructorNameOffset + kPointerSize;
6062
6063  private:
6064   DISALLOW_IMPLICIT_CONSTRUCTORS(PrototypeInfo);
6065 };
6066
6067
6068 // Script describes a script which has been added to the VM.
6069 class Script: public Struct {
6070  public:
6071   // Script types.
6072   enum Type {
6073     TYPE_NATIVE = 0,
6074     TYPE_EXTENSION = 1,
6075     TYPE_NORMAL = 2
6076   };
6077
6078   // Script compilation types.
6079   enum CompilationType {
6080     COMPILATION_TYPE_HOST = 0,
6081     COMPILATION_TYPE_EVAL = 1
6082   };
6083
6084   // Script compilation state.
6085   enum CompilationState {
6086     COMPILATION_STATE_INITIAL = 0,
6087     COMPILATION_STATE_COMPILED = 1
6088   };
6089
6090   // [source]: the script source.
6091   DECL_ACCESSORS(source, Object)
6092
6093   // [name]: the script name.
6094   DECL_ACCESSORS(name, Object)
6095
6096   // [id]: the script id.
6097   DECL_ACCESSORS(id, Smi)
6098
6099   // [line_offset]: script line offset in resource from where it was extracted.
6100   DECL_ACCESSORS(line_offset, Smi)
6101
6102   // [column_offset]: script column offset in resource from where it was
6103   // extracted.
6104   DECL_ACCESSORS(column_offset, Smi)
6105
6106   // [context_data]: context data for the context this script was compiled in.
6107   DECL_ACCESSORS(context_data, Object)
6108
6109   // [wrapper]: the wrapper cache.  This is either undefined or a WeakCell.
6110   DECL_ACCESSORS(wrapper, HeapObject)
6111
6112   // [type]: the script type.
6113   DECL_ACCESSORS(type, Smi)
6114
6115   // [line_ends]: FixedArray of line ends positions.
6116   DECL_ACCESSORS(line_ends, Object)
6117
6118   // [eval_from_shared]: for eval scripts the shared funcion info for the
6119   // function from which eval was called.
6120   DECL_ACCESSORS(eval_from_shared, Object)
6121
6122   // [eval_from_instructions_offset]: the instruction offset in the code for the
6123   // function from which eval was called where eval was called.
6124   DECL_ACCESSORS(eval_from_instructions_offset, Smi)
6125
6126   // [shared_function_infos]: weak fixed array containing all shared
6127   // function infos created from this script.
6128   DECL_ACCESSORS(shared_function_infos, Object)
6129
6130   // [flags]: Holds an exciting bitfield.
6131   DECL_ACCESSORS(flags, Smi)
6132
6133   // [source_url]: sourceURL from magic comment
6134   DECL_ACCESSORS(source_url, Object)
6135
6136   // [source_url]: sourceMappingURL magic comment
6137   DECL_ACCESSORS(source_mapping_url, Object)
6138
6139   // [compilation_type]: how the the script was compiled. Encoded in the
6140   // 'flags' field.
6141   inline CompilationType compilation_type();
6142   inline void set_compilation_type(CompilationType type);
6143
6144   // [compilation_state]: determines whether the script has already been
6145   // compiled. Encoded in the 'flags' field.
6146   inline CompilationState compilation_state();
6147   inline void set_compilation_state(CompilationState state);
6148
6149   // [origin_options]: optional attributes set by the embedder via ScriptOrigin,
6150   // and used by the embedder to make decisions about the script. V8 just passes
6151   // this through. Encoded in the 'flags' field.
6152   inline v8::ScriptOriginOptions origin_options();
6153   inline void set_origin_options(ScriptOriginOptions origin_options);
6154
6155   DECLARE_CAST(Script)
6156
6157   // If script source is an external string, check that the underlying
6158   // resource is accessible. Otherwise, always return true.
6159   inline bool HasValidSource();
6160
6161   // Convert code position into column number.
6162   static int GetColumnNumber(Handle<Script> script, int code_pos);
6163
6164   // Convert code position into (zero-based) line number.
6165   // The non-handlified version does not allocate, but may be much slower.
6166   static int GetLineNumber(Handle<Script> script, int code_pos);
6167   int GetLineNumber(int code_pos);
6168
6169   static Handle<Object> GetNameOrSourceURL(Handle<Script> script);
6170
6171   // Init line_ends array with code positions of line ends inside script source.
6172   static void InitLineEnds(Handle<Script> script);
6173
6174   // Get the JS object wrapping the given script; create it if none exists.
6175   static Handle<JSObject> GetWrapper(Handle<Script> script);
6176
6177   // Look through the list of existing shared function infos to find one
6178   // that matches the function literal.  Return empty handle if not found.
6179   MaybeHandle<SharedFunctionInfo> FindSharedFunctionInfo(FunctionLiteral* fun);
6180
6181   // Dispatched behavior.
6182   DECLARE_PRINTER(Script)
6183   DECLARE_VERIFIER(Script)
6184
6185   static const int kSourceOffset = HeapObject::kHeaderSize;
6186   static const int kNameOffset = kSourceOffset + kPointerSize;
6187   static const int kLineOffsetOffset = kNameOffset + kPointerSize;
6188   static const int kColumnOffsetOffset = kLineOffsetOffset + kPointerSize;
6189   static const int kContextOffset = kColumnOffsetOffset + kPointerSize;
6190   static const int kWrapperOffset = kContextOffset + kPointerSize;
6191   static const int kTypeOffset = kWrapperOffset + kPointerSize;
6192   static const int kLineEndsOffset = kTypeOffset + kPointerSize;
6193   static const int kIdOffset = kLineEndsOffset + kPointerSize;
6194   static const int kEvalFromSharedOffset = kIdOffset + kPointerSize;
6195   static const int kEvalFrominstructionsOffsetOffset =
6196       kEvalFromSharedOffset + kPointerSize;
6197   static const int kSharedFunctionInfosOffset =
6198       kEvalFrominstructionsOffsetOffset + kPointerSize;
6199   static const int kFlagsOffset = kSharedFunctionInfosOffset + kPointerSize;
6200   static const int kSourceUrlOffset = kFlagsOffset + kPointerSize;
6201   static const int kSourceMappingUrlOffset = kSourceUrlOffset + kPointerSize;
6202   static const int kSize = kSourceMappingUrlOffset + kPointerSize;
6203
6204  private:
6205   int GetLineNumberWithArray(int code_pos);
6206
6207   // Bit positions in the flags field.
6208   static const int kCompilationTypeBit = 0;
6209   static const int kCompilationStateBit = 1;
6210   static const int kOriginOptionsShift = 2;
6211   static const int kOriginOptionsSize = 3;
6212   static const int kOriginOptionsMask = ((1 << kOriginOptionsSize) - 1)
6213                                         << kOriginOptionsShift;
6214
6215   DISALLOW_IMPLICIT_CONSTRUCTORS(Script);
6216 };
6217
6218
6219 // List of builtin functions we want to identify to improve code
6220 // generation.
6221 //
6222 // Each entry has a name of a global object property holding an object
6223 // optionally followed by ".prototype", a name of a builtin function
6224 // on the object (the one the id is set for), and a label.
6225 //
6226 // Installation of ids for the selected builtin functions is handled
6227 // by the bootstrapper.
6228 #define FUNCTIONS_WITH_ID_LIST(V)                   \
6229   V(Array.prototype, indexOf, ArrayIndexOf)         \
6230   V(Array.prototype, lastIndexOf, ArrayLastIndexOf) \
6231   V(Array.prototype, push, ArrayPush)               \
6232   V(Array.prototype, pop, ArrayPop)                 \
6233   V(Array.prototype, shift, ArrayShift)             \
6234   V(Function.prototype, apply, FunctionApply)       \
6235   V(Function.prototype, call, FunctionCall)         \
6236   V(String.prototype, charCodeAt, StringCharCodeAt) \
6237   V(String.prototype, charAt, StringCharAt)         \
6238   V(String, fromCharCode, StringFromCharCode)       \
6239   V(Math, random, MathRandom)                       \
6240   V(Math, floor, MathFloor)                         \
6241   V(Math, round, MathRound)                         \
6242   V(Math, ceil, MathCeil)                           \
6243   V(Math, abs, MathAbs)                             \
6244   V(Math, log, MathLog)                             \
6245   V(Math, exp, MathExp)                             \
6246   V(Math, sqrt, MathSqrt)                           \
6247   V(Math, pow, MathPow)                             \
6248   V(Math, max, MathMax)                             \
6249   V(Math, min, MathMin)                             \
6250   V(Math, cos, MathCos)                             \
6251   V(Math, sin, MathSin)                             \
6252   V(Math, tan, MathTan)                             \
6253   V(Math, acos, MathAcos)                           \
6254   V(Math, asin, MathAsin)                           \
6255   V(Math, atan, MathAtan)                           \
6256   V(Math, atan2, MathAtan2)                         \
6257   V(Math, imul, MathImul)                           \
6258   V(Math, clz32, MathClz32)                         \
6259   V(Math, fround, MathFround)
6260
6261 #define ATOMIC_FUNCTIONS_WITH_ID_LIST(V) \
6262   V(Atomics, load, AtomicsLoad)          \
6263   V(Atomics, store, AtomicsStore)
6264
6265 enum BuiltinFunctionId {
6266   kArrayCode,
6267 #define DECLARE_FUNCTION_ID(ignored1, ignore2, name)    \
6268   k##name,
6269   FUNCTIONS_WITH_ID_LIST(DECLARE_FUNCTION_ID)
6270       ATOMIC_FUNCTIONS_WITH_ID_LIST(DECLARE_FUNCTION_ID)
6271 #undef DECLARE_FUNCTION_ID
6272   // Fake id for a special case of Math.pow. Note, it continues the
6273   // list of math functions.
6274   kMathPowHalf
6275 };
6276
6277
6278 // Result of searching in an optimized code map of a SharedFunctionInfo. Note
6279 // that both {code} and {literals} can be NULL to pass search result status.
6280 struct CodeAndLiterals {
6281   Code* code;            // Cached optimized code.
6282   FixedArray* literals;  // Cached literals array.
6283 };
6284
6285
6286 // SharedFunctionInfo describes the JSFunction information that can be
6287 // shared by multiple instances of the function.
6288 class SharedFunctionInfo: public HeapObject {
6289  public:
6290   // [name]: Function name.
6291   DECL_ACCESSORS(name, Object)
6292
6293   // [code]: Function code.
6294   DECL_ACCESSORS(code, Code)
6295   inline void ReplaceCode(Code* code);
6296
6297   // [optimized_code_map]: Map from native context to optimized code
6298   // and a shared literals array or Smi(0) if none.
6299   DECL_ACCESSORS(optimized_code_map, Object)
6300
6301   // Returns entry from optimized code map for specified context and OSR entry.
6302   // Note that {code == nullptr} indicates no matching entry has been found,
6303   // whereas {literals == nullptr} indicates the code is context-independent.
6304   CodeAndLiterals SearchOptimizedCodeMap(Context* native_context,
6305                                          BailoutId osr_ast_id);
6306
6307   // Clear optimized code map.
6308   void ClearOptimizedCodeMap();
6309
6310   // Removed a specific optimized code object from the optimized code map.
6311   void EvictFromOptimizedCodeMap(Code* optimized_code, const char* reason);
6312
6313   // Trims the optimized code map after entries have been removed.
6314   void TrimOptimizedCodeMap(int shrink_by);
6315
6316   // Add a new entry to the optimized code map for context-independent code.
6317   static void AddSharedCodeToOptimizedCodeMap(Handle<SharedFunctionInfo> shared,
6318                                               Handle<Code> code);
6319
6320   // Add a new entry to the optimized code map for context-dependent code.
6321   static void AddToOptimizedCodeMap(Handle<SharedFunctionInfo> shared,
6322                                     Handle<Context> native_context,
6323                                     Handle<Code> code,
6324                                     Handle<FixedArray> literals,
6325                                     BailoutId osr_ast_id);
6326
6327   // Set up the link between shared function info and the script. The shared
6328   // function info is added to the list on the script.
6329   static void SetScript(Handle<SharedFunctionInfo> shared,
6330                         Handle<Object> script_object);
6331
6332   // Layout description of the optimized code map.
6333   static const int kNextMapIndex = 0;
6334   static const int kSharedCodeIndex = 1;
6335   static const int kEntriesStart = 2;
6336   static const int kContextOffset = 0;
6337   static const int kCachedCodeOffset = 1;
6338   static const int kLiteralsOffset = 2;
6339   static const int kOsrAstIdOffset = 3;
6340   static const int kEntryLength = 4;
6341   static const int kInitialLength = kEntriesStart + kEntryLength;
6342
6343   // [scope_info]: Scope info.
6344   DECL_ACCESSORS(scope_info, ScopeInfo)
6345
6346   // [construct stub]: Code stub for constructing instances of this function.
6347   DECL_ACCESSORS(construct_stub, Code)
6348
6349   // Returns if this function has been compiled to native code yet.
6350   inline bool is_compiled();
6351
6352   // [length]: The function length - usually the number of declared parameters.
6353   // Use up to 2^30 parameters.
6354   inline int length() const;
6355   inline void set_length(int value);
6356
6357   // [internal formal parameter count]: The declared number of parameters.
6358   // For subclass constructors, also includes new.target.
6359   // The size of function's frame is internal_formal_parameter_count + 1.
6360   inline int internal_formal_parameter_count() const;
6361   inline void set_internal_formal_parameter_count(int value);
6362
6363   // Set the formal parameter count so the function code will be
6364   // called without using argument adaptor frames.
6365   inline void DontAdaptArguments();
6366
6367   // [expected_nof_properties]: Expected number of properties for the function.
6368   inline int expected_nof_properties() const;
6369   inline void set_expected_nof_properties(int value);
6370
6371   // [feedback_vector] - accumulates ast node feedback from full-codegen and
6372   // (increasingly) from crankshafted code where sufficient feedback isn't
6373   // available.
6374   DECL_ACCESSORS(feedback_vector, TypeFeedbackVector)
6375
6376   // Unconditionally clear the type feedback vector (including vector ICs).
6377   void ClearTypeFeedbackInfo();
6378
6379   // Clear the type feedback vector with a more subtle policy at GC time.
6380   void ClearTypeFeedbackInfoAtGCTime();
6381
6382 #if TRACE_MAPS
6383   // [unique_id] - For --trace-maps purposes, an identifier that's persistent
6384   // even if the GC moves this SharedFunctionInfo.
6385   inline int unique_id() const;
6386   inline void set_unique_id(int value);
6387 #endif
6388
6389   // [instance class name]: class name for instances.
6390   DECL_ACCESSORS(instance_class_name, Object)
6391
6392   // [function data]: This field holds some additional data for function.
6393   // Currently it has one of:
6394   //  - a FunctionTemplateInfo to make benefit the API [IsApiFunction()].
6395   //  - a Smi identifying a builtin function [HasBuiltinFunctionId()].
6396   //  - a BytecodeArray for the interpreter [HasBytecodeArray()].
6397   // In the long run we don't want all functions to have this field but
6398   // we can fix that when we have a better model for storing hidden data
6399   // on objects.
6400   DECL_ACCESSORS(function_data, Object)
6401
6402   inline bool IsApiFunction();
6403   inline FunctionTemplateInfo* get_api_func_data();
6404   inline bool HasBuiltinFunctionId();
6405   inline BuiltinFunctionId builtin_function_id();
6406   inline bool HasBytecodeArray();
6407   inline BytecodeArray* bytecode_array();
6408
6409   // [script info]: Script from which the function originates.
6410   DECL_ACCESSORS(script, Object)
6411
6412   // [num_literals]: Number of literals used by this function.
6413   inline int num_literals() const;
6414   inline void set_num_literals(int value);
6415
6416   // [start_position_and_type]: Field used to store both the source code
6417   // position, whether or not the function is a function expression,
6418   // and whether or not the function is a toplevel function. The two
6419   // least significants bit indicates whether the function is an
6420   // expression and the rest contains the source code position.
6421   inline int start_position_and_type() const;
6422   inline void set_start_position_and_type(int value);
6423
6424   // The function is subject to debugging if a debug info is attached.
6425   inline bool HasDebugInfo();
6426   inline DebugInfo* GetDebugInfo();
6427
6428   // A function has debug code if the compiled code has debug break slots.
6429   inline bool HasDebugCode();
6430
6431   // [debug info]: Debug information.
6432   DECL_ACCESSORS(debug_info, Object)
6433
6434   // [inferred name]: Name inferred from variable or property
6435   // assignment of this function. Used to facilitate debugging and
6436   // profiling of JavaScript code written in OO style, where almost
6437   // all functions are anonymous but are assigned to object
6438   // properties.
6439   DECL_ACCESSORS(inferred_name, String)
6440
6441   // The function's name if it is non-empty, otherwise the inferred name.
6442   String* DebugName();
6443
6444   // Position of the 'function' token in the script source.
6445   inline int function_token_position() const;
6446   inline void set_function_token_position(int function_token_position);
6447
6448   // Position of this function in the script source.
6449   inline int start_position() const;
6450   inline void set_start_position(int start_position);
6451
6452   // End position of this function in the script source.
6453   inline int end_position() const;
6454   inline void set_end_position(int end_position);
6455
6456   // Is this function a function expression in the source code.
6457   DECL_BOOLEAN_ACCESSORS(is_expression)
6458
6459   // Is this function a top-level function (scripts, evals).
6460   DECL_BOOLEAN_ACCESSORS(is_toplevel)
6461
6462   // Bit field containing various information collected by the compiler to
6463   // drive optimization.
6464   inline int compiler_hints() const;
6465   inline void set_compiler_hints(int value);
6466
6467   inline int ast_node_count() const;
6468   inline void set_ast_node_count(int count);
6469
6470   inline int profiler_ticks() const;
6471   inline void set_profiler_ticks(int ticks);
6472
6473   // Inline cache age is used to infer whether the function survived a context
6474   // disposal or not. In the former case we reset the opt_count.
6475   inline int ic_age();
6476   inline void set_ic_age(int age);
6477
6478   // Indicates if this function can be lazy compiled.
6479   // This is used to determine if we can safely flush code from a function
6480   // when doing GC if we expect that the function will no longer be used.
6481   DECL_BOOLEAN_ACCESSORS(allows_lazy_compilation)
6482
6483   // Indicates if this function can be lazy compiled without a context.
6484   // This is used to determine if we can force compilation without reaching
6485   // the function through program execution but through other means (e.g. heap
6486   // iteration by the debugger).
6487   DECL_BOOLEAN_ACCESSORS(allows_lazy_compilation_without_context)
6488
6489   // Indicates whether optimizations have been disabled for this
6490   // shared function info. If a function is repeatedly optimized or if
6491   // we cannot optimize the function we disable optimization to avoid
6492   // spending time attempting to optimize it again.
6493   DECL_BOOLEAN_ACCESSORS(optimization_disabled)
6494
6495   // Indicates the language mode.
6496   inline LanguageMode language_mode();
6497   inline void set_language_mode(LanguageMode language_mode);
6498
6499   // False if the function definitely does not allocate an arguments object.
6500   DECL_BOOLEAN_ACCESSORS(uses_arguments)
6501
6502   // Indicates that this function uses a super property (or an eval that may
6503   // use a super property).
6504   // This is needed to set up the [[HomeObject]] on the function instance.
6505   DECL_BOOLEAN_ACCESSORS(needs_home_object)
6506
6507   // True if the function has any duplicated parameter names.
6508   DECL_BOOLEAN_ACCESSORS(has_duplicate_parameters)
6509
6510   // Indicates whether the function is a native function.
6511   // These needs special treatment in .call and .apply since
6512   // null passed as the receiver should not be translated to the
6513   // global object.
6514   DECL_BOOLEAN_ACCESSORS(native)
6515
6516   // Indicate that this function should always be inlined in optimized code.
6517   DECL_BOOLEAN_ACCESSORS(force_inline)
6518
6519   // Indicates that the function was created by the Function function.
6520   // Though it's anonymous, toString should treat it as if it had the name
6521   // "anonymous".  We don't set the name itself so that the system does not
6522   // see a binding for it.
6523   DECL_BOOLEAN_ACCESSORS(name_should_print_as_anonymous)
6524
6525   // Indicates whether the function is a bound function created using
6526   // the bind function.
6527   DECL_BOOLEAN_ACCESSORS(bound)
6528
6529   // Indicates that the function is anonymous (the name field can be set
6530   // through the API, which does not change this flag).
6531   DECL_BOOLEAN_ACCESSORS(is_anonymous)
6532
6533   // Is this a function or top-level/eval code.
6534   DECL_BOOLEAN_ACCESSORS(is_function)
6535
6536   // Indicates that code for this function cannot be compiled with Crankshaft.
6537   DECL_BOOLEAN_ACCESSORS(dont_crankshaft)
6538
6539   // Indicates that code for this function cannot be flushed.
6540   DECL_BOOLEAN_ACCESSORS(dont_flush)
6541
6542   // Indicates that this function is a generator.
6543   DECL_BOOLEAN_ACCESSORS(is_generator)
6544
6545   // Indicates that this function is an arrow function.
6546   DECL_BOOLEAN_ACCESSORS(is_arrow)
6547
6548   // Indicates that this function is a concise method.
6549   DECL_BOOLEAN_ACCESSORS(is_concise_method)
6550
6551   // Indicates that this function is an accessor (getter or setter).
6552   DECL_BOOLEAN_ACCESSORS(is_accessor_function)
6553
6554   // Indicates that this function is a default constructor.
6555   DECL_BOOLEAN_ACCESSORS(is_default_constructor)
6556
6557   // Indicates that this function is an asm function.
6558   DECL_BOOLEAN_ACCESSORS(asm_function)
6559
6560   // Indicates that the the shared function info is deserialized from cache.
6561   DECL_BOOLEAN_ACCESSORS(deserialized)
6562
6563   // Indicates that the the shared function info has never been compiled before.
6564   DECL_BOOLEAN_ACCESSORS(never_compiled)
6565
6566   inline FunctionKind kind();
6567   inline void set_kind(FunctionKind kind);
6568
6569   // Indicates whether or not the code in the shared function support
6570   // deoptimization.
6571   inline bool has_deoptimization_support();
6572
6573   // Enable deoptimization support through recompiled code.
6574   void EnableDeoptimizationSupport(Code* recompiled);
6575
6576   // Disable (further) attempted optimization of all functions sharing this
6577   // shared function info.
6578   void DisableOptimization(BailoutReason reason);
6579
6580   inline BailoutReason disable_optimization_reason();
6581
6582   // Lookup the bailout ID and DCHECK that it exists in the non-optimized
6583   // code, returns whether it asserted (i.e., always true if assertions are
6584   // disabled).
6585   bool VerifyBailoutId(BailoutId id);
6586
6587   // [source code]: Source code for the function.
6588   bool HasSourceCode() const;
6589   Handle<Object> GetSourceCode();
6590
6591   // Number of times the function was optimized.
6592   inline int opt_count();
6593   inline void set_opt_count(int opt_count);
6594
6595   // Number of times the function was deoptimized.
6596   inline void set_deopt_count(int value);
6597   inline int deopt_count();
6598   inline void increment_deopt_count();
6599
6600   // Number of time we tried to re-enable optimization after it
6601   // was disabled due to high number of deoptimizations.
6602   inline void set_opt_reenable_tries(int value);
6603   inline int opt_reenable_tries();
6604
6605   inline void TryReenableOptimization();
6606
6607   // Stores deopt_count, opt_reenable_tries and ic_age as bit-fields.
6608   inline void set_counters(int value);
6609   inline int counters() const;
6610
6611   // Stores opt_count and bailout_reason as bit-fields.
6612   inline void set_opt_count_and_bailout_reason(int value);
6613   inline int opt_count_and_bailout_reason() const;
6614
6615   void set_disable_optimization_reason(BailoutReason reason) {
6616     set_opt_count_and_bailout_reason(
6617         DisabledOptimizationReasonBits::update(opt_count_and_bailout_reason(),
6618                                                reason));
6619   }
6620
6621   // Tells whether this function should be subject to debugging.
6622   inline bool IsSubjectToDebugging();
6623
6624   // Check whether or not this function is inlineable.
6625   bool IsInlineable();
6626
6627   // Source size of this function.
6628   int SourceSize();
6629
6630   // Calculate the instance size.
6631   int CalculateInstanceSize();
6632
6633   // Calculate the number of in-object properties.
6634   int CalculateInObjectProperties();
6635
6636   inline bool is_simple_parameter_list();
6637
6638   // Initialize a SharedFunctionInfo from a parsed function literal.
6639   static void InitFromFunctionLiteral(Handle<SharedFunctionInfo> shared_info,
6640                                       FunctionLiteral* lit);
6641
6642   // Dispatched behavior.
6643   DECLARE_PRINTER(SharedFunctionInfo)
6644   DECLARE_VERIFIER(SharedFunctionInfo)
6645
6646   void ResetForNewContext(int new_ic_age);
6647
6648   DECLARE_CAST(SharedFunctionInfo)
6649
6650   // Constants.
6651   static const int kDontAdaptArgumentsSentinel = -1;
6652
6653   // Layout description.
6654   // Pointer fields.
6655   static const int kNameOffset = HeapObject::kHeaderSize;
6656   static const int kCodeOffset = kNameOffset + kPointerSize;
6657   static const int kOptimizedCodeMapOffset = kCodeOffset + kPointerSize;
6658   static const int kScopeInfoOffset = kOptimizedCodeMapOffset + kPointerSize;
6659   static const int kConstructStubOffset = kScopeInfoOffset + kPointerSize;
6660   static const int kInstanceClassNameOffset =
6661       kConstructStubOffset + kPointerSize;
6662   static const int kFunctionDataOffset =
6663       kInstanceClassNameOffset + kPointerSize;
6664   static const int kScriptOffset = kFunctionDataOffset + kPointerSize;
6665   static const int kDebugInfoOffset = kScriptOffset + kPointerSize;
6666   static const int kInferredNameOffset = kDebugInfoOffset + kPointerSize;
6667   static const int kFeedbackVectorOffset =
6668       kInferredNameOffset + kPointerSize;
6669 #if TRACE_MAPS
6670   static const int kUniqueIdOffset = kFeedbackVectorOffset + kPointerSize;
6671   static const int kLastPointerFieldOffset = kUniqueIdOffset;
6672 #else
6673   // Just to not break the postmortrem support with conditional offsets
6674   static const int kUniqueIdOffset = kFeedbackVectorOffset;
6675   static const int kLastPointerFieldOffset = kFeedbackVectorOffset;
6676 #endif
6677
6678 #if V8_HOST_ARCH_32_BIT
6679   // Smi fields.
6680   static const int kLengthOffset = kLastPointerFieldOffset + kPointerSize;
6681   static const int kFormalParameterCountOffset = kLengthOffset + kPointerSize;
6682   static const int kExpectedNofPropertiesOffset =
6683       kFormalParameterCountOffset + kPointerSize;
6684   static const int kNumLiteralsOffset =
6685       kExpectedNofPropertiesOffset + kPointerSize;
6686   static const int kStartPositionAndTypeOffset =
6687       kNumLiteralsOffset + kPointerSize;
6688   static const int kEndPositionOffset =
6689       kStartPositionAndTypeOffset + kPointerSize;
6690   static const int kFunctionTokenPositionOffset =
6691       kEndPositionOffset + kPointerSize;
6692   static const int kCompilerHintsOffset =
6693       kFunctionTokenPositionOffset + kPointerSize;
6694   static const int kOptCountAndBailoutReasonOffset =
6695       kCompilerHintsOffset + kPointerSize;
6696   static const int kCountersOffset =
6697       kOptCountAndBailoutReasonOffset + kPointerSize;
6698   static const int kAstNodeCountOffset =
6699       kCountersOffset + kPointerSize;
6700   static const int kProfilerTicksOffset =
6701       kAstNodeCountOffset + kPointerSize;
6702
6703   // Total size.
6704   static const int kSize = kProfilerTicksOffset + kPointerSize;
6705 #else
6706   // The only reason to use smi fields instead of int fields
6707   // is to allow iteration without maps decoding during
6708   // garbage collections.
6709   // To avoid wasting space on 64-bit architectures we use
6710   // the following trick: we group integer fields into pairs
6711 // The least significant integer in each pair is shifted left by 1.
6712 // By doing this we guarantee that LSB of each kPointerSize aligned
6713 // word is not set and thus this word cannot be treated as pointer
6714 // to HeapObject during old space traversal.
6715 #if V8_TARGET_LITTLE_ENDIAN
6716   static const int kLengthOffset = kLastPointerFieldOffset + kPointerSize;
6717   static const int kFormalParameterCountOffset =
6718       kLengthOffset + kIntSize;
6719
6720   static const int kExpectedNofPropertiesOffset =
6721       kFormalParameterCountOffset + kIntSize;
6722   static const int kNumLiteralsOffset =
6723       kExpectedNofPropertiesOffset + kIntSize;
6724
6725   static const int kEndPositionOffset =
6726       kNumLiteralsOffset + kIntSize;
6727   static const int kStartPositionAndTypeOffset =
6728       kEndPositionOffset + kIntSize;
6729
6730   static const int kFunctionTokenPositionOffset =
6731       kStartPositionAndTypeOffset + kIntSize;
6732   static const int kCompilerHintsOffset =
6733       kFunctionTokenPositionOffset + kIntSize;
6734
6735   static const int kOptCountAndBailoutReasonOffset =
6736       kCompilerHintsOffset + kIntSize;
6737   static const int kCountersOffset =
6738       kOptCountAndBailoutReasonOffset + kIntSize;
6739
6740   static const int kAstNodeCountOffset =
6741       kCountersOffset + kIntSize;
6742   static const int kProfilerTicksOffset =
6743       kAstNodeCountOffset + kIntSize;
6744
6745   // Total size.
6746   static const int kSize = kProfilerTicksOffset + kIntSize;
6747
6748 #elif V8_TARGET_BIG_ENDIAN
6749   static const int kFormalParameterCountOffset =
6750       kLastPointerFieldOffset + kPointerSize;
6751   static const int kLengthOffset = kFormalParameterCountOffset + kIntSize;
6752
6753   static const int kNumLiteralsOffset = kLengthOffset + kIntSize;
6754   static const int kExpectedNofPropertiesOffset = kNumLiteralsOffset + kIntSize;
6755
6756   static const int kStartPositionAndTypeOffset =
6757       kExpectedNofPropertiesOffset + kIntSize;
6758   static const int kEndPositionOffset = kStartPositionAndTypeOffset + kIntSize;
6759
6760   static const int kCompilerHintsOffset = kEndPositionOffset + kIntSize;
6761   static const int kFunctionTokenPositionOffset =
6762       kCompilerHintsOffset + kIntSize;
6763
6764   static const int kCountersOffset = kFunctionTokenPositionOffset + kIntSize;
6765   static const int kOptCountAndBailoutReasonOffset = kCountersOffset + kIntSize;
6766
6767   static const int kProfilerTicksOffset =
6768       kOptCountAndBailoutReasonOffset + kIntSize;
6769   static const int kAstNodeCountOffset = kProfilerTicksOffset + kIntSize;
6770
6771   // Total size.
6772   static const int kSize = kAstNodeCountOffset + kIntSize;
6773
6774 #else
6775 #error Unknown byte ordering
6776 #endif  // Big endian
6777 #endif  // 64-bit
6778
6779
6780   static const int kAlignedSize = POINTER_SIZE_ALIGN(kSize);
6781
6782   typedef FixedBodyDescriptor<kNameOffset,
6783                               kLastPointerFieldOffset + kPointerSize,
6784                               kSize> BodyDescriptor;
6785
6786   // Bit positions in start_position_and_type.
6787   // The source code start position is in the 30 most significant bits of
6788   // the start_position_and_type field.
6789   static const int kIsExpressionBit    = 0;
6790   static const int kIsTopLevelBit      = 1;
6791   static const int kStartPositionShift = 2;
6792   static const int kStartPositionMask  = ~((1 << kStartPositionShift) - 1);
6793
6794   // Bit positions in compiler_hints.
6795   enum CompilerHints {
6796     kAllowLazyCompilation,
6797     kAllowLazyCompilationWithoutContext,
6798     kOptimizationDisabled,
6799     kStrictModeFunction,
6800     kStrongModeFunction,
6801     kUsesArguments,
6802     kNeedsHomeObject,
6803     kHasDuplicateParameters,
6804     kNative,
6805     kForceInline,
6806     kBoundFunction,
6807     kIsAnonymous,
6808     kNameShouldPrintAsAnonymous,
6809     kIsFunction,
6810     kDontCrankshaft,
6811     kDontFlush,
6812     kIsArrow,
6813     kIsGenerator,
6814     kIsConciseMethod,
6815     kIsAccessorFunction,
6816     kIsDefaultConstructor,
6817     kIsSubclassConstructor,
6818     kIsBaseConstructor,
6819     kInClassLiteral,
6820     kIsAsmFunction,
6821     kDeserialized,
6822     kNeverCompiled,
6823     kCompilerHintsCount  // Pseudo entry
6824   };
6825   // Add hints for other modes when they're added.
6826   STATIC_ASSERT(LANGUAGE_END == 3);
6827
6828   class FunctionKindBits : public BitField<FunctionKind, kIsArrow, 8> {};
6829
6830   class DeoptCountBits : public BitField<int, 0, 4> {};
6831   class OptReenableTriesBits : public BitField<int, 4, 18> {};
6832   class ICAgeBits : public BitField<int, 22, 8> {};
6833
6834   class OptCountBits : public BitField<int, 0, 22> {};
6835   class DisabledOptimizationReasonBits : public BitField<int, 22, 8> {};
6836
6837  private:
6838 #if V8_HOST_ARCH_32_BIT
6839   // On 32 bit platforms, compiler hints is a smi.
6840   static const int kCompilerHintsSmiTagSize = kSmiTagSize;
6841   static const int kCompilerHintsSize = kPointerSize;
6842 #else
6843   // On 64 bit platforms, compiler hints is not a smi, see comment above.
6844   static const int kCompilerHintsSmiTagSize = 0;
6845   static const int kCompilerHintsSize = kIntSize;
6846 #endif
6847
6848   STATIC_ASSERT(SharedFunctionInfo::kCompilerHintsCount <=
6849                 SharedFunctionInfo::kCompilerHintsSize * kBitsPerByte);
6850
6851  public:
6852   // Constants for optimizing codegen for strict mode function and
6853   // native tests.
6854   // Allows to use byte-width instructions.
6855   static const int kStrictModeBitWithinByte =
6856       (kStrictModeFunction + kCompilerHintsSmiTagSize) % kBitsPerByte;
6857   static const int kStrongModeBitWithinByte =
6858       (kStrongModeFunction + kCompilerHintsSmiTagSize) % kBitsPerByte;
6859
6860   static const int kNativeBitWithinByte =
6861       (kNative + kCompilerHintsSmiTagSize) % kBitsPerByte;
6862
6863 #if defined(V8_TARGET_LITTLE_ENDIAN)
6864   static const int kStrictModeByteOffset = kCompilerHintsOffset +
6865       (kStrictModeFunction + kCompilerHintsSmiTagSize) / kBitsPerByte;
6866   static const int kStrongModeByteOffset =
6867       kCompilerHintsOffset +
6868       (kStrongModeFunction + kCompilerHintsSmiTagSize) / kBitsPerByte;
6869   static const int kNativeByteOffset = kCompilerHintsOffset +
6870       (kNative + kCompilerHintsSmiTagSize) / kBitsPerByte;
6871 #elif defined(V8_TARGET_BIG_ENDIAN)
6872   static const int kStrictModeByteOffset = kCompilerHintsOffset +
6873       (kCompilerHintsSize - 1) -
6874       ((kStrictModeFunction + kCompilerHintsSmiTagSize) / kBitsPerByte);
6875   static const int kStrongModeByteOffset =
6876       kCompilerHintsOffset + (kCompilerHintsSize - 1) -
6877       ((kStrongModeFunction + kCompilerHintsSmiTagSize) / kBitsPerByte);
6878   static const int kNativeByteOffset = kCompilerHintsOffset +
6879       (kCompilerHintsSize - 1) -
6880       ((kNative + kCompilerHintsSmiTagSize) / kBitsPerByte);
6881 #else
6882 #error Unknown byte ordering
6883 #endif
6884
6885  private:
6886   DISALLOW_IMPLICIT_CONSTRUCTORS(SharedFunctionInfo);
6887 };
6888
6889
6890 // Printing support.
6891 struct SourceCodeOf {
6892   explicit SourceCodeOf(SharedFunctionInfo* v, int max = -1)
6893       : value(v), max_length(max) {}
6894   const SharedFunctionInfo* value;
6895   int max_length;
6896 };
6897
6898
6899 std::ostream& operator<<(std::ostream& os, const SourceCodeOf& v);
6900
6901
6902 class JSGeneratorObject: public JSObject {
6903  public:
6904   // [function]: The function corresponding to this generator object.
6905   DECL_ACCESSORS(function, JSFunction)
6906
6907   // [context]: The context of the suspended computation.
6908   DECL_ACCESSORS(context, Context)
6909
6910   // [receiver]: The receiver of the suspended computation.
6911   DECL_ACCESSORS(receiver, Object)
6912
6913   // [continuation]: Offset into code of continuation.
6914   //
6915   // A positive offset indicates a suspended generator.  The special
6916   // kGeneratorExecuting and kGeneratorClosed values indicate that a generator
6917   // cannot be resumed.
6918   inline int continuation() const;
6919   inline void set_continuation(int continuation);
6920   inline bool is_closed();
6921   inline bool is_executing();
6922   inline bool is_suspended();
6923
6924   // [operand_stack]: Saved operand stack.
6925   DECL_ACCESSORS(operand_stack, FixedArray)
6926
6927   DECLARE_CAST(JSGeneratorObject)
6928
6929   // Dispatched behavior.
6930   DECLARE_PRINTER(JSGeneratorObject)
6931   DECLARE_VERIFIER(JSGeneratorObject)
6932
6933   // Magic sentinel values for the continuation.
6934   static const int kGeneratorExecuting = -1;
6935   static const int kGeneratorClosed = 0;
6936
6937   // Layout description.
6938   static const int kFunctionOffset = JSObject::kHeaderSize;
6939   static const int kContextOffset = kFunctionOffset + kPointerSize;
6940   static const int kReceiverOffset = kContextOffset + kPointerSize;
6941   static const int kContinuationOffset = kReceiverOffset + kPointerSize;
6942   static const int kOperandStackOffset = kContinuationOffset + kPointerSize;
6943   static const int kSize = kOperandStackOffset + kPointerSize;
6944
6945   // Resume mode, for use by runtime functions.
6946   enum ResumeMode { NEXT, THROW };
6947
6948   // Yielding from a generator returns an object with the following inobject
6949   // properties.  See Context::iterator_result_map() for the map.
6950   static const int kResultValuePropertyIndex = 0;
6951   static const int kResultDonePropertyIndex = 1;
6952   static const int kResultPropertyCount = 2;
6953
6954   static const int kResultValuePropertyOffset = JSObject::kHeaderSize;
6955   static const int kResultDonePropertyOffset =
6956       kResultValuePropertyOffset + kPointerSize;
6957   static const int kResultSize = kResultDonePropertyOffset + kPointerSize;
6958
6959  private:
6960   DISALLOW_IMPLICIT_CONSTRUCTORS(JSGeneratorObject);
6961 };
6962
6963
6964 // Representation for module instance objects.
6965 class JSModule: public JSObject {
6966  public:
6967   // [context]: the context holding the module's locals, or undefined if none.
6968   DECL_ACCESSORS(context, Object)
6969
6970   // [scope_info]: Scope info.
6971   DECL_ACCESSORS(scope_info, ScopeInfo)
6972
6973   DECLARE_CAST(JSModule)
6974
6975   // Dispatched behavior.
6976   DECLARE_PRINTER(JSModule)
6977   DECLARE_VERIFIER(JSModule)
6978
6979   // Layout description.
6980   static const int kContextOffset = JSObject::kHeaderSize;
6981   static const int kScopeInfoOffset = kContextOffset + kPointerSize;
6982   static const int kSize = kScopeInfoOffset + kPointerSize;
6983
6984  private:
6985   DISALLOW_IMPLICIT_CONSTRUCTORS(JSModule);
6986 };
6987
6988
6989 // JSFunction describes JavaScript functions.
6990 class JSFunction: public JSObject {
6991  public:
6992   // [prototype_or_initial_map]:
6993   DECL_ACCESSORS(prototype_or_initial_map, Object)
6994
6995   // [shared]: The information about the function that
6996   // can be shared by instances.
6997   DECL_ACCESSORS(shared, SharedFunctionInfo)
6998
6999   // [context]: The context for this function.
7000   inline Context* context();
7001   inline void set_context(Object* context);
7002   inline JSObject* global_proxy();
7003
7004   // [code]: The generated code object for this function.  Executed
7005   // when the function is invoked, e.g. foo() or new foo(). See
7006   // [[Call]] and [[Construct]] description in ECMA-262, section
7007   // 8.6.2, page 27.
7008   inline Code* code();
7009   inline void set_code(Code* code);
7010   inline void set_code_no_write_barrier(Code* code);
7011   inline void ReplaceCode(Code* code);
7012
7013   // Tells whether this function is builtin.
7014   inline bool IsBuiltin();
7015
7016   // Tells whether this function inlines the given shared function info.
7017   bool Inlines(SharedFunctionInfo* candidate);
7018
7019   // Tells whether this function should be subject to debugging.
7020   inline bool IsSubjectToDebugging();
7021
7022   // Tells whether or not the function needs arguments adaption.
7023   inline bool NeedsArgumentsAdaption();
7024
7025   // Tells whether or not this function has been optimized.
7026   inline bool IsOptimized();
7027
7028   // Mark this function for lazy recompilation. The function will be
7029   // recompiled the next time it is executed.
7030   void MarkForOptimization();
7031   void AttemptConcurrentOptimization();
7032
7033   // Tells whether or not the function is already marked for lazy
7034   // recompilation.
7035   inline bool IsMarkedForOptimization();
7036   inline bool IsMarkedForConcurrentOptimization();
7037
7038   // Tells whether or not the function is on the concurrent recompilation queue.
7039   inline bool IsInOptimizationQueue();
7040
7041   // Inobject slack tracking is the way to reclaim unused inobject space.
7042   //
7043   // The instance size is initially determined by adding some slack to
7044   // expected_nof_properties (to allow for a few extra properties added
7045   // after the constructor). There is no guarantee that the extra space
7046   // will not be wasted.
7047   //
7048   // Here is the algorithm to reclaim the unused inobject space:
7049   // - Detect the first constructor call for this JSFunction.
7050   //   When it happens enter the "in progress" state: initialize construction
7051   //   counter in the initial_map.
7052   // - While the tracking is in progress create objects filled with
7053   //   one_pointer_filler_map instead of undefined_value. This way they can be
7054   //   resized quickly and safely.
7055   // - Once enough objects have been created  compute the 'slack'
7056   //   (traverse the map transition tree starting from the
7057   //   initial_map and find the lowest value of unused_property_fields).
7058   // - Traverse the transition tree again and decrease the instance size
7059   //   of every map. Existing objects will resize automatically (they are
7060   //   filled with one_pointer_filler_map). All further allocations will
7061   //   use the adjusted instance size.
7062   // - SharedFunctionInfo's expected_nof_properties left unmodified since
7063   //   allocations made using different closures could actually create different
7064   //   kind of objects (see prototype inheritance pattern).
7065   //
7066   //  Important: inobject slack tracking is not attempted during the snapshot
7067   //  creation.
7068
7069   // True if the initial_map is set and the object constructions countdown
7070   // counter is not zero.
7071   static const int kGenerousAllocationCount =
7072       Map::kSlackTrackingCounterStart - Map::kSlackTrackingCounterEnd + 1;
7073   inline bool IsInobjectSlackTrackingInProgress();
7074
7075   // Starts the tracking.
7076   // Initializes object constructions countdown counter in the initial map.
7077   void StartInobjectSlackTracking();
7078
7079   // Completes the tracking.
7080   void CompleteInobjectSlackTracking();
7081
7082   // [literals_or_bindings]: Fixed array holding either
7083   // the materialized literals or the bindings of a bound function.
7084   //
7085   // If the function contains object, regexp or array literals, the
7086   // literals array prefix contains the object, regexp, and array
7087   // function to be used when creating these literals.  This is
7088   // necessary so that we do not dynamically lookup the object, regexp
7089   // or array functions.  Performing a dynamic lookup, we might end up
7090   // using the functions from a new context that we should not have
7091   // access to.
7092   //
7093   // On bound functions, the array is a (copy-on-write) fixed-array containing
7094   // the function that was bound, bound this-value and any bound
7095   // arguments. Bound functions never contain literals.
7096   DECL_ACCESSORS(literals_or_bindings, FixedArray)
7097
7098   inline FixedArray* literals();
7099   inline void set_literals(FixedArray* literals);
7100
7101   inline FixedArray* function_bindings();
7102   inline void set_function_bindings(FixedArray* bindings);
7103
7104   // The initial map for an object created by this constructor.
7105   inline Map* initial_map();
7106   static void SetInitialMap(Handle<JSFunction> function, Handle<Map> map,
7107                             Handle<Object> prototype);
7108   inline bool has_initial_map();
7109   static void EnsureHasInitialMap(Handle<JSFunction> function);
7110
7111   // Get and set the prototype property on a JSFunction. If the
7112   // function has an initial map the prototype is set on the initial
7113   // map. Otherwise, the prototype is put in the initial map field
7114   // until an initial map is needed.
7115   inline bool has_prototype();
7116   inline bool has_instance_prototype();
7117   inline Object* prototype();
7118   inline Object* instance_prototype();
7119   static void SetPrototype(Handle<JSFunction> function,
7120                            Handle<Object> value);
7121   static void SetInstancePrototype(Handle<JSFunction> function,
7122                                    Handle<Object> value);
7123
7124   // Creates a new closure for the fucntion with the same bindings,
7125   // bound values, and prototype. An equivalent of spec operations
7126   // ``CloneMethod`` and ``CloneBoundFunction``.
7127   static Handle<JSFunction> CloneClosure(Handle<JSFunction> function);
7128
7129   // After prototype is removed, it will not be created when accessed, and
7130   // [[Construct]] from this function will not be allowed.
7131   bool RemovePrototype();
7132   inline bool should_have_prototype();
7133
7134   // Accessor for this function's initial map's [[class]]
7135   // property. This is primarily used by ECMA native functions.  This
7136   // method sets the class_name field of this function's initial map
7137   // to a given value. It creates an initial map if this function does
7138   // not have one. Note that this method does not copy the initial map
7139   // if it has one already, but simply replaces it with the new value.
7140   // Instances created afterwards will have a map whose [[class]] is
7141   // set to 'value', but there is no guarantees on instances created
7142   // before.
7143   void SetInstanceClassName(String* name);
7144
7145   // Returns if this function has been compiled to native code yet.
7146   inline bool is_compiled();
7147
7148   // Returns `false` if formal parameters include rest parameters, optional
7149   // parameters, or destructuring parameters.
7150   // TODO(caitp): make this a flag set during parsing
7151   inline bool is_simple_parameter_list();
7152
7153   // [next_function_link]: Links functions into various lists, e.g. the list
7154   // of optimized functions hanging off the native_context. The CodeFlusher
7155   // uses this link to chain together flushing candidates. Treated weakly
7156   // by the garbage collector.
7157   DECL_ACCESSORS(next_function_link, Object)
7158
7159   // Prints the name of the function using PrintF.
7160   void PrintName(FILE* out = stdout);
7161
7162   DECLARE_CAST(JSFunction)
7163
7164   // Iterates the objects, including code objects indirectly referenced
7165   // through pointers to the first instruction in the code object.
7166   void JSFunctionIterateBody(int object_size, ObjectVisitor* v);
7167
7168   // Dispatched behavior.
7169   DECLARE_PRINTER(JSFunction)
7170   DECLARE_VERIFIER(JSFunction)
7171
7172   // Returns the number of allocated literals.
7173   inline int NumberOfLiterals();
7174
7175   // Used for flags such as --hydrogen-filter.
7176   bool PassesFilter(const char* raw_filter);
7177
7178   // The function's name if it is configured, otherwise shared function info
7179   // debug name.
7180   static Handle<String> GetDebugName(Handle<JSFunction> function);
7181
7182   // Layout descriptors. The last property (from kNonWeakFieldsEndOffset to
7183   // kSize) is weak and has special handling during garbage collection.
7184   static const int kCodeEntryOffset = JSObject::kHeaderSize;
7185   static const int kPrototypeOrInitialMapOffset =
7186       kCodeEntryOffset + kPointerSize;
7187   static const int kSharedFunctionInfoOffset =
7188       kPrototypeOrInitialMapOffset + kPointerSize;
7189   static const int kContextOffset = kSharedFunctionInfoOffset + kPointerSize;
7190   static const int kLiteralsOffset = kContextOffset + kPointerSize;
7191   static const int kNonWeakFieldsEndOffset = kLiteralsOffset + kPointerSize;
7192   static const int kNextFunctionLinkOffset = kNonWeakFieldsEndOffset;
7193   static const int kSize = kNextFunctionLinkOffset + kPointerSize;
7194
7195   // Layout of the bound-function binding array.
7196   static const int kBoundFunctionIndex = 0;
7197   static const int kBoundThisIndex = 1;
7198   static const int kBoundArgumentsStartIndex = 2;
7199
7200  private:
7201   DISALLOW_IMPLICIT_CONSTRUCTORS(JSFunction);
7202 };
7203
7204
7205 // JSGlobalProxy's prototype must be a JSGlobalObject or null,
7206 // and the prototype is hidden. JSGlobalProxy always delegates
7207 // property accesses to its prototype if the prototype is not null.
7208 //
7209 // A JSGlobalProxy can be reinitialized which will preserve its identity.
7210 //
7211 // Accessing a JSGlobalProxy requires security check.
7212
7213 class JSGlobalProxy : public JSObject {
7214  public:
7215   // [native_context]: the owner native context of this global proxy object.
7216   // It is null value if this object is not used by any context.
7217   DECL_ACCESSORS(native_context, Object)
7218
7219   // [hash]: The hash code property (undefined if not initialized yet).
7220   DECL_ACCESSORS(hash, Object)
7221
7222   DECLARE_CAST(JSGlobalProxy)
7223
7224   inline bool IsDetachedFrom(GlobalObject* global) const;
7225
7226   // Dispatched behavior.
7227   DECLARE_PRINTER(JSGlobalProxy)
7228   DECLARE_VERIFIER(JSGlobalProxy)
7229
7230   // Layout description.
7231   static const int kNativeContextOffset = JSObject::kHeaderSize;
7232   static const int kHashOffset = kNativeContextOffset + kPointerSize;
7233   static const int kSize = kHashOffset + kPointerSize;
7234
7235  private:
7236   DISALLOW_IMPLICIT_CONSTRUCTORS(JSGlobalProxy);
7237 };
7238
7239
7240 // Common super class for JavaScript global objects and the special
7241 // builtins global objects.
7242 class GlobalObject: public JSObject {
7243  public:
7244   // [builtins]: the object holding the runtime routines written in JS.
7245   DECL_ACCESSORS(builtins, JSBuiltinsObject)
7246
7247   // [native context]: the natives corresponding to this global object.
7248   DECL_ACCESSORS(native_context, Context)
7249
7250   // [global proxy]: the global proxy object of the context
7251   DECL_ACCESSORS(global_proxy, JSObject)
7252
7253   DECLARE_CAST(GlobalObject)
7254
7255   static void InvalidatePropertyCell(Handle<GlobalObject> object,
7256                                      Handle<Name> name);
7257   // Ensure that the global object has a cell for the given property name.
7258   static Handle<PropertyCell> EnsurePropertyCell(Handle<GlobalObject> global,
7259                                                  Handle<Name> name);
7260
7261   // Layout description.
7262   static const int kBuiltinsOffset = JSObject::kHeaderSize;
7263   static const int kNativeContextOffset = kBuiltinsOffset + kPointerSize;
7264   static const int kGlobalProxyOffset = kNativeContextOffset + kPointerSize;
7265   static const int kHeaderSize = kGlobalProxyOffset + kPointerSize;
7266
7267  private:
7268   DISALLOW_IMPLICIT_CONSTRUCTORS(GlobalObject);
7269 };
7270
7271
7272 // JavaScript global object.
7273 class JSGlobalObject: public GlobalObject {
7274  public:
7275   DECLARE_CAST(JSGlobalObject)
7276
7277   inline bool IsDetached();
7278
7279   // Dispatched behavior.
7280   DECLARE_PRINTER(JSGlobalObject)
7281   DECLARE_VERIFIER(JSGlobalObject)
7282
7283   // Layout description.
7284   static const int kSize = GlobalObject::kHeaderSize;
7285
7286  private:
7287   DISALLOW_IMPLICIT_CONSTRUCTORS(JSGlobalObject);
7288 };
7289
7290
7291 // Builtins global object which holds the runtime routines written in
7292 // JavaScript.
7293 class JSBuiltinsObject: public GlobalObject {
7294  public:
7295   // Accessors for the runtime routines written in JavaScript.
7296   inline Object* javascript_builtin(Builtins::JavaScript id);
7297   inline void set_javascript_builtin(Builtins::JavaScript id, Object* value);
7298
7299   DECLARE_CAST(JSBuiltinsObject)
7300
7301   // Dispatched behavior.
7302   DECLARE_PRINTER(JSBuiltinsObject)
7303   DECLARE_VERIFIER(JSBuiltinsObject)
7304
7305   // Layout description.  The size of the builtins object includes
7306   // room for two pointers per runtime routine written in javascript
7307   // (function and code object).
7308   static const int kJSBuiltinsCount = Builtins::id_count;
7309   static const int kJSBuiltinsOffset = GlobalObject::kHeaderSize;
7310   static const int kSize =
7311       GlobalObject::kHeaderSize + (kJSBuiltinsCount * kPointerSize);
7312
7313   static int OffsetOfFunctionWithId(Builtins::JavaScript id) {
7314     return kJSBuiltinsOffset + id * kPointerSize;
7315   }
7316
7317  private:
7318   DISALLOW_IMPLICIT_CONSTRUCTORS(JSBuiltinsObject);
7319 };
7320
7321
7322 // Representation for JS Wrapper objects, String, Number, Boolean, etc.
7323 class JSValue: public JSObject {
7324  public:
7325   // [value]: the object being wrapped.
7326   DECL_ACCESSORS(value, Object)
7327
7328   DECLARE_CAST(JSValue)
7329
7330   // Dispatched behavior.
7331   DECLARE_PRINTER(JSValue)
7332   DECLARE_VERIFIER(JSValue)
7333
7334   // Layout description.
7335   static const int kValueOffset = JSObject::kHeaderSize;
7336   static const int kSize = kValueOffset + kPointerSize;
7337
7338  private:
7339   DISALLOW_IMPLICIT_CONSTRUCTORS(JSValue);
7340 };
7341
7342
7343 class DateCache;
7344
7345 // Representation for JS date objects.
7346 class JSDate: public JSObject {
7347  public:
7348   // If one component is NaN, all of them are, indicating a NaN time value.
7349   // [value]: the time value.
7350   DECL_ACCESSORS(value, Object)
7351   // [year]: caches year. Either undefined, smi, or NaN.
7352   DECL_ACCESSORS(year, Object)
7353   // [month]: caches month. Either undefined, smi, or NaN.
7354   DECL_ACCESSORS(month, Object)
7355   // [day]: caches day. Either undefined, smi, or NaN.
7356   DECL_ACCESSORS(day, Object)
7357   // [weekday]: caches day of week. Either undefined, smi, or NaN.
7358   DECL_ACCESSORS(weekday, Object)
7359   // [hour]: caches hours. Either undefined, smi, or NaN.
7360   DECL_ACCESSORS(hour, Object)
7361   // [min]: caches minutes. Either undefined, smi, or NaN.
7362   DECL_ACCESSORS(min, Object)
7363   // [sec]: caches seconds. Either undefined, smi, or NaN.
7364   DECL_ACCESSORS(sec, Object)
7365   // [cache stamp]: sample of the date cache stamp at the
7366   // moment when chached fields were cached.
7367   DECL_ACCESSORS(cache_stamp, Object)
7368
7369   DECLARE_CAST(JSDate)
7370
7371   // Returns the date field with the specified index.
7372   // See FieldIndex for the list of date fields.
7373   static Object* GetField(Object* date, Smi* index);
7374
7375   void SetValue(Object* value, bool is_value_nan);
7376
7377
7378   // Dispatched behavior.
7379   DECLARE_PRINTER(JSDate)
7380   DECLARE_VERIFIER(JSDate)
7381
7382   // The order is important. It must be kept in sync with date macros
7383   // in macros.py.
7384   enum FieldIndex {
7385     kDateValue,
7386     kYear,
7387     kMonth,
7388     kDay,
7389     kWeekday,
7390     kHour,
7391     kMinute,
7392     kSecond,
7393     kFirstUncachedField,
7394     kMillisecond = kFirstUncachedField,
7395     kDays,
7396     kTimeInDay,
7397     kFirstUTCField,
7398     kYearUTC = kFirstUTCField,
7399     kMonthUTC,
7400     kDayUTC,
7401     kWeekdayUTC,
7402     kHourUTC,
7403     kMinuteUTC,
7404     kSecondUTC,
7405     kMillisecondUTC,
7406     kDaysUTC,
7407     kTimeInDayUTC,
7408     kTimezoneOffset
7409   };
7410
7411   // Layout description.
7412   static const int kValueOffset = JSObject::kHeaderSize;
7413   static const int kYearOffset = kValueOffset + kPointerSize;
7414   static const int kMonthOffset = kYearOffset + kPointerSize;
7415   static const int kDayOffset = kMonthOffset + kPointerSize;
7416   static const int kWeekdayOffset = kDayOffset + kPointerSize;
7417   static const int kHourOffset = kWeekdayOffset  + kPointerSize;
7418   static const int kMinOffset = kHourOffset + kPointerSize;
7419   static const int kSecOffset = kMinOffset + kPointerSize;
7420   static const int kCacheStampOffset = kSecOffset + kPointerSize;
7421   static const int kSize = kCacheStampOffset + kPointerSize;
7422
7423  private:
7424   inline Object* DoGetField(FieldIndex index);
7425
7426   Object* GetUTCField(FieldIndex index, double value, DateCache* date_cache);
7427
7428   // Computes and caches the cacheable fields of the date.
7429   inline void SetCachedFields(int64_t local_time_ms, DateCache* date_cache);
7430
7431
7432   DISALLOW_IMPLICIT_CONSTRUCTORS(JSDate);
7433 };
7434
7435
7436 // Representation of message objects used for error reporting through
7437 // the API. The messages are formatted in JavaScript so this object is
7438 // a real JavaScript object. The information used for formatting the
7439 // error messages are not directly accessible from JavaScript to
7440 // prevent leaking information to user code called during error
7441 // formatting.
7442 class JSMessageObject: public JSObject {
7443  public:
7444   // [type]: the type of error message.
7445   inline int type() const;
7446   inline void set_type(int value);
7447
7448   // [arguments]: the arguments for formatting the error message.
7449   DECL_ACCESSORS(argument, Object)
7450
7451   // [script]: the script from which the error message originated.
7452   DECL_ACCESSORS(script, Object)
7453
7454   // [stack_frames]: an array of stack frames for this error object.
7455   DECL_ACCESSORS(stack_frames, Object)
7456
7457   // [start_position]: the start position in the script for the error message.
7458   inline int start_position() const;
7459   inline void set_start_position(int value);
7460
7461   // [end_position]: the end position in the script for the error message.
7462   inline int end_position() const;
7463   inline void set_end_position(int value);
7464
7465   DECLARE_CAST(JSMessageObject)
7466
7467   // Dispatched behavior.
7468   DECLARE_PRINTER(JSMessageObject)
7469   DECLARE_VERIFIER(JSMessageObject)
7470
7471   // Layout description.
7472   static const int kTypeOffset = JSObject::kHeaderSize;
7473   static const int kArgumentsOffset = kTypeOffset + kPointerSize;
7474   static const int kScriptOffset = kArgumentsOffset + kPointerSize;
7475   static const int kStackFramesOffset = kScriptOffset + kPointerSize;
7476   static const int kStartPositionOffset = kStackFramesOffset + kPointerSize;
7477   static const int kEndPositionOffset = kStartPositionOffset + kPointerSize;
7478   static const int kSize = kEndPositionOffset + kPointerSize;
7479
7480   typedef FixedBodyDescriptor<HeapObject::kMapOffset,
7481                               kStackFramesOffset + kPointerSize,
7482                               kSize> BodyDescriptor;
7483 };
7484
7485
7486 // Regular expressions
7487 // The regular expression holds a single reference to a FixedArray in
7488 // the kDataOffset field.
7489 // The FixedArray contains the following data:
7490 // - tag : type of regexp implementation (not compiled yet, atom or irregexp)
7491 // - reference to the original source string
7492 // - reference to the original flag string
7493 // If it is an atom regexp
7494 // - a reference to a literal string to search for
7495 // If it is an irregexp regexp:
7496 // - a reference to code for Latin1 inputs (bytecode or compiled), or a smi
7497 // used for tracking the last usage (used for code flushing).
7498 // - a reference to code for UC16 inputs (bytecode or compiled), or a smi
7499 // used for tracking the last usage (used for code flushing)..
7500 // - max number of registers used by irregexp implementations.
7501 // - number of capture registers (output values) of the regexp.
7502 class JSRegExp: public JSObject {
7503  public:
7504   // Meaning of Type:
7505   // NOT_COMPILED: Initial value. No data has been stored in the JSRegExp yet.
7506   // ATOM: A simple string to match against using an indexOf operation.
7507   // IRREGEXP: Compiled with Irregexp.
7508   // IRREGEXP_NATIVE: Compiled to native code with Irregexp.
7509   enum Type { NOT_COMPILED, ATOM, IRREGEXP };
7510   enum Flag {
7511     NONE = 0,
7512     GLOBAL = 1,
7513     IGNORE_CASE = 2,
7514     MULTILINE = 4,
7515     STICKY = 8,
7516     UNICODE_ESCAPES = 16
7517   };
7518
7519   class Flags {
7520    public:
7521     explicit Flags(uint32_t value) : value_(value) { }
7522     bool is_global() { return (value_ & GLOBAL) != 0; }
7523     bool is_ignore_case() { return (value_ & IGNORE_CASE) != 0; }
7524     bool is_multiline() { return (value_ & MULTILINE) != 0; }
7525     bool is_sticky() { return (value_ & STICKY) != 0; }
7526     bool is_unicode() { return (value_ & UNICODE_ESCAPES) != 0; }
7527     uint32_t value() { return value_; }
7528    private:
7529     uint32_t value_;
7530   };
7531
7532   DECL_ACCESSORS(data, Object)
7533
7534   inline Type TypeTag();
7535   inline int CaptureCount();
7536   inline Flags GetFlags();
7537   inline String* Pattern();
7538   inline Object* DataAt(int index);
7539   // Set implementation data after the object has been prepared.
7540   inline void SetDataAt(int index, Object* value);
7541
7542   static int code_index(bool is_latin1) {
7543     if (is_latin1) {
7544       return kIrregexpLatin1CodeIndex;
7545     } else {
7546       return kIrregexpUC16CodeIndex;
7547     }
7548   }
7549
7550   static int saved_code_index(bool is_latin1) {
7551     if (is_latin1) {
7552       return kIrregexpLatin1CodeSavedIndex;
7553     } else {
7554       return kIrregexpUC16CodeSavedIndex;
7555     }
7556   }
7557
7558   DECLARE_CAST(JSRegExp)
7559
7560   // Dispatched behavior.
7561   DECLARE_VERIFIER(JSRegExp)
7562
7563   static const int kDataOffset = JSObject::kHeaderSize;
7564   static const int kSize = kDataOffset + kPointerSize;
7565
7566   // Indices in the data array.
7567   static const int kTagIndex = 0;
7568   static const int kSourceIndex = kTagIndex + 1;
7569   static const int kFlagsIndex = kSourceIndex + 1;
7570   static const int kDataIndex = kFlagsIndex + 1;
7571   // The data fields are used in different ways depending on the
7572   // value of the tag.
7573   // Atom regexps (literal strings).
7574   static const int kAtomPatternIndex = kDataIndex;
7575
7576   static const int kAtomDataSize = kAtomPatternIndex + 1;
7577
7578   // Irregexp compiled code or bytecode for Latin1. If compilation
7579   // fails, this fields hold an exception object that should be
7580   // thrown if the regexp is used again.
7581   static const int kIrregexpLatin1CodeIndex = kDataIndex;
7582   // Irregexp compiled code or bytecode for UC16.  If compilation
7583   // fails, this fields hold an exception object that should be
7584   // thrown if the regexp is used again.
7585   static const int kIrregexpUC16CodeIndex = kDataIndex + 1;
7586
7587   // Saved instance of Irregexp compiled code or bytecode for Latin1 that
7588   // is a potential candidate for flushing.
7589   static const int kIrregexpLatin1CodeSavedIndex = kDataIndex + 2;
7590   // Saved instance of Irregexp compiled code or bytecode for UC16 that is
7591   // a potential candidate for flushing.
7592   static const int kIrregexpUC16CodeSavedIndex = kDataIndex + 3;
7593
7594   // Maximal number of registers used by either Latin1 or UC16.
7595   // Only used to check that there is enough stack space
7596   static const int kIrregexpMaxRegisterCountIndex = kDataIndex + 4;
7597   // Number of captures in the compiled regexp.
7598   static const int kIrregexpCaptureCountIndex = kDataIndex + 5;
7599
7600   static const int kIrregexpDataSize = kIrregexpCaptureCountIndex + 1;
7601
7602   // Offsets directly into the data fixed array.
7603   static const int kDataTagOffset =
7604       FixedArray::kHeaderSize + kTagIndex * kPointerSize;
7605   static const int kDataOneByteCodeOffset =
7606       FixedArray::kHeaderSize + kIrregexpLatin1CodeIndex * kPointerSize;
7607   static const int kDataUC16CodeOffset =
7608       FixedArray::kHeaderSize + kIrregexpUC16CodeIndex * kPointerSize;
7609   static const int kIrregexpCaptureCountOffset =
7610       FixedArray::kHeaderSize + kIrregexpCaptureCountIndex * kPointerSize;
7611
7612   // In-object fields.
7613   static const int kSourceFieldIndex = 0;
7614   static const int kGlobalFieldIndex = 1;
7615   static const int kIgnoreCaseFieldIndex = 2;
7616   static const int kMultilineFieldIndex = 3;
7617   static const int kLastIndexFieldIndex = 4;
7618   static const int kInObjectFieldCount = 5;
7619
7620   // The uninitialized value for a regexp code object.
7621   static const int kUninitializedValue = -1;
7622
7623   // The compilation error value for the regexp code object. The real error
7624   // object is in the saved code field.
7625   static const int kCompilationErrorValue = -2;
7626
7627   // When we store the sweep generation at which we moved the code from the
7628   // code index to the saved code index we mask it of to be in the [0:255]
7629   // range.
7630   static const int kCodeAgeMask = 0xff;
7631 };
7632
7633
7634 class CompilationCacheShape : public BaseShape<HashTableKey*> {
7635  public:
7636   static inline bool IsMatch(HashTableKey* key, Object* value) {
7637     return key->IsMatch(value);
7638   }
7639
7640   static inline uint32_t Hash(HashTableKey* key) {
7641     return key->Hash();
7642   }
7643
7644   static inline uint32_t HashForObject(HashTableKey* key, Object* object) {
7645     return key->HashForObject(object);
7646   }
7647
7648   static inline Handle<Object> AsHandle(Isolate* isolate, HashTableKey* key);
7649
7650   static const int kPrefixSize = 0;
7651   static const int kEntrySize = 2;
7652 };
7653
7654
7655 // This cache is used in two different variants. For regexp caching, it simply
7656 // maps identifying info of the regexp to the cached regexp object. Scripts and
7657 // eval code only gets cached after a second probe for the code object. To do
7658 // so, on first "put" only a hash identifying the source is entered into the
7659 // cache, mapping it to a lifetime count of the hash. On each call to Age all
7660 // such lifetimes get reduced, and removed once they reach zero. If a second put
7661 // is called while such a hash is live in the cache, the hash gets replaced by
7662 // an actual cache entry. Age also removes stale live entries from the cache.
7663 // Such entries are identified by SharedFunctionInfos pointing to either the
7664 // recompilation stub, or to "old" code. This avoids memory leaks due to
7665 // premature caching of scripts and eval strings that are never needed later.
7666 class CompilationCacheTable: public HashTable<CompilationCacheTable,
7667                                               CompilationCacheShape,
7668                                               HashTableKey*> {
7669  public:
7670   // Find cached value for a string key, otherwise return null.
7671   Handle<Object> Lookup(
7672       Handle<String> src, Handle<Context> context, LanguageMode language_mode);
7673   Handle<Object> LookupEval(
7674       Handle<String> src, Handle<SharedFunctionInfo> shared,
7675       LanguageMode language_mode, int scope_position);
7676   Handle<Object> LookupRegExp(Handle<String> source, JSRegExp::Flags flags);
7677   static Handle<CompilationCacheTable> Put(
7678       Handle<CompilationCacheTable> cache, Handle<String> src,
7679       Handle<Context> context, LanguageMode language_mode,
7680       Handle<Object> value);
7681   static Handle<CompilationCacheTable> PutEval(
7682       Handle<CompilationCacheTable> cache, Handle<String> src,
7683       Handle<SharedFunctionInfo> context, Handle<SharedFunctionInfo> value,
7684       int scope_position);
7685   static Handle<CompilationCacheTable> PutRegExp(
7686       Handle<CompilationCacheTable> cache, Handle<String> src,
7687       JSRegExp::Flags flags, Handle<FixedArray> value);
7688   void Remove(Object* value);
7689   void Age();
7690   static const int kHashGenerations = 10;
7691
7692   DECLARE_CAST(CompilationCacheTable)
7693
7694  private:
7695   DISALLOW_IMPLICIT_CONSTRUCTORS(CompilationCacheTable);
7696 };
7697
7698
7699 class CodeCache: public Struct {
7700  public:
7701   DECL_ACCESSORS(default_cache, FixedArray)
7702   DECL_ACCESSORS(normal_type_cache, Object)
7703
7704   // Add the code object to the cache.
7705   static void Update(
7706       Handle<CodeCache> cache, Handle<Name> name, Handle<Code> code);
7707
7708   // Lookup code object in the cache. Returns code object if found and undefined
7709   // if not.
7710   Object* Lookup(Name* name, Code::Flags flags);
7711
7712   // Get the internal index of a code object in the cache. Returns -1 if the
7713   // code object is not in that cache. This index can be used to later call
7714   // RemoveByIndex. The cache cannot be modified between a call to GetIndex and
7715   // RemoveByIndex.
7716   int GetIndex(Object* name, Code* code);
7717
7718   // Remove an object from the cache with the provided internal index.
7719   void RemoveByIndex(Object* name, Code* code, int index);
7720
7721   DECLARE_CAST(CodeCache)
7722
7723   // Dispatched behavior.
7724   DECLARE_PRINTER(CodeCache)
7725   DECLARE_VERIFIER(CodeCache)
7726
7727   static const int kDefaultCacheOffset = HeapObject::kHeaderSize;
7728   static const int kNormalTypeCacheOffset =
7729       kDefaultCacheOffset + kPointerSize;
7730   static const int kSize = kNormalTypeCacheOffset + kPointerSize;
7731
7732  private:
7733   static void UpdateDefaultCache(
7734       Handle<CodeCache> code_cache, Handle<Name> name, Handle<Code> code);
7735   static void UpdateNormalTypeCache(
7736       Handle<CodeCache> code_cache, Handle<Name> name, Handle<Code> code);
7737   Object* LookupDefaultCache(Name* name, Code::Flags flags);
7738   Object* LookupNormalTypeCache(Name* name, Code::Flags flags);
7739
7740   // Code cache layout of the default cache. Elements are alternating name and
7741   // code objects for non normal load/store/call IC's.
7742   static const int kCodeCacheEntrySize = 2;
7743   static const int kCodeCacheEntryNameOffset = 0;
7744   static const int kCodeCacheEntryCodeOffset = 1;
7745
7746   DISALLOW_IMPLICIT_CONSTRUCTORS(CodeCache);
7747 };
7748
7749
7750 class CodeCacheHashTableShape : public BaseShape<HashTableKey*> {
7751  public:
7752   static inline bool IsMatch(HashTableKey* key, Object* value) {
7753     return key->IsMatch(value);
7754   }
7755
7756   static inline uint32_t Hash(HashTableKey* key) {
7757     return key->Hash();
7758   }
7759
7760   static inline uint32_t HashForObject(HashTableKey* key, Object* object) {
7761     return key->HashForObject(object);
7762   }
7763
7764   static inline Handle<Object> AsHandle(Isolate* isolate, HashTableKey* key);
7765
7766   static const int kPrefixSize = 0;
7767   static const int kEntrySize = 2;
7768 };
7769
7770
7771 class CodeCacheHashTable: public HashTable<CodeCacheHashTable,
7772                                            CodeCacheHashTableShape,
7773                                            HashTableKey*> {
7774  public:
7775   Object* Lookup(Name* name, Code::Flags flags);
7776   static Handle<CodeCacheHashTable> Put(
7777       Handle<CodeCacheHashTable> table,
7778       Handle<Name> name,
7779       Handle<Code> code);
7780
7781   int GetIndex(Name* name, Code::Flags flags);
7782   void RemoveByIndex(int index);
7783
7784   DECLARE_CAST(CodeCacheHashTable)
7785
7786   // Initial size of the fixed array backing the hash table.
7787   static const int kInitialSize = 64;
7788
7789  private:
7790   DISALLOW_IMPLICIT_CONSTRUCTORS(CodeCacheHashTable);
7791 };
7792
7793
7794 class PolymorphicCodeCache: public Struct {
7795  public:
7796   DECL_ACCESSORS(cache, Object)
7797
7798   static void Update(Handle<PolymorphicCodeCache> cache,
7799                      MapHandleList* maps,
7800                      Code::Flags flags,
7801                      Handle<Code> code);
7802
7803
7804   // Returns an undefined value if the entry is not found.
7805   Handle<Object> Lookup(MapHandleList* maps, Code::Flags flags);
7806
7807   DECLARE_CAST(PolymorphicCodeCache)
7808
7809   // Dispatched behavior.
7810   DECLARE_PRINTER(PolymorphicCodeCache)
7811   DECLARE_VERIFIER(PolymorphicCodeCache)
7812
7813   static const int kCacheOffset = HeapObject::kHeaderSize;
7814   static const int kSize = kCacheOffset + kPointerSize;
7815
7816  private:
7817   DISALLOW_IMPLICIT_CONSTRUCTORS(PolymorphicCodeCache);
7818 };
7819
7820
7821 class PolymorphicCodeCacheHashTable
7822     : public HashTable<PolymorphicCodeCacheHashTable,
7823                        CodeCacheHashTableShape,
7824                        HashTableKey*> {
7825  public:
7826   Object* Lookup(MapHandleList* maps, int code_kind);
7827
7828   static Handle<PolymorphicCodeCacheHashTable> Put(
7829       Handle<PolymorphicCodeCacheHashTable> hash_table,
7830       MapHandleList* maps,
7831       int code_kind,
7832       Handle<Code> code);
7833
7834   DECLARE_CAST(PolymorphicCodeCacheHashTable)
7835
7836   static const int kInitialSize = 64;
7837  private:
7838   DISALLOW_IMPLICIT_CONSTRUCTORS(PolymorphicCodeCacheHashTable);
7839 };
7840
7841
7842 class TypeFeedbackInfo: public Struct {
7843  public:
7844   inline int ic_total_count();
7845   inline void set_ic_total_count(int count);
7846
7847   inline int ic_with_type_info_count();
7848   inline void change_ic_with_type_info_count(int delta);
7849
7850   inline int ic_generic_count();
7851   inline void change_ic_generic_count(int delta);
7852
7853   inline void initialize_storage();
7854
7855   inline void change_own_type_change_checksum();
7856   inline int own_type_change_checksum();
7857
7858   inline void set_inlined_type_change_checksum(int checksum);
7859   inline bool matches_inlined_type_change_checksum(int checksum);
7860
7861   DECLARE_CAST(TypeFeedbackInfo)
7862
7863   // Dispatched behavior.
7864   DECLARE_PRINTER(TypeFeedbackInfo)
7865   DECLARE_VERIFIER(TypeFeedbackInfo)
7866
7867   static const int kStorage1Offset = HeapObject::kHeaderSize;
7868   static const int kStorage2Offset = kStorage1Offset + kPointerSize;
7869   static const int kStorage3Offset = kStorage2Offset + kPointerSize;
7870   static const int kSize = kStorage3Offset + kPointerSize;
7871
7872  private:
7873   static const int kTypeChangeChecksumBits = 7;
7874
7875   class ICTotalCountField: public BitField<int, 0,
7876       kSmiValueSize - kTypeChangeChecksumBits> {};  // NOLINT
7877   class OwnTypeChangeChecksum: public BitField<int,
7878       kSmiValueSize - kTypeChangeChecksumBits,
7879       kTypeChangeChecksumBits> {};  // NOLINT
7880   class ICsWithTypeInfoCountField: public BitField<int, 0,
7881       kSmiValueSize - kTypeChangeChecksumBits> {};  // NOLINT
7882   class InlinedTypeChangeChecksum: public BitField<int,
7883       kSmiValueSize - kTypeChangeChecksumBits,
7884       kTypeChangeChecksumBits> {};  // NOLINT
7885
7886   DISALLOW_IMPLICIT_CONSTRUCTORS(TypeFeedbackInfo);
7887 };
7888
7889
7890 enum AllocationSiteMode {
7891   DONT_TRACK_ALLOCATION_SITE,
7892   TRACK_ALLOCATION_SITE,
7893   LAST_ALLOCATION_SITE_MODE = TRACK_ALLOCATION_SITE
7894 };
7895
7896
7897 class AllocationSite: public Struct {
7898  public:
7899   static const uint32_t kMaximumArrayBytesToPretransition = 8 * 1024;
7900   static const double kPretenureRatio;
7901   static const int kPretenureMinimumCreated = 100;
7902
7903   // Values for pretenure decision field.
7904   enum PretenureDecision {
7905     kUndecided = 0,
7906     kDontTenure = 1,
7907     kMaybeTenure = 2,
7908     kTenure = 3,
7909     kZombie = 4,
7910     kLastPretenureDecisionValue = kZombie
7911   };
7912
7913   const char* PretenureDecisionName(PretenureDecision decision);
7914
7915   DECL_ACCESSORS(transition_info, Object)
7916   // nested_site threads a list of sites that represent nested literals
7917   // walked in a particular order. So [[1, 2], 1, 2] will have one
7918   // nested_site, but [[1, 2], 3, [4]] will have a list of two.
7919   DECL_ACCESSORS(nested_site, Object)
7920   DECL_ACCESSORS(pretenure_data, Smi)
7921   DECL_ACCESSORS(pretenure_create_count, Smi)
7922   DECL_ACCESSORS(dependent_code, DependentCode)
7923   DECL_ACCESSORS(weak_next, Object)
7924
7925   inline void Initialize();
7926
7927   // This method is expensive, it should only be called for reporting.
7928   bool IsNestedSite();
7929
7930   // transition_info bitfields, for constructed array transition info.
7931   class ElementsKindBits:       public BitField<ElementsKind, 0,  15> {};
7932   class UnusedBits:             public BitField<int,          15, 14> {};
7933   class DoNotInlineBit:         public BitField<bool,         29,  1> {};
7934
7935   // Bitfields for pretenure_data
7936   class MementoFoundCountBits:  public BitField<int,               0, 26> {};
7937   class PretenureDecisionBits:  public BitField<PretenureDecision, 26, 3> {};
7938   class DeoptDependentCodeBit:  public BitField<bool,              29, 1> {};
7939   STATIC_ASSERT(PretenureDecisionBits::kMax >= kLastPretenureDecisionValue);
7940
7941   // Increments the mementos found counter and returns true when the first
7942   // memento was found for a given allocation site.
7943   inline bool IncrementMementoFoundCount();
7944
7945   inline void IncrementMementoCreateCount();
7946
7947   PretenureFlag GetPretenureMode();
7948
7949   void ResetPretenureDecision();
7950
7951   PretenureDecision pretenure_decision() {
7952     int value = pretenure_data()->value();
7953     return PretenureDecisionBits::decode(value);
7954   }
7955
7956   void set_pretenure_decision(PretenureDecision decision) {
7957     int value = pretenure_data()->value();
7958     set_pretenure_data(
7959         Smi::FromInt(PretenureDecisionBits::update(value, decision)),
7960         SKIP_WRITE_BARRIER);
7961   }
7962
7963   bool deopt_dependent_code() {
7964     int value = pretenure_data()->value();
7965     return DeoptDependentCodeBit::decode(value);
7966   }
7967
7968   void set_deopt_dependent_code(bool deopt) {
7969     int value = pretenure_data()->value();
7970     set_pretenure_data(
7971         Smi::FromInt(DeoptDependentCodeBit::update(value, deopt)),
7972         SKIP_WRITE_BARRIER);
7973   }
7974
7975   int memento_found_count() {
7976     int value = pretenure_data()->value();
7977     return MementoFoundCountBits::decode(value);
7978   }
7979
7980   inline void set_memento_found_count(int count);
7981
7982   int memento_create_count() {
7983     return pretenure_create_count()->value();
7984   }
7985
7986   void set_memento_create_count(int count) {
7987     set_pretenure_create_count(Smi::FromInt(count), SKIP_WRITE_BARRIER);
7988   }
7989
7990   // The pretenuring decision is made during gc, and the zombie state allows
7991   // us to recognize when an allocation site is just being kept alive because
7992   // a later traversal of new space may discover AllocationMementos that point
7993   // to this AllocationSite.
7994   bool IsZombie() {
7995     return pretenure_decision() == kZombie;
7996   }
7997
7998   bool IsMaybeTenure() {
7999     return pretenure_decision() == kMaybeTenure;
8000   }
8001
8002   inline void MarkZombie();
8003
8004   inline bool MakePretenureDecision(PretenureDecision current_decision,
8005                                     double ratio,
8006                                     bool maximum_size_scavenge);
8007
8008   inline bool DigestPretenuringFeedback(bool maximum_size_scavenge);
8009
8010   ElementsKind GetElementsKind() {
8011     DCHECK(!SitePointsToLiteral());
8012     int value = Smi::cast(transition_info())->value();
8013     return ElementsKindBits::decode(value);
8014   }
8015
8016   void SetElementsKind(ElementsKind kind) {
8017     int value = Smi::cast(transition_info())->value();
8018     set_transition_info(Smi::FromInt(ElementsKindBits::update(value, kind)),
8019                         SKIP_WRITE_BARRIER);
8020   }
8021
8022   bool CanInlineCall() {
8023     int value = Smi::cast(transition_info())->value();
8024     return DoNotInlineBit::decode(value) == 0;
8025   }
8026
8027   void SetDoNotInlineCall() {
8028     int value = Smi::cast(transition_info())->value();
8029     set_transition_info(Smi::FromInt(DoNotInlineBit::update(value, true)),
8030                         SKIP_WRITE_BARRIER);
8031   }
8032
8033   bool SitePointsToLiteral() {
8034     // If transition_info is a smi, then it represents an ElementsKind
8035     // for a constructed array. Otherwise, it must be a boilerplate
8036     // for an object or array literal.
8037     return transition_info()->IsJSArray() || transition_info()->IsJSObject();
8038   }
8039
8040   static void DigestTransitionFeedback(Handle<AllocationSite> site,
8041                                        ElementsKind to_kind);
8042
8043   DECLARE_PRINTER(AllocationSite)
8044   DECLARE_VERIFIER(AllocationSite)
8045
8046   DECLARE_CAST(AllocationSite)
8047   static inline AllocationSiteMode GetMode(
8048       ElementsKind boilerplate_elements_kind);
8049   static inline AllocationSiteMode GetMode(ElementsKind from, ElementsKind to);
8050   static inline bool CanTrack(InstanceType type);
8051
8052   static const int kTransitionInfoOffset = HeapObject::kHeaderSize;
8053   static const int kNestedSiteOffset = kTransitionInfoOffset + kPointerSize;
8054   static const int kPretenureDataOffset = kNestedSiteOffset + kPointerSize;
8055   static const int kPretenureCreateCountOffset =
8056       kPretenureDataOffset + kPointerSize;
8057   static const int kDependentCodeOffset =
8058       kPretenureCreateCountOffset + kPointerSize;
8059   static const int kWeakNextOffset = kDependentCodeOffset + kPointerSize;
8060   static const int kSize = kWeakNextOffset + kPointerSize;
8061
8062   // During mark compact we need to take special care for the dependent code
8063   // field.
8064   static const int kPointerFieldsBeginOffset = kTransitionInfoOffset;
8065   static const int kPointerFieldsEndOffset = kWeakNextOffset;
8066
8067   // For other visitors, use the fixed body descriptor below.
8068   typedef FixedBodyDescriptor<HeapObject::kHeaderSize,
8069                               kDependentCodeOffset + kPointerSize,
8070                               kSize> BodyDescriptor;
8071
8072  private:
8073   bool PretenuringDecisionMade() {
8074     return pretenure_decision() != kUndecided;
8075   }
8076
8077   DISALLOW_IMPLICIT_CONSTRUCTORS(AllocationSite);
8078 };
8079
8080
8081 class AllocationMemento: public Struct {
8082  public:
8083   static const int kAllocationSiteOffset = HeapObject::kHeaderSize;
8084   static const int kSize = kAllocationSiteOffset + kPointerSize;
8085
8086   DECL_ACCESSORS(allocation_site, Object)
8087
8088   bool IsValid() {
8089     return allocation_site()->IsAllocationSite() &&
8090         !AllocationSite::cast(allocation_site())->IsZombie();
8091   }
8092   AllocationSite* GetAllocationSite() {
8093     DCHECK(IsValid());
8094     return AllocationSite::cast(allocation_site());
8095   }
8096
8097   DECLARE_PRINTER(AllocationMemento)
8098   DECLARE_VERIFIER(AllocationMemento)
8099
8100   DECLARE_CAST(AllocationMemento)
8101
8102  private:
8103   DISALLOW_IMPLICIT_CONSTRUCTORS(AllocationMemento);
8104 };
8105
8106
8107 // Representation of a slow alias as part of a sloppy arguments objects.
8108 // For fast aliases (if HasSloppyArgumentsElements()):
8109 // - the parameter map contains an index into the context
8110 // - all attributes of the element have default values
8111 // For slow aliases (if HasDictionaryArgumentsElements()):
8112 // - the parameter map contains no fast alias mapping (i.e. the hole)
8113 // - this struct (in the slow backing store) contains an index into the context
8114 // - all attributes are available as part if the property details
8115 class AliasedArgumentsEntry: public Struct {
8116  public:
8117   inline int aliased_context_slot() const;
8118   inline void set_aliased_context_slot(int count);
8119
8120   DECLARE_CAST(AliasedArgumentsEntry)
8121
8122   // Dispatched behavior.
8123   DECLARE_PRINTER(AliasedArgumentsEntry)
8124   DECLARE_VERIFIER(AliasedArgumentsEntry)
8125
8126   static const int kAliasedContextSlot = HeapObject::kHeaderSize;
8127   static const int kSize = kAliasedContextSlot + kPointerSize;
8128
8129  private:
8130   DISALLOW_IMPLICIT_CONSTRUCTORS(AliasedArgumentsEntry);
8131 };
8132
8133
8134 enum AllowNullsFlag {ALLOW_NULLS, DISALLOW_NULLS};
8135 enum RobustnessFlag {ROBUST_STRING_TRAVERSAL, FAST_STRING_TRAVERSAL};
8136
8137
8138 class StringHasher {
8139  public:
8140   explicit inline StringHasher(int length, uint32_t seed);
8141
8142   template <typename schar>
8143   static inline uint32_t HashSequentialString(const schar* chars,
8144                                               int length,
8145                                               uint32_t seed);
8146
8147   // Reads all the data, even for long strings and computes the utf16 length.
8148   static uint32_t ComputeUtf8Hash(Vector<const char> chars,
8149                                   uint32_t seed,
8150                                   int* utf16_length_out);
8151
8152   // Calculated hash value for a string consisting of 1 to
8153   // String::kMaxArrayIndexSize digits with no leading zeros (except "0").
8154   // value is represented decimal value.
8155   static uint32_t MakeArrayIndexHash(uint32_t value, int length);
8156
8157   // No string is allowed to have a hash of zero.  That value is reserved
8158   // for internal properties.  If the hash calculation yields zero then we
8159   // use 27 instead.
8160   static const int kZeroHash = 27;
8161
8162   // Reusable parts of the hashing algorithm.
8163   INLINE(static uint32_t AddCharacterCore(uint32_t running_hash, uint16_t c));
8164   INLINE(static uint32_t GetHashCore(uint32_t running_hash));
8165   INLINE(static uint32_t ComputeRunningHash(uint32_t running_hash,
8166                                             const uc16* chars, int length));
8167   INLINE(static uint32_t ComputeRunningHashOneByte(uint32_t running_hash,
8168                                                    const char* chars,
8169                                                    int length));
8170
8171  protected:
8172   // Returns the value to store in the hash field of a string with
8173   // the given length and contents.
8174   uint32_t GetHashField();
8175   // Returns true if the hash of this string can be computed without
8176   // looking at the contents.
8177   inline bool has_trivial_hash();
8178   // Adds a block of characters to the hash.
8179   template<typename Char>
8180   inline void AddCharacters(const Char* chars, int len);
8181
8182  private:
8183   // Add a character to the hash.
8184   inline void AddCharacter(uint16_t c);
8185   // Update index. Returns true if string is still an index.
8186   inline bool UpdateIndex(uint16_t c);
8187
8188   int length_;
8189   uint32_t raw_running_hash_;
8190   uint32_t array_index_;
8191   bool is_array_index_;
8192   bool is_first_char_;
8193   DISALLOW_COPY_AND_ASSIGN(StringHasher);
8194 };
8195
8196
8197 class IteratingStringHasher : public StringHasher {
8198  public:
8199   static inline uint32_t Hash(String* string, uint32_t seed);
8200   inline void VisitOneByteString(const uint8_t* chars, int length);
8201   inline void VisitTwoByteString(const uint16_t* chars, int length);
8202
8203  private:
8204   inline IteratingStringHasher(int len, uint32_t seed)
8205       : StringHasher(len, seed) {}
8206   void VisitConsString(ConsString* cons_string);
8207   DISALLOW_COPY_AND_ASSIGN(IteratingStringHasher);
8208 };
8209
8210
8211 // The characteristics of a string are stored in its map.  Retrieving these
8212 // few bits of information is moderately expensive, involving two memory
8213 // loads where the second is dependent on the first.  To improve efficiency
8214 // the shape of the string is given its own class so that it can be retrieved
8215 // once and used for several string operations.  A StringShape is small enough
8216 // to be passed by value and is immutable, but be aware that flattening a
8217 // string can potentially alter its shape.  Also be aware that a GC caused by
8218 // something else can alter the shape of a string due to ConsString
8219 // shortcutting.  Keeping these restrictions in mind has proven to be error-
8220 // prone and so we no longer put StringShapes in variables unless there is a
8221 // concrete performance benefit at that particular point in the code.
8222 class StringShape BASE_EMBEDDED {
8223  public:
8224   inline explicit StringShape(const String* s);
8225   inline explicit StringShape(Map* s);
8226   inline explicit StringShape(InstanceType t);
8227   inline bool IsSequential();
8228   inline bool IsExternal();
8229   inline bool IsCons();
8230   inline bool IsSliced();
8231   inline bool IsIndirect();
8232   inline bool IsExternalOneByte();
8233   inline bool IsExternalTwoByte();
8234   inline bool IsSequentialOneByte();
8235   inline bool IsSequentialTwoByte();
8236   inline bool IsInternalized();
8237   inline StringRepresentationTag representation_tag();
8238   inline uint32_t encoding_tag();
8239   inline uint32_t full_representation_tag();
8240   inline uint32_t size_tag();
8241 #ifdef DEBUG
8242   inline uint32_t type() { return type_; }
8243   inline void invalidate() { valid_ = false; }
8244   inline bool valid() { return valid_; }
8245 #else
8246   inline void invalidate() { }
8247 #endif
8248
8249  private:
8250   uint32_t type_;
8251 #ifdef DEBUG
8252   inline void set_valid() { valid_ = true; }
8253   bool valid_;
8254 #else
8255   inline void set_valid() { }
8256 #endif
8257 };
8258
8259
8260 // The Name abstract class captures anything that can be used as a property
8261 // name, i.e., strings and symbols.  All names store a hash value.
8262 class Name: public HeapObject {
8263  public:
8264   // Get and set the hash field of the name.
8265   inline uint32_t hash_field();
8266   inline void set_hash_field(uint32_t value);
8267
8268   // Tells whether the hash code has been computed.
8269   inline bool HasHashCode();
8270
8271   // Returns a hash value used for the property table
8272   inline uint32_t Hash();
8273
8274   // Equality operations.
8275   inline bool Equals(Name* other);
8276   inline static bool Equals(Handle<Name> one, Handle<Name> two);
8277
8278   // Conversion.
8279   inline bool AsArrayIndex(uint32_t* index);
8280
8281   // If the name is private, it can only name own properties.
8282   inline bool IsPrivate();
8283
8284   // If the name is a non-flat string, this method returns a flat version of the
8285   // string. Otherwise it'll just return the input.
8286   static inline Handle<Name> Flatten(Handle<Name> name,
8287                                      PretenureFlag pretenure = NOT_TENURED);
8288
8289   DECLARE_CAST(Name)
8290
8291   DECLARE_PRINTER(Name)
8292 #if TRACE_MAPS
8293   void NameShortPrint();
8294   int NameShortPrint(Vector<char> str);
8295 #endif
8296
8297   // Layout description.
8298   static const int kHashFieldSlot = HeapObject::kHeaderSize;
8299 #if V8_TARGET_LITTLE_ENDIAN || !V8_HOST_ARCH_64_BIT
8300   static const int kHashFieldOffset = kHashFieldSlot;
8301 #else
8302   static const int kHashFieldOffset = kHashFieldSlot + kIntSize;
8303 #endif
8304   static const int kSize = kHashFieldSlot + kPointerSize;
8305
8306   // Mask constant for checking if a name has a computed hash code
8307   // and if it is a string that is an array index.  The least significant bit
8308   // indicates whether a hash code has been computed.  If the hash code has
8309   // been computed the 2nd bit tells whether the string can be used as an
8310   // array index.
8311   static const int kHashNotComputedMask = 1;
8312   static const int kIsNotArrayIndexMask = 1 << 1;
8313   static const int kNofHashBitFields = 2;
8314
8315   // Shift constant retrieving hash code from hash field.
8316   static const int kHashShift = kNofHashBitFields;
8317
8318   // Only these bits are relevant in the hash, since the top two are shifted
8319   // out.
8320   static const uint32_t kHashBitMask = 0xffffffffu >> kHashShift;
8321
8322   // Array index strings this short can keep their index in the hash field.
8323   static const int kMaxCachedArrayIndexLength = 7;
8324
8325   // For strings which are array indexes the hash value has the string length
8326   // mixed into the hash, mainly to avoid a hash value of zero which would be
8327   // the case for the string '0'. 24 bits are used for the array index value.
8328   static const int kArrayIndexValueBits = 24;
8329   static const int kArrayIndexLengthBits =
8330       kBitsPerInt - kArrayIndexValueBits - kNofHashBitFields;
8331
8332   STATIC_ASSERT((kArrayIndexLengthBits > 0));
8333
8334   class ArrayIndexValueBits : public BitField<unsigned int, kNofHashBitFields,
8335       kArrayIndexValueBits> {};  // NOLINT
8336   class ArrayIndexLengthBits : public BitField<unsigned int,
8337       kNofHashBitFields + kArrayIndexValueBits,
8338       kArrayIndexLengthBits> {};  // NOLINT
8339
8340   // Check that kMaxCachedArrayIndexLength + 1 is a power of two so we
8341   // could use a mask to test if the length of string is less than or equal to
8342   // kMaxCachedArrayIndexLength.
8343   STATIC_ASSERT(IS_POWER_OF_TWO(kMaxCachedArrayIndexLength + 1));
8344
8345   static const unsigned int kContainsCachedArrayIndexMask =
8346       (~static_cast<unsigned>(kMaxCachedArrayIndexLength)
8347        << ArrayIndexLengthBits::kShift) |
8348       kIsNotArrayIndexMask;
8349
8350   // Value of empty hash field indicating that the hash is not computed.
8351   static const int kEmptyHashField =
8352       kIsNotArrayIndexMask | kHashNotComputedMask;
8353
8354  protected:
8355   static inline bool IsHashFieldComputed(uint32_t field);
8356
8357  private:
8358   DISALLOW_IMPLICIT_CONSTRUCTORS(Name);
8359 };
8360
8361
8362 // ES6 symbols.
8363 class Symbol: public Name {
8364  public:
8365   // [name]: The print name of a symbol, or undefined if none.
8366   DECL_ACCESSORS(name, Object)
8367
8368   DECL_ACCESSORS(flags, Smi)
8369
8370   // [is_private]: Whether this is a private symbol.  Private symbols can only
8371   // be used to designate own properties of objects.
8372   DECL_BOOLEAN_ACCESSORS(is_private)
8373
8374   DECLARE_CAST(Symbol)
8375
8376   // Dispatched behavior.
8377   DECLARE_PRINTER(Symbol)
8378   DECLARE_VERIFIER(Symbol)
8379
8380   // Layout description.
8381   static const int kNameOffset = Name::kSize;
8382   static const int kFlagsOffset = kNameOffset + kPointerSize;
8383   static const int kSize = kFlagsOffset + kPointerSize;
8384
8385   typedef FixedBodyDescriptor<kNameOffset, kFlagsOffset, kSize> BodyDescriptor;
8386
8387   void SymbolShortPrint(std::ostream& os);
8388
8389  private:
8390   static const int kPrivateBit = 0;
8391
8392   const char* PrivateSymbolToName() const;
8393
8394 #if TRACE_MAPS
8395   friend class Name;  // For PrivateSymbolToName.
8396 #endif
8397
8398   DISALLOW_IMPLICIT_CONSTRUCTORS(Symbol);
8399 };
8400
8401
8402 class ConsString;
8403
8404 // The String abstract class captures JavaScript string values:
8405 //
8406 // Ecma-262:
8407 //  4.3.16 String Value
8408 //    A string value is a member of the type String and is a finite
8409 //    ordered sequence of zero or more 16-bit unsigned integer values.
8410 //
8411 // All string values have a length field.
8412 class String: public Name {
8413  public:
8414   enum Encoding { ONE_BYTE_ENCODING, TWO_BYTE_ENCODING };
8415
8416   // Array index strings this short can keep their index in the hash field.
8417   static const int kMaxCachedArrayIndexLength = 7;
8418
8419   // For strings which are array indexes the hash value has the string length
8420   // mixed into the hash, mainly to avoid a hash value of zero which would be
8421   // the case for the string '0'. 24 bits are used for the array index value.
8422   static const int kArrayIndexValueBits = 24;
8423   static const int kArrayIndexLengthBits =
8424       kBitsPerInt - kArrayIndexValueBits - kNofHashBitFields;
8425
8426   STATIC_ASSERT((kArrayIndexLengthBits > 0));
8427
8428   class ArrayIndexValueBits : public BitField<unsigned int, kNofHashBitFields,
8429       kArrayIndexValueBits> {};  // NOLINT
8430   class ArrayIndexLengthBits : public BitField<unsigned int,
8431       kNofHashBitFields + kArrayIndexValueBits,
8432       kArrayIndexLengthBits> {};  // NOLINT
8433
8434   // Check that kMaxCachedArrayIndexLength + 1 is a power of two so we
8435   // could use a mask to test if the length of string is less than or equal to
8436   // kMaxCachedArrayIndexLength.
8437   STATIC_ASSERT(IS_POWER_OF_TWO(kMaxCachedArrayIndexLength + 1));
8438
8439   static const unsigned int kContainsCachedArrayIndexMask =
8440       (~static_cast<unsigned>(kMaxCachedArrayIndexLength)
8441        << ArrayIndexLengthBits::kShift) |
8442       kIsNotArrayIndexMask;
8443
8444   class SubStringRange {
8445    public:
8446     explicit SubStringRange(String* string, int first = 0, int length = -1)
8447         : string_(string),
8448           first_(first),
8449           length_(length == -1 ? string->length() : length) {}
8450     class iterator;
8451     inline iterator begin();
8452     inline iterator end();
8453
8454    private:
8455     String* string_;
8456     int first_;
8457     int length_;
8458   };
8459
8460   // Representation of the flat content of a String.
8461   // A non-flat string doesn't have flat content.
8462   // A flat string has content that's encoded as a sequence of either
8463   // one-byte chars or two-byte UC16.
8464   // Returned by String::GetFlatContent().
8465   class FlatContent {
8466    public:
8467     // Returns true if the string is flat and this structure contains content.
8468     bool IsFlat() { return state_ != NON_FLAT; }
8469     // Returns true if the structure contains one-byte content.
8470     bool IsOneByte() { return state_ == ONE_BYTE; }
8471     // Returns true if the structure contains two-byte content.
8472     bool IsTwoByte() { return state_ == TWO_BYTE; }
8473
8474     // Return the one byte content of the string. Only use if IsOneByte()
8475     // returns true.
8476     Vector<const uint8_t> ToOneByteVector() {
8477       DCHECK_EQ(ONE_BYTE, state_);
8478       return Vector<const uint8_t>(onebyte_start, length_);
8479     }
8480     // Return the two-byte content of the string. Only use if IsTwoByte()
8481     // returns true.
8482     Vector<const uc16> ToUC16Vector() {
8483       DCHECK_EQ(TWO_BYTE, state_);
8484       return Vector<const uc16>(twobyte_start, length_);
8485     }
8486
8487     uc16 Get(int i) {
8488       DCHECK(i < length_);
8489       DCHECK(state_ != NON_FLAT);
8490       if (state_ == ONE_BYTE) return onebyte_start[i];
8491       return twobyte_start[i];
8492     }
8493
8494     bool UsesSameString(const FlatContent& other) const {
8495       return onebyte_start == other.onebyte_start;
8496     }
8497
8498    private:
8499     enum State { NON_FLAT, ONE_BYTE, TWO_BYTE };
8500
8501     // Constructors only used by String::GetFlatContent().
8502     explicit FlatContent(const uint8_t* start, int length)
8503         : onebyte_start(start), length_(length), state_(ONE_BYTE) {}
8504     explicit FlatContent(const uc16* start, int length)
8505         : twobyte_start(start), length_(length), state_(TWO_BYTE) { }
8506     FlatContent() : onebyte_start(NULL), length_(0), state_(NON_FLAT) { }
8507
8508     union {
8509       const uint8_t* onebyte_start;
8510       const uc16* twobyte_start;
8511     };
8512     int length_;
8513     State state_;
8514
8515     friend class String;
8516     friend class IterableSubString;
8517   };
8518
8519   template <typename Char>
8520   INLINE(Vector<const Char> GetCharVector());
8521
8522   // Get and set the length of the string.
8523   inline int length() const;
8524   inline void set_length(int value);
8525
8526   // Get and set the length of the string using acquire loads and release
8527   // stores.
8528   inline int synchronized_length() const;
8529   inline void synchronized_set_length(int value);
8530
8531   // Returns whether this string has only one-byte chars, i.e. all of them can
8532   // be one-byte encoded.  This might be the case even if the string is
8533   // two-byte.  Such strings may appear when the embedder prefers
8534   // two-byte external representations even for one-byte data.
8535   inline bool IsOneByteRepresentation() const;
8536   inline bool IsTwoByteRepresentation() const;
8537
8538   // Cons and slices have an encoding flag that may not represent the actual
8539   // encoding of the underlying string.  This is taken into account here.
8540   // Requires: this->IsFlat()
8541   inline bool IsOneByteRepresentationUnderneath();
8542   inline bool IsTwoByteRepresentationUnderneath();
8543
8544   // NOTE: this should be considered only a hint.  False negatives are
8545   // possible.
8546   inline bool HasOnlyOneByteChars();
8547
8548   // Get and set individual two byte chars in the string.
8549   inline void Set(int index, uint16_t value);
8550   // Get individual two byte char in the string.  Repeated calls
8551   // to this method are not efficient unless the string is flat.
8552   INLINE(uint16_t Get(int index));
8553
8554   // Flattens the string.  Checks first inline to see if it is
8555   // necessary.  Does nothing if the string is not a cons string.
8556   // Flattening allocates a sequential string with the same data as
8557   // the given string and mutates the cons string to a degenerate
8558   // form, where the first component is the new sequential string and
8559   // the second component is the empty string.  If allocation fails,
8560   // this function returns a failure.  If flattening succeeds, this
8561   // function returns the sequential string that is now the first
8562   // component of the cons string.
8563   //
8564   // Degenerate cons strings are handled specially by the garbage
8565   // collector (see IsShortcutCandidate).
8566
8567   static inline Handle<String> Flatten(Handle<String> string,
8568                                        PretenureFlag pretenure = NOT_TENURED);
8569
8570   // Tries to return the content of a flat string as a structure holding either
8571   // a flat vector of char or of uc16.
8572   // If the string isn't flat, and therefore doesn't have flat content, the
8573   // returned structure will report so, and can't provide a vector of either
8574   // kind.
8575   FlatContent GetFlatContent();
8576
8577   // Returns the parent of a sliced string or first part of a flat cons string.
8578   // Requires: StringShape(this).IsIndirect() && this->IsFlat()
8579   inline String* GetUnderlying();
8580
8581   // String equality operations.
8582   inline bool Equals(String* other);
8583   inline static bool Equals(Handle<String> one, Handle<String> two);
8584   bool IsUtf8EqualTo(Vector<const char> str, bool allow_prefix_match = false);
8585   bool IsOneByteEqualTo(Vector<const uint8_t> str);
8586   bool IsTwoByteEqualTo(Vector<const uc16> str);
8587
8588   // Return a UTF8 representation of the string.  The string is null
8589   // terminated but may optionally contain nulls.  Length is returned
8590   // in length_output if length_output is not a null pointer  The string
8591   // should be nearly flat, otherwise the performance of this method may
8592   // be very slow (quadratic in the length).  Setting robustness_flag to
8593   // ROBUST_STRING_TRAVERSAL invokes behaviour that is robust  This means it
8594   // handles unexpected data without causing assert failures and it does not
8595   // do any heap allocations.  This is useful when printing stack traces.
8596   base::SmartArrayPointer<char> ToCString(AllowNullsFlag allow_nulls,
8597                                           RobustnessFlag robustness_flag,
8598                                           int offset, int length,
8599                                           int* length_output = 0);
8600   base::SmartArrayPointer<char> ToCString(
8601       AllowNullsFlag allow_nulls = DISALLOW_NULLS,
8602       RobustnessFlag robustness_flag = FAST_STRING_TRAVERSAL,
8603       int* length_output = 0);
8604
8605   // Return a 16 bit Unicode representation of the string.
8606   // The string should be nearly flat, otherwise the performance of
8607   // of this method may be very bad.  Setting robustness_flag to
8608   // ROBUST_STRING_TRAVERSAL invokes behaviour that is robust  This means it
8609   // handles unexpected data without causing assert failures and it does not
8610   // do any heap allocations.  This is useful when printing stack traces.
8611   base::SmartArrayPointer<uc16> ToWideCString(
8612       RobustnessFlag robustness_flag = FAST_STRING_TRAVERSAL);
8613
8614   bool ComputeArrayIndex(uint32_t* index);
8615
8616   // Externalization.
8617   bool MakeExternal(v8::String::ExternalStringResource* resource);
8618   bool MakeExternal(v8::String::ExternalOneByteStringResource* resource);
8619
8620   // Conversion.
8621   inline bool AsArrayIndex(uint32_t* index);
8622
8623   DECLARE_CAST(String)
8624
8625   void PrintOn(FILE* out);
8626
8627   // For use during stack traces.  Performs rudimentary sanity check.
8628   bool LooksValid();
8629
8630   // Dispatched behavior.
8631   void StringShortPrint(StringStream* accumulator);
8632   void PrintUC16(std::ostream& os, int start = 0, int end = -1);  // NOLINT
8633 #if defined(DEBUG) || defined(OBJECT_PRINT)
8634   char* ToAsciiArray();
8635 #endif
8636   DECLARE_PRINTER(String)
8637   DECLARE_VERIFIER(String)
8638
8639   inline bool IsFlat();
8640
8641   // Layout description.
8642   static const int kLengthOffset = Name::kSize;
8643   static const int kSize = kLengthOffset + kPointerSize;
8644
8645   // Maximum number of characters to consider when trying to convert a string
8646   // value into an array index.
8647   static const int kMaxArrayIndexSize = 10;
8648   STATIC_ASSERT(kMaxArrayIndexSize < (1 << kArrayIndexLengthBits));
8649
8650   // Max char codes.
8651   static const int32_t kMaxOneByteCharCode = unibrow::Latin1::kMaxChar;
8652   static const uint32_t kMaxOneByteCharCodeU = unibrow::Latin1::kMaxChar;
8653   static const int kMaxUtf16CodeUnit = 0xffff;
8654   static const uint32_t kMaxUtf16CodeUnitU = kMaxUtf16CodeUnit;
8655
8656   // Value of hash field containing computed hash equal to zero.
8657   static const int kEmptyStringHash = kIsNotArrayIndexMask;
8658
8659   // Maximal string length.
8660   static const int kMaxLength = (1 << 28) - 16;
8661
8662   // Max length for computing hash. For strings longer than this limit the
8663   // string length is used as the hash value.
8664   static const int kMaxHashCalcLength = 16383;
8665
8666   // Limit for truncation in short printing.
8667   static const int kMaxShortPrintLength = 1024;
8668
8669   // Support for regular expressions.
8670   const uc16* GetTwoByteData(unsigned start);
8671
8672   // Helper function for flattening strings.
8673   template <typename sinkchar>
8674   static void WriteToFlat(String* source,
8675                           sinkchar* sink,
8676                           int from,
8677                           int to);
8678
8679   // The return value may point to the first aligned word containing the first
8680   // non-one-byte character, rather than directly to the non-one-byte character.
8681   // If the return value is >= the passed length, the entire string was
8682   // one-byte.
8683   static inline int NonAsciiStart(const char* chars, int length) {
8684     const char* start = chars;
8685     const char* limit = chars + length;
8686
8687     if (length >= kIntptrSize) {
8688       // Check unaligned bytes.
8689       while (!IsAligned(reinterpret_cast<intptr_t>(chars), sizeof(uintptr_t))) {
8690         if (static_cast<uint8_t>(*chars) > unibrow::Utf8::kMaxOneByteChar) {
8691           return static_cast<int>(chars - start);
8692         }
8693         ++chars;
8694       }
8695       // Check aligned words.
8696       DCHECK(unibrow::Utf8::kMaxOneByteChar == 0x7F);
8697       const uintptr_t non_one_byte_mask = kUintptrAllBitsSet / 0xFF * 0x80;
8698       while (chars + sizeof(uintptr_t) <= limit) {
8699         if (*reinterpret_cast<const uintptr_t*>(chars) & non_one_byte_mask) {
8700           return static_cast<int>(chars - start);
8701         }
8702         chars += sizeof(uintptr_t);
8703       }
8704     }
8705     // Check remaining unaligned bytes.
8706     while (chars < limit) {
8707       if (static_cast<uint8_t>(*chars) > unibrow::Utf8::kMaxOneByteChar) {
8708         return static_cast<int>(chars - start);
8709       }
8710       ++chars;
8711     }
8712
8713     return static_cast<int>(chars - start);
8714   }
8715
8716   static inline bool IsAscii(const char* chars, int length) {
8717     return NonAsciiStart(chars, length) >= length;
8718   }
8719
8720   static inline bool IsAscii(const uint8_t* chars, int length) {
8721     return
8722         NonAsciiStart(reinterpret_cast<const char*>(chars), length) >= length;
8723   }
8724
8725   static inline int NonOneByteStart(const uc16* chars, int length) {
8726     const uc16* limit = chars + length;
8727     const uc16* start = chars;
8728     while (chars < limit) {
8729       if (*chars > kMaxOneByteCharCodeU) return static_cast<int>(chars - start);
8730       ++chars;
8731     }
8732     return static_cast<int>(chars - start);
8733   }
8734
8735   static inline bool IsOneByte(const uc16* chars, int length) {
8736     return NonOneByteStart(chars, length) >= length;
8737   }
8738
8739   template<class Visitor>
8740   static inline ConsString* VisitFlat(Visitor* visitor,
8741                                       String* string,
8742                                       int offset = 0);
8743
8744   static Handle<FixedArray> CalculateLineEnds(Handle<String> string,
8745                                               bool include_ending_line);
8746
8747   // Use the hash field to forward to the canonical internalized string
8748   // when deserializing an internalized string.
8749   inline void SetForwardedInternalizedString(String* string);
8750   inline String* GetForwardedInternalizedString();
8751
8752  private:
8753   friend class Name;
8754   friend class StringTableInsertionKey;
8755
8756   static Handle<String> SlowFlatten(Handle<ConsString> cons,
8757                                     PretenureFlag tenure);
8758
8759   // Slow case of String::Equals.  This implementation works on any strings
8760   // but it is most efficient on strings that are almost flat.
8761   bool SlowEquals(String* other);
8762
8763   static bool SlowEquals(Handle<String> one, Handle<String> two);
8764
8765   // Slow case of AsArrayIndex.
8766   bool SlowAsArrayIndex(uint32_t* index);
8767
8768   // Compute and set the hash code.
8769   uint32_t ComputeAndSetHash();
8770
8771   DISALLOW_IMPLICIT_CONSTRUCTORS(String);
8772 };
8773
8774
8775 // The SeqString abstract class captures sequential string values.
8776 class SeqString: public String {
8777  public:
8778   DECLARE_CAST(SeqString)
8779
8780   // Layout description.
8781   static const int kHeaderSize = String::kSize;
8782
8783   // Truncate the string in-place if possible and return the result.
8784   // In case of new_length == 0, the empty string is returned without
8785   // truncating the original string.
8786   MUST_USE_RESULT static Handle<String> Truncate(Handle<SeqString> string,
8787                                                  int new_length);
8788  private:
8789   DISALLOW_IMPLICIT_CONSTRUCTORS(SeqString);
8790 };
8791
8792
8793 // The OneByteString class captures sequential one-byte string objects.
8794 // Each character in the OneByteString is an one-byte character.
8795 class SeqOneByteString: public SeqString {
8796  public:
8797   static const bool kHasOneByteEncoding = true;
8798
8799   // Dispatched behavior.
8800   inline uint16_t SeqOneByteStringGet(int index);
8801   inline void SeqOneByteStringSet(int index, uint16_t value);
8802
8803   // Get the address of the characters in this string.
8804   inline Address GetCharsAddress();
8805
8806   inline uint8_t* GetChars();
8807
8808   DECLARE_CAST(SeqOneByteString)
8809
8810   // Garbage collection support.  This method is called by the
8811   // garbage collector to compute the actual size of an OneByteString
8812   // instance.
8813   inline int SeqOneByteStringSize(InstanceType instance_type);
8814
8815   // Computes the size for an OneByteString instance of a given length.
8816   static int SizeFor(int length) {
8817     return OBJECT_POINTER_ALIGN(kHeaderSize + length * kCharSize);
8818   }
8819
8820   // Maximal memory usage for a single sequential one-byte string.
8821   static const int kMaxSize = 512 * MB - 1;
8822   STATIC_ASSERT((kMaxSize - kHeaderSize) >= String::kMaxLength);
8823
8824  private:
8825   DISALLOW_IMPLICIT_CONSTRUCTORS(SeqOneByteString);
8826 };
8827
8828
8829 // The TwoByteString class captures sequential unicode string objects.
8830 // Each character in the TwoByteString is a two-byte uint16_t.
8831 class SeqTwoByteString: public SeqString {
8832  public:
8833   static const bool kHasOneByteEncoding = false;
8834
8835   // Dispatched behavior.
8836   inline uint16_t SeqTwoByteStringGet(int index);
8837   inline void SeqTwoByteStringSet(int index, uint16_t value);
8838
8839   // Get the address of the characters in this string.
8840   inline Address GetCharsAddress();
8841
8842   inline uc16* GetChars();
8843
8844   // For regexp code.
8845   const uint16_t* SeqTwoByteStringGetData(unsigned start);
8846
8847   DECLARE_CAST(SeqTwoByteString)
8848
8849   // Garbage collection support.  This method is called by the
8850   // garbage collector to compute the actual size of a TwoByteString
8851   // instance.
8852   inline int SeqTwoByteStringSize(InstanceType instance_type);
8853
8854   // Computes the size for a TwoByteString instance of a given length.
8855   static int SizeFor(int length) {
8856     return OBJECT_POINTER_ALIGN(kHeaderSize + length * kShortSize);
8857   }
8858
8859   // Maximal memory usage for a single sequential two-byte string.
8860   static const int kMaxSize = 512 * MB - 1;
8861   STATIC_ASSERT(static_cast<int>((kMaxSize - kHeaderSize)/sizeof(uint16_t)) >=
8862                String::kMaxLength);
8863
8864  private:
8865   DISALLOW_IMPLICIT_CONSTRUCTORS(SeqTwoByteString);
8866 };
8867
8868
8869 // The ConsString class describes string values built by using the
8870 // addition operator on strings.  A ConsString is a pair where the
8871 // first and second components are pointers to other string values.
8872 // One or both components of a ConsString can be pointers to other
8873 // ConsStrings, creating a binary tree of ConsStrings where the leaves
8874 // are non-ConsString string values.  The string value represented by
8875 // a ConsString can be obtained by concatenating the leaf string
8876 // values in a left-to-right depth-first traversal of the tree.
8877 class ConsString: public String {
8878  public:
8879   // First string of the cons cell.
8880   inline String* first();
8881   // Doesn't check that the result is a string, even in debug mode.  This is
8882   // useful during GC where the mark bits confuse the checks.
8883   inline Object* unchecked_first();
8884   inline void set_first(String* first,
8885                         WriteBarrierMode mode = UPDATE_WRITE_BARRIER);
8886
8887   // Second string of the cons cell.
8888   inline String* second();
8889   // Doesn't check that the result is a string, even in debug mode.  This is
8890   // useful during GC where the mark bits confuse the checks.
8891   inline Object* unchecked_second();
8892   inline void set_second(String* second,
8893                          WriteBarrierMode mode = UPDATE_WRITE_BARRIER);
8894
8895   // Dispatched behavior.
8896   uint16_t ConsStringGet(int index);
8897
8898   DECLARE_CAST(ConsString)
8899
8900   // Layout description.
8901   static const int kFirstOffset = POINTER_SIZE_ALIGN(String::kSize);
8902   static const int kSecondOffset = kFirstOffset + kPointerSize;
8903   static const int kSize = kSecondOffset + kPointerSize;
8904
8905   // Minimum length for a cons string.
8906   static const int kMinLength = 13;
8907
8908   typedef FixedBodyDescriptor<kFirstOffset, kSecondOffset + kPointerSize, kSize>
8909           BodyDescriptor;
8910
8911   DECLARE_VERIFIER(ConsString)
8912
8913  private:
8914   DISALLOW_IMPLICIT_CONSTRUCTORS(ConsString);
8915 };
8916
8917
8918 // The Sliced String class describes strings that are substrings of another
8919 // sequential string.  The motivation is to save time and memory when creating
8920 // a substring.  A Sliced String is described as a pointer to the parent,
8921 // the offset from the start of the parent string and the length.  Using
8922 // a Sliced String therefore requires unpacking of the parent string and
8923 // adding the offset to the start address.  A substring of a Sliced String
8924 // are not nested since the double indirection is simplified when creating
8925 // such a substring.
8926 // Currently missing features are:
8927 //  - handling externalized parent strings
8928 //  - external strings as parent
8929 //  - truncating sliced string to enable otherwise unneeded parent to be GC'ed.
8930 class SlicedString: public String {
8931  public:
8932   inline String* parent();
8933   inline void set_parent(String* parent,
8934                          WriteBarrierMode mode = UPDATE_WRITE_BARRIER);
8935   inline int offset() const;
8936   inline void set_offset(int offset);
8937
8938   // Dispatched behavior.
8939   uint16_t SlicedStringGet(int index);
8940
8941   DECLARE_CAST(SlicedString)
8942
8943   // Layout description.
8944   static const int kParentOffset = POINTER_SIZE_ALIGN(String::kSize);
8945   static const int kOffsetOffset = kParentOffset + kPointerSize;
8946   static const int kSize = kOffsetOffset + kPointerSize;
8947
8948   // Minimum length for a sliced string.
8949   static const int kMinLength = 13;
8950
8951   typedef FixedBodyDescriptor<kParentOffset,
8952                               kOffsetOffset + kPointerSize, kSize>
8953           BodyDescriptor;
8954
8955   DECLARE_VERIFIER(SlicedString)
8956
8957  private:
8958   DISALLOW_IMPLICIT_CONSTRUCTORS(SlicedString);
8959 };
8960
8961
8962 // The ExternalString class describes string values that are backed by
8963 // a string resource that lies outside the V8 heap.  ExternalStrings
8964 // consist of the length field common to all strings, a pointer to the
8965 // external resource.  It is important to ensure (externally) that the
8966 // resource is not deallocated while the ExternalString is live in the
8967 // V8 heap.
8968 //
8969 // The API expects that all ExternalStrings are created through the
8970 // API.  Therefore, ExternalStrings should not be used internally.
8971 class ExternalString: public String {
8972  public:
8973   DECLARE_CAST(ExternalString)
8974
8975   // Layout description.
8976   static const int kResourceOffset = POINTER_SIZE_ALIGN(String::kSize);
8977   static const int kShortSize = kResourceOffset + kPointerSize;
8978   static const int kResourceDataOffset = kResourceOffset + kPointerSize;
8979   static const int kSize = kResourceDataOffset + kPointerSize;
8980
8981   static const int kMaxShortLength =
8982       (kShortSize - SeqString::kHeaderSize) / kCharSize;
8983
8984   // Return whether external string is short (data pointer is not cached).
8985   inline bool is_short();
8986
8987   STATIC_ASSERT(kResourceOffset == Internals::kStringResourceOffset);
8988
8989  private:
8990   DISALLOW_IMPLICIT_CONSTRUCTORS(ExternalString);
8991 };
8992
8993
8994 // The ExternalOneByteString class is an external string backed by an
8995 // one-byte string.
8996 class ExternalOneByteString : public ExternalString {
8997  public:
8998   static const bool kHasOneByteEncoding = true;
8999
9000   typedef v8::String::ExternalOneByteStringResource Resource;
9001
9002   // The underlying resource.
9003   inline const Resource* resource();
9004   inline void set_resource(const Resource* buffer);
9005
9006   // Update the pointer cache to the external character array.
9007   // The cached pointer is always valid, as the external character array does =
9008   // not move during lifetime.  Deserialization is the only exception, after
9009   // which the pointer cache has to be refreshed.
9010   inline void update_data_cache();
9011
9012   inline const uint8_t* GetChars();
9013
9014   // Dispatched behavior.
9015   inline uint16_t ExternalOneByteStringGet(int index);
9016
9017   DECLARE_CAST(ExternalOneByteString)
9018
9019   // Garbage collection support.
9020   inline void ExternalOneByteStringIterateBody(ObjectVisitor* v);
9021
9022   template <typename StaticVisitor>
9023   inline void ExternalOneByteStringIterateBody();
9024
9025  private:
9026   DISALLOW_IMPLICIT_CONSTRUCTORS(ExternalOneByteString);
9027 };
9028
9029
9030 // The ExternalTwoByteString class is an external string backed by a UTF-16
9031 // encoded string.
9032 class ExternalTwoByteString: public ExternalString {
9033  public:
9034   static const bool kHasOneByteEncoding = false;
9035
9036   typedef v8::String::ExternalStringResource Resource;
9037
9038   // The underlying string resource.
9039   inline const Resource* resource();
9040   inline void set_resource(const Resource* buffer);
9041
9042   // Update the pointer cache to the external character array.
9043   // The cached pointer is always valid, as the external character array does =
9044   // not move during lifetime.  Deserialization is the only exception, after
9045   // which the pointer cache has to be refreshed.
9046   inline void update_data_cache();
9047
9048   inline const uint16_t* GetChars();
9049
9050   // Dispatched behavior.
9051   inline uint16_t ExternalTwoByteStringGet(int index);
9052
9053   // For regexp code.
9054   inline const uint16_t* ExternalTwoByteStringGetData(unsigned start);
9055
9056   DECLARE_CAST(ExternalTwoByteString)
9057
9058   // Garbage collection support.
9059   inline void ExternalTwoByteStringIterateBody(ObjectVisitor* v);
9060
9061   template<typename StaticVisitor>
9062   inline void ExternalTwoByteStringIterateBody();
9063
9064  private:
9065   DISALLOW_IMPLICIT_CONSTRUCTORS(ExternalTwoByteString);
9066 };
9067
9068
9069 // Utility superclass for stack-allocated objects that must be updated
9070 // on gc.  It provides two ways for the gc to update instances, either
9071 // iterating or updating after gc.
9072 class Relocatable BASE_EMBEDDED {
9073  public:
9074   explicit inline Relocatable(Isolate* isolate);
9075   inline virtual ~Relocatable();
9076   virtual void IterateInstance(ObjectVisitor* v) { }
9077   virtual void PostGarbageCollection() { }
9078
9079   static void PostGarbageCollectionProcessing(Isolate* isolate);
9080   static int ArchiveSpacePerThread();
9081   static char* ArchiveState(Isolate* isolate, char* to);
9082   static char* RestoreState(Isolate* isolate, char* from);
9083   static void Iterate(Isolate* isolate, ObjectVisitor* v);
9084   static void Iterate(ObjectVisitor* v, Relocatable* top);
9085   static char* Iterate(ObjectVisitor* v, char* t);
9086
9087  private:
9088   Isolate* isolate_;
9089   Relocatable* prev_;
9090 };
9091
9092
9093 // A flat string reader provides random access to the contents of a
9094 // string independent of the character width of the string.  The handle
9095 // must be valid as long as the reader is being used.
9096 class FlatStringReader : public Relocatable {
9097  public:
9098   FlatStringReader(Isolate* isolate, Handle<String> str);
9099   FlatStringReader(Isolate* isolate, Vector<const char> input);
9100   void PostGarbageCollection();
9101   inline uc32 Get(int index);
9102   template <typename Char>
9103   inline Char Get(int index);
9104   int length() { return length_; }
9105  private:
9106   String** str_;
9107   bool is_one_byte_;
9108   int length_;
9109   const void* start_;
9110 };
9111
9112
9113 // This maintains an off-stack representation of the stack frames required
9114 // to traverse a ConsString, allowing an entirely iterative and restartable
9115 // traversal of the entire string
9116 class ConsStringIterator {
9117  public:
9118   inline ConsStringIterator() {}
9119   inline explicit ConsStringIterator(ConsString* cons_string, int offset = 0) {
9120     Reset(cons_string, offset);
9121   }
9122   inline void Reset(ConsString* cons_string, int offset = 0) {
9123     depth_ = 0;
9124     // Next will always return NULL.
9125     if (cons_string == NULL) return;
9126     Initialize(cons_string, offset);
9127   }
9128   // Returns NULL when complete.
9129   inline String* Next(int* offset_out) {
9130     *offset_out = 0;
9131     if (depth_ == 0) return NULL;
9132     return Continue(offset_out);
9133   }
9134
9135  private:
9136   static const int kStackSize = 32;
9137   // Use a mask instead of doing modulo operations for stack wrapping.
9138   static const int kDepthMask = kStackSize-1;
9139   STATIC_ASSERT(IS_POWER_OF_TWO(kStackSize));
9140   static inline int OffsetForDepth(int depth);
9141
9142   inline void PushLeft(ConsString* string);
9143   inline void PushRight(ConsString* string);
9144   inline void AdjustMaximumDepth();
9145   inline void Pop();
9146   inline bool StackBlown() { return maximum_depth_ - depth_ == kStackSize; }
9147   void Initialize(ConsString* cons_string, int offset);
9148   String* Continue(int* offset_out);
9149   String* NextLeaf(bool* blew_stack);
9150   String* Search(int* offset_out);
9151
9152   // Stack must always contain only frames for which right traversal
9153   // has not yet been performed.
9154   ConsString* frames_[kStackSize];
9155   ConsString* root_;
9156   int depth_;
9157   int maximum_depth_;
9158   int consumed_;
9159   DISALLOW_COPY_AND_ASSIGN(ConsStringIterator);
9160 };
9161
9162
9163 class StringCharacterStream {
9164  public:
9165   inline StringCharacterStream(String* string,
9166                                int offset = 0);
9167   inline uint16_t GetNext();
9168   inline bool HasMore();
9169   inline void Reset(String* string, int offset = 0);
9170   inline void VisitOneByteString(const uint8_t* chars, int length);
9171   inline void VisitTwoByteString(const uint16_t* chars, int length);
9172
9173  private:
9174   ConsStringIterator iter_;
9175   bool is_one_byte_;
9176   union {
9177     const uint8_t* buffer8_;
9178     const uint16_t* buffer16_;
9179   };
9180   const uint8_t* end_;
9181   DISALLOW_COPY_AND_ASSIGN(StringCharacterStream);
9182 };
9183
9184
9185 template <typename T>
9186 class VectorIterator {
9187  public:
9188   VectorIterator(T* d, int l) : data_(Vector<const T>(d, l)), index_(0) { }
9189   explicit VectorIterator(Vector<const T> data) : data_(data), index_(0) { }
9190   T GetNext() { return data_[index_++]; }
9191   bool has_more() { return index_ < data_.length(); }
9192  private:
9193   Vector<const T> data_;
9194   int index_;
9195 };
9196
9197
9198 // The Oddball describes objects null, undefined, true, and false.
9199 class Oddball: public HeapObject {
9200  public:
9201   // [to_string]: Cached to_string computed at startup.
9202   DECL_ACCESSORS(to_string, String)
9203
9204   // [to_number]: Cached to_number computed at startup.
9205   DECL_ACCESSORS(to_number, Object)
9206
9207   inline byte kind() const;
9208   inline void set_kind(byte kind);
9209
9210   DECLARE_CAST(Oddball)
9211
9212   // Dispatched behavior.
9213   DECLARE_VERIFIER(Oddball)
9214
9215   // Initialize the fields.
9216   static void Initialize(Isolate* isolate,
9217                          Handle<Oddball> oddball,
9218                          const char* to_string,
9219                          Handle<Object> to_number,
9220                          byte kind);
9221
9222   // Layout description.
9223   static const int kToStringOffset = HeapObject::kHeaderSize;
9224   static const int kToNumberOffset = kToStringOffset + kPointerSize;
9225   static const int kKindOffset = kToNumberOffset + kPointerSize;
9226   static const int kSize = kKindOffset + kPointerSize;
9227
9228   static const byte kFalse = 0;
9229   static const byte kTrue = 1;
9230   static const byte kNotBooleanMask = ~1;
9231   static const byte kTheHole = 2;
9232   static const byte kNull = 3;
9233   static const byte kArgumentMarker = 4;
9234   static const byte kUndefined = 5;
9235   static const byte kUninitialized = 6;
9236   static const byte kOther = 7;
9237   static const byte kException = 8;
9238
9239   typedef FixedBodyDescriptor<kToStringOffset,
9240                               kToNumberOffset + kPointerSize,
9241                               kSize> BodyDescriptor;
9242
9243   STATIC_ASSERT(kKindOffset == Internals::kOddballKindOffset);
9244   STATIC_ASSERT(kNull == Internals::kNullOddballKind);
9245   STATIC_ASSERT(kUndefined == Internals::kUndefinedOddballKind);
9246
9247  private:
9248   DISALLOW_IMPLICIT_CONSTRUCTORS(Oddball);
9249 };
9250
9251
9252 class Cell: public HeapObject {
9253  public:
9254   // [value]: value of the cell.
9255   DECL_ACCESSORS(value, Object)
9256
9257   DECLARE_CAST(Cell)
9258
9259   static inline Cell* FromValueAddress(Address value) {
9260     Object* result = FromAddress(value - kValueOffset);
9261     return static_cast<Cell*>(result);
9262   }
9263
9264   inline Address ValueAddress() {
9265     return address() + kValueOffset;
9266   }
9267
9268   // Dispatched behavior.
9269   DECLARE_PRINTER(Cell)
9270   DECLARE_VERIFIER(Cell)
9271
9272   // Layout description.
9273   static const int kValueOffset = HeapObject::kHeaderSize;
9274   static const int kSize = kValueOffset + kPointerSize;
9275
9276   typedef FixedBodyDescriptor<kValueOffset,
9277                               kValueOffset + kPointerSize,
9278                               kSize> BodyDescriptor;
9279
9280  private:
9281   DISALLOW_IMPLICIT_CONSTRUCTORS(Cell);
9282 };
9283
9284
9285 class PropertyCell : public HeapObject {
9286  public:
9287   // [property_details]: details of the global property.
9288   DECL_ACCESSORS(property_details_raw, Object)
9289   // [value]: value of the global property.
9290   DECL_ACCESSORS(value, Object)
9291   // [dependent_code]: dependent code that depends on the type of the global
9292   // property.
9293   DECL_ACCESSORS(dependent_code, DependentCode)
9294
9295   PropertyDetails property_details() {
9296     return PropertyDetails(Smi::cast(property_details_raw()));
9297   }
9298
9299   void set_property_details(PropertyDetails details) {
9300     set_property_details_raw(details.AsSmi());
9301   }
9302
9303   PropertyCellConstantType GetConstantType();
9304
9305   // Computes the new type of the cell's contents for the given value, but
9306   // without actually modifying the details.
9307   static PropertyCellType UpdatedType(Handle<PropertyCell> cell,
9308                                       Handle<Object> value,
9309                                       PropertyDetails details);
9310   static void UpdateCell(Handle<GlobalDictionary> dictionary, int entry,
9311                          Handle<Object> value, PropertyDetails details);
9312
9313   static Handle<PropertyCell> InvalidateEntry(
9314       Handle<GlobalDictionary> dictionary, int entry);
9315
9316   static void SetValueWithInvalidation(Handle<PropertyCell> cell,
9317                                        Handle<Object> new_value);
9318
9319   DECLARE_CAST(PropertyCell)
9320
9321   // Dispatched behavior.
9322   DECLARE_PRINTER(PropertyCell)
9323   DECLARE_VERIFIER(PropertyCell)
9324
9325   // Layout description.
9326   static const int kDetailsOffset = HeapObject::kHeaderSize;
9327   static const int kValueOffset = kDetailsOffset + kPointerSize;
9328   static const int kDependentCodeOffset = kValueOffset + kPointerSize;
9329   static const int kSize = kDependentCodeOffset + kPointerSize;
9330
9331   static const int kPointerFieldsBeginOffset = kValueOffset;
9332   static const int kPointerFieldsEndOffset = kSize;
9333
9334   typedef FixedBodyDescriptor<kValueOffset,
9335                               kSize,
9336                               kSize> BodyDescriptor;
9337
9338  private:
9339   DISALLOW_IMPLICIT_CONSTRUCTORS(PropertyCell);
9340 };
9341
9342
9343 class WeakCell : public HeapObject {
9344  public:
9345   inline Object* value() const;
9346
9347   // This should not be called by anyone except GC.
9348   inline void clear();
9349
9350   // This should not be called by anyone except allocator.
9351   inline void initialize(HeapObject* value);
9352
9353   inline bool cleared() const;
9354
9355   DECL_ACCESSORS(next, Object)
9356
9357   inline void clear_next(Heap* heap);
9358
9359   inline bool next_cleared();
9360
9361   DECLARE_CAST(WeakCell)
9362
9363   DECLARE_PRINTER(WeakCell)
9364   DECLARE_VERIFIER(WeakCell)
9365
9366   // Layout description.
9367   static const int kValueOffset = HeapObject::kHeaderSize;
9368   static const int kNextOffset = kValueOffset + kPointerSize;
9369   static const int kSize = kNextOffset + kPointerSize;
9370
9371   typedef FixedBodyDescriptor<kValueOffset, kSize, kSize> BodyDescriptor;
9372
9373  private:
9374   DISALLOW_IMPLICIT_CONSTRUCTORS(WeakCell);
9375 };
9376
9377
9378 // The JSProxy describes EcmaScript Harmony proxies
9379 class JSProxy: public JSReceiver {
9380  public:
9381   // [handler]: The handler property.
9382   DECL_ACCESSORS(handler, Object)
9383
9384   // [hash]: The hash code property (undefined if not initialized yet).
9385   DECL_ACCESSORS(hash, Object)
9386
9387   DECLARE_CAST(JSProxy)
9388
9389   MUST_USE_RESULT static MaybeHandle<Object> GetPropertyWithHandler(
9390       Handle<JSProxy> proxy,
9391       Handle<Object> receiver,
9392       Handle<Name> name);
9393
9394   // If the handler defines an accessor property with a setter, invoke it.
9395   // If it defines an accessor property without a setter, or a data property
9396   // that is read-only, throw. In all these cases set '*done' to true,
9397   // otherwise set it to false.
9398   MUST_USE_RESULT
9399   static MaybeHandle<Object> SetPropertyViaPrototypesWithHandler(
9400       Handle<JSProxy> proxy, Handle<Object> receiver, Handle<Name> name,
9401       Handle<Object> value, LanguageMode language_mode, bool* done);
9402
9403   MUST_USE_RESULT static Maybe<PropertyAttributes>
9404       GetPropertyAttributesWithHandler(Handle<JSProxy> proxy,
9405                                        Handle<Object> receiver,
9406                                        Handle<Name> name);
9407   MUST_USE_RESULT static MaybeHandle<Object> SetPropertyWithHandler(
9408       Handle<JSProxy> proxy, Handle<Object> receiver, Handle<Name> name,
9409       Handle<Object> value, LanguageMode language_mode);
9410
9411   // Turn the proxy into an (empty) JSObject.
9412   static void Fix(Handle<JSProxy> proxy);
9413
9414   // Initializes the body after the handler slot.
9415   inline void InitializeBody(int object_size, Object* value);
9416
9417   // Invoke a trap by name. If the trap does not exist on this's handler,
9418   // but derived_trap is non-NULL, invoke that instead.  May cause GC.
9419   MUST_USE_RESULT static MaybeHandle<Object> CallTrap(
9420       Handle<JSProxy> proxy,
9421       const char* name,
9422       Handle<Object> derived_trap,
9423       int argc,
9424       Handle<Object> args[]);
9425
9426   // Dispatched behavior.
9427   DECLARE_PRINTER(JSProxy)
9428   DECLARE_VERIFIER(JSProxy)
9429
9430   // Layout description. We add padding so that a proxy has the same
9431   // size as a virgin JSObject. This is essential for becoming a JSObject
9432   // upon freeze.
9433   static const int kHandlerOffset = HeapObject::kHeaderSize;
9434   static const int kHashOffset = kHandlerOffset + kPointerSize;
9435   static const int kPaddingOffset = kHashOffset + kPointerSize;
9436   static const int kSize = JSObject::kHeaderSize;
9437   static const int kHeaderSize = kPaddingOffset;
9438   static const int kPaddingSize = kSize - kPaddingOffset;
9439
9440   STATIC_ASSERT(kPaddingSize >= 0);
9441
9442   typedef FixedBodyDescriptor<kHandlerOffset,
9443                               kPaddingOffset,
9444                               kSize> BodyDescriptor;
9445
9446  private:
9447   friend class JSReceiver;
9448
9449   MUST_USE_RESULT static Maybe<bool> HasPropertyWithHandler(
9450       Handle<JSProxy> proxy, Handle<Name> name);
9451
9452   MUST_USE_RESULT static MaybeHandle<Object> DeletePropertyWithHandler(
9453       Handle<JSProxy> proxy, Handle<Name> name, LanguageMode language_mode);
9454
9455   MUST_USE_RESULT Object* GetIdentityHash();
9456
9457   static Handle<Smi> GetOrCreateIdentityHash(Handle<JSProxy> proxy);
9458
9459   DISALLOW_IMPLICIT_CONSTRUCTORS(JSProxy);
9460 };
9461
9462
9463 class JSFunctionProxy: public JSProxy {
9464  public:
9465   // [call_trap]: The call trap.
9466   DECL_ACCESSORS(call_trap, Object)
9467
9468   // [construct_trap]: The construct trap.
9469   DECL_ACCESSORS(construct_trap, Object)
9470
9471   DECLARE_CAST(JSFunctionProxy)
9472
9473   // Dispatched behavior.
9474   DECLARE_PRINTER(JSFunctionProxy)
9475   DECLARE_VERIFIER(JSFunctionProxy)
9476
9477   // Layout description.
9478   static const int kCallTrapOffset = JSProxy::kPaddingOffset;
9479   static const int kConstructTrapOffset = kCallTrapOffset + kPointerSize;
9480   static const int kPaddingOffset = kConstructTrapOffset + kPointerSize;
9481   static const int kSize = JSFunction::kSize;
9482   static const int kPaddingSize = kSize - kPaddingOffset;
9483
9484   STATIC_ASSERT(kPaddingSize >= 0);
9485
9486   typedef FixedBodyDescriptor<kHandlerOffset,
9487                               kConstructTrapOffset + kPointerSize,
9488                               kSize> BodyDescriptor;
9489
9490  private:
9491   DISALLOW_IMPLICIT_CONSTRUCTORS(JSFunctionProxy);
9492 };
9493
9494
9495 class JSCollection : public JSObject {
9496  public:
9497   // [table]: the backing hash table
9498   DECL_ACCESSORS(table, Object)
9499
9500   static const int kTableOffset = JSObject::kHeaderSize;
9501   static const int kSize = kTableOffset + kPointerSize;
9502
9503  private:
9504   DISALLOW_IMPLICIT_CONSTRUCTORS(JSCollection);
9505 };
9506
9507
9508 // The JSSet describes EcmaScript Harmony sets
9509 class JSSet : public JSCollection {
9510  public:
9511   DECLARE_CAST(JSSet)
9512
9513   // Dispatched behavior.
9514   DECLARE_PRINTER(JSSet)
9515   DECLARE_VERIFIER(JSSet)
9516
9517  private:
9518   DISALLOW_IMPLICIT_CONSTRUCTORS(JSSet);
9519 };
9520
9521
9522 // The JSMap describes EcmaScript Harmony maps
9523 class JSMap : public JSCollection {
9524  public:
9525   DECLARE_CAST(JSMap)
9526
9527   // Dispatched behavior.
9528   DECLARE_PRINTER(JSMap)
9529   DECLARE_VERIFIER(JSMap)
9530
9531  private:
9532   DISALLOW_IMPLICIT_CONSTRUCTORS(JSMap);
9533 };
9534
9535
9536 // OrderedHashTableIterator is an iterator that iterates over the keys and
9537 // values of an OrderedHashTable.
9538 //
9539 // The iterator has a reference to the underlying OrderedHashTable data,
9540 // [table], as well as the current [index] the iterator is at.
9541 //
9542 // When the OrderedHashTable is rehashed it adds a reference from the old table
9543 // to the new table as well as storing enough data about the changes so that the
9544 // iterator [index] can be adjusted accordingly.
9545 //
9546 // When the [Next] result from the iterator is requested, the iterator checks if
9547 // there is a newer table that it needs to transition to.
9548 template<class Derived, class TableType>
9549 class OrderedHashTableIterator: public JSObject {
9550  public:
9551   // [table]: the backing hash table mapping keys to values.
9552   DECL_ACCESSORS(table, Object)
9553
9554   // [index]: The index into the data table.
9555   DECL_ACCESSORS(index, Object)
9556
9557   // [kind]: The kind of iteration this is. One of the [Kind] enum values.
9558   DECL_ACCESSORS(kind, Object)
9559
9560 #ifdef OBJECT_PRINT
9561   void OrderedHashTableIteratorPrint(std::ostream& os);  // NOLINT
9562 #endif
9563
9564   static const int kTableOffset = JSObject::kHeaderSize;
9565   static const int kIndexOffset = kTableOffset + kPointerSize;
9566   static const int kKindOffset = kIndexOffset + kPointerSize;
9567   static const int kSize = kKindOffset + kPointerSize;
9568
9569   enum Kind {
9570     kKindKeys = 1,
9571     kKindValues = 2,
9572     kKindEntries = 3
9573   };
9574
9575   // Whether the iterator has more elements. This needs to be called before
9576   // calling |CurrentKey| and/or |CurrentValue|.
9577   bool HasMore();
9578
9579   // Move the index forward one.
9580   void MoveNext() {
9581     set_index(Smi::FromInt(Smi::cast(index())->value() + 1));
9582   }
9583
9584   // Populates the array with the next key and value and then moves the iterator
9585   // forward.
9586   // This returns the |kind| or 0 if the iterator is already at the end.
9587   Smi* Next(JSArray* value_array);
9588
9589   // Returns the current key of the iterator. This should only be called when
9590   // |HasMore| returns true.
9591   inline Object* CurrentKey();
9592
9593  private:
9594   // Transitions the iterator to the non obsolete backing store. This is a NOP
9595   // if the [table] is not obsolete.
9596   void Transition();
9597
9598   DISALLOW_IMPLICIT_CONSTRUCTORS(OrderedHashTableIterator);
9599 };
9600
9601
9602 class JSSetIterator: public OrderedHashTableIterator<JSSetIterator,
9603                                                      OrderedHashSet> {
9604  public:
9605   // Dispatched behavior.
9606   DECLARE_PRINTER(JSSetIterator)
9607   DECLARE_VERIFIER(JSSetIterator)
9608
9609   DECLARE_CAST(JSSetIterator)
9610
9611   // Called by |Next| to populate the array. This allows the subclasses to
9612   // populate the array differently.
9613   inline void PopulateValueArray(FixedArray* array);
9614
9615  private:
9616   DISALLOW_IMPLICIT_CONSTRUCTORS(JSSetIterator);
9617 };
9618
9619
9620 class JSMapIterator: public OrderedHashTableIterator<JSMapIterator,
9621                                                      OrderedHashMap> {
9622  public:
9623   // Dispatched behavior.
9624   DECLARE_PRINTER(JSMapIterator)
9625   DECLARE_VERIFIER(JSMapIterator)
9626
9627   DECLARE_CAST(JSMapIterator)
9628
9629   // Called by |Next| to populate the array. This allows the subclasses to
9630   // populate the array differently.
9631   inline void PopulateValueArray(FixedArray* array);
9632
9633  private:
9634   // Returns the current value of the iterator. This should only be called when
9635   // |HasMore| returns true.
9636   inline Object* CurrentValue();
9637
9638   DISALLOW_IMPLICIT_CONSTRUCTORS(JSMapIterator);
9639 };
9640
9641
9642 // Base class for both JSWeakMap and JSWeakSet
9643 class JSWeakCollection: public JSObject {
9644  public:
9645   // [table]: the backing hash table mapping keys to values.
9646   DECL_ACCESSORS(table, Object)
9647
9648   // [next]: linked list of encountered weak maps during GC.
9649   DECL_ACCESSORS(next, Object)
9650
9651   static const int kTableOffset = JSObject::kHeaderSize;
9652   static const int kNextOffset = kTableOffset + kPointerSize;
9653   static const int kSize = kNextOffset + kPointerSize;
9654
9655  private:
9656   DISALLOW_IMPLICIT_CONSTRUCTORS(JSWeakCollection);
9657 };
9658
9659
9660 // The JSWeakMap describes EcmaScript Harmony weak maps
9661 class JSWeakMap: public JSWeakCollection {
9662  public:
9663   DECLARE_CAST(JSWeakMap)
9664
9665   // Dispatched behavior.
9666   DECLARE_PRINTER(JSWeakMap)
9667   DECLARE_VERIFIER(JSWeakMap)
9668
9669  private:
9670   DISALLOW_IMPLICIT_CONSTRUCTORS(JSWeakMap);
9671 };
9672
9673
9674 // The JSWeakSet describes EcmaScript Harmony weak sets
9675 class JSWeakSet: public JSWeakCollection {
9676  public:
9677   DECLARE_CAST(JSWeakSet)
9678
9679   // Dispatched behavior.
9680   DECLARE_PRINTER(JSWeakSet)
9681   DECLARE_VERIFIER(JSWeakSet)
9682
9683  private:
9684   DISALLOW_IMPLICIT_CONSTRUCTORS(JSWeakSet);
9685 };
9686
9687
9688 // Whether a JSArrayBuffer is a SharedArrayBuffer or not.
9689 enum class SharedFlag { kNotShared, kShared };
9690
9691
9692 class JSArrayBuffer: public JSObject {
9693  public:
9694   // [backing_store]: backing memory for this array
9695   DECL_ACCESSORS(backing_store, void)
9696
9697   // [byte_length]: length in bytes
9698   DECL_ACCESSORS(byte_length, Object)
9699
9700   inline uint32_t bit_field() const;
9701   inline void set_bit_field(uint32_t bits);
9702
9703   inline bool is_external();
9704   inline void set_is_external(bool value);
9705
9706   inline bool is_neuterable();
9707   inline void set_is_neuterable(bool value);
9708
9709   inline bool was_neutered();
9710   inline void set_was_neutered(bool value);
9711
9712   inline bool is_shared();
9713   inline void set_is_shared(bool value);
9714
9715   DECLARE_CAST(JSArrayBuffer)
9716
9717   void Neuter();
9718
9719   // Dispatched behavior.
9720   DECLARE_PRINTER(JSArrayBuffer)
9721   DECLARE_VERIFIER(JSArrayBuffer)
9722
9723   static const int kBackingStoreOffset = JSObject::kHeaderSize;
9724   static const int kByteLengthOffset = kBackingStoreOffset + kPointerSize;
9725   static const int kBitFieldSlot = kByteLengthOffset + kPointerSize;
9726 #if V8_TARGET_LITTLE_ENDIAN || !V8_HOST_ARCH_64_BIT
9727   static const int kBitFieldOffset = kBitFieldSlot;
9728 #else
9729   static const int kBitFieldOffset = kBitFieldSlot + kIntSize;
9730 #endif
9731   static const int kSize = kBitFieldSlot + kPointerSize;
9732
9733   static const int kSizeWithInternalFields =
9734       kSize + v8::ArrayBuffer::kInternalFieldCount * kPointerSize;
9735
9736   class IsExternal : public BitField<bool, 1, 1> {};
9737   class IsNeuterable : public BitField<bool, 2, 1> {};
9738   class WasNeutered : public BitField<bool, 3, 1> {};
9739   class IsShared : public BitField<bool, 4, 1> {};
9740
9741  private:
9742   DISALLOW_IMPLICIT_CONSTRUCTORS(JSArrayBuffer);
9743 };
9744
9745
9746 class JSArrayBufferView: public JSObject {
9747  public:
9748   // [buffer]: ArrayBuffer that this typed array views.
9749   DECL_ACCESSORS(buffer, Object)
9750
9751   // [byte_offset]: offset of typed array in bytes.
9752   DECL_ACCESSORS(byte_offset, Object)
9753
9754   // [byte_length]: length of typed array in bytes.
9755   DECL_ACCESSORS(byte_length, Object)
9756
9757   DECLARE_CAST(JSArrayBufferView)
9758
9759   DECLARE_VERIFIER(JSArrayBufferView)
9760
9761   inline bool WasNeutered() const;
9762
9763   static const int kBufferOffset = JSObject::kHeaderSize;
9764   static const int kByteOffsetOffset = kBufferOffset + kPointerSize;
9765   static const int kByteLengthOffset = kByteOffsetOffset + kPointerSize;
9766   static const int kViewSize = kByteLengthOffset + kPointerSize;
9767
9768  private:
9769 #ifdef VERIFY_HEAP
9770   DECL_ACCESSORS(raw_byte_offset, Object)
9771   DECL_ACCESSORS(raw_byte_length, Object)
9772 #endif
9773
9774   DISALLOW_IMPLICIT_CONSTRUCTORS(JSArrayBufferView);
9775 };
9776
9777
9778 class JSTypedArray: public JSArrayBufferView {
9779  public:
9780   // [length]: length of typed array in elements.
9781   DECL_ACCESSORS(length, Object)
9782   inline uint32_t length_value() const;
9783
9784   DECLARE_CAST(JSTypedArray)
9785
9786   ExternalArrayType type();
9787   size_t element_size();
9788
9789   Handle<JSArrayBuffer> GetBuffer();
9790
9791   // Dispatched behavior.
9792   DECLARE_PRINTER(JSTypedArray)
9793   DECLARE_VERIFIER(JSTypedArray)
9794
9795   static const int kLengthOffset = kViewSize + kPointerSize;
9796   static const int kSize = kLengthOffset + kPointerSize;
9797
9798   static const int kSizeWithInternalFields =
9799       kSize + v8::ArrayBufferView::kInternalFieldCount * kPointerSize;
9800
9801  private:
9802   static Handle<JSArrayBuffer> MaterializeArrayBuffer(
9803       Handle<JSTypedArray> typed_array);
9804 #ifdef VERIFY_HEAP
9805   DECL_ACCESSORS(raw_length, Object)
9806 #endif
9807
9808   DISALLOW_IMPLICIT_CONSTRUCTORS(JSTypedArray);
9809 };
9810
9811
9812 class JSDataView: public JSArrayBufferView {
9813  public:
9814   DECLARE_CAST(JSDataView)
9815
9816   // Dispatched behavior.
9817   DECLARE_PRINTER(JSDataView)
9818   DECLARE_VERIFIER(JSDataView)
9819
9820   static const int kSize = kViewSize;
9821
9822   static const int kSizeWithInternalFields =
9823       kSize + v8::ArrayBufferView::kInternalFieldCount * kPointerSize;
9824
9825  private:
9826   DISALLOW_IMPLICIT_CONSTRUCTORS(JSDataView);
9827 };
9828
9829
9830 // Foreign describes objects pointing from JavaScript to C structures.
9831 class Foreign: public HeapObject {
9832  public:
9833   // [address]: field containing the address.
9834   inline Address foreign_address();
9835   inline void set_foreign_address(Address value);
9836
9837   DECLARE_CAST(Foreign)
9838
9839   // Dispatched behavior.
9840   inline void ForeignIterateBody(ObjectVisitor* v);
9841
9842   template<typename StaticVisitor>
9843   inline void ForeignIterateBody();
9844
9845   // Dispatched behavior.
9846   DECLARE_PRINTER(Foreign)
9847   DECLARE_VERIFIER(Foreign)
9848
9849   // Layout description.
9850
9851   static const int kForeignAddressOffset = HeapObject::kHeaderSize;
9852   static const int kSize = kForeignAddressOffset + kPointerSize;
9853
9854   STATIC_ASSERT(kForeignAddressOffset == Internals::kForeignAddressOffset);
9855
9856  private:
9857   DISALLOW_IMPLICIT_CONSTRUCTORS(Foreign);
9858 };
9859
9860
9861 // The JSArray describes JavaScript Arrays
9862 //  Such an array can be in one of two modes:
9863 //    - fast, backing storage is a FixedArray and length <= elements.length();
9864 //       Please note: push and pop can be used to grow and shrink the array.
9865 //    - slow, backing storage is a HashTable with numbers as keys.
9866 class JSArray: public JSObject {
9867  public:
9868   // [length]: The length property.
9869   DECL_ACCESSORS(length, Object)
9870
9871   // Overload the length setter to skip write barrier when the length
9872   // is set to a smi. This matches the set function on FixedArray.
9873   inline void set_length(Smi* length);
9874
9875   static bool HasReadOnlyLength(Handle<JSArray> array);
9876   static bool WouldChangeReadOnlyLength(Handle<JSArray> array, uint32_t index);
9877   static MaybeHandle<Object> ReadOnlyLengthError(Handle<JSArray> array);
9878
9879   // Initialize the array with the given capacity. The function may
9880   // fail due to out-of-memory situations, but only if the requested
9881   // capacity is non-zero.
9882   static void Initialize(Handle<JSArray> array, int capacity, int length = 0);
9883
9884   // If the JSArray has fast elements, and new_length would result in
9885   // normalization, returns true.
9886   bool SetLengthWouldNormalize(uint32_t new_length);
9887   static inline bool SetLengthWouldNormalize(Heap* heap, uint32_t new_length);
9888
9889   // Initializes the array to a certain length.
9890   inline bool AllowsSetLength();
9891
9892   static void SetLength(Handle<JSArray> array, uint32_t length);
9893   // Same as above but will also queue splice records if |array| is observed.
9894   static MaybeHandle<Object> ObservableSetLength(Handle<JSArray> array,
9895                                                  uint32_t length);
9896
9897   // Set the content of the array to the content of storage.
9898   static inline void SetContent(Handle<JSArray> array,
9899                                 Handle<FixedArrayBase> storage);
9900
9901   DECLARE_CAST(JSArray)
9902
9903   // Dispatched behavior.
9904   DECLARE_PRINTER(JSArray)
9905   DECLARE_VERIFIER(JSArray)
9906
9907   // Number of element slots to pre-allocate for an empty array.
9908   static const int kPreallocatedArrayElements = 4;
9909
9910   // Layout description.
9911   static const int kLengthOffset = JSObject::kHeaderSize;
9912   static const int kSize = kLengthOffset + kPointerSize;
9913
9914  private:
9915   DISALLOW_IMPLICIT_CONSTRUCTORS(JSArray);
9916 };
9917
9918
9919 Handle<Object> CacheInitialJSArrayMaps(Handle<Context> native_context,
9920                                        Handle<Map> initial_map);
9921
9922
9923 // JSRegExpResult is just a JSArray with a specific initial map.
9924 // This initial map adds in-object properties for "index" and "input"
9925 // properties, as assigned by RegExp.prototype.exec, which allows
9926 // faster creation of RegExp exec results.
9927 // This class just holds constants used when creating the result.
9928 // After creation the result must be treated as a JSArray in all regards.
9929 class JSRegExpResult: public JSArray {
9930  public:
9931   // Offsets of object fields.
9932   static const int kIndexOffset = JSArray::kSize;
9933   static const int kInputOffset = kIndexOffset + kPointerSize;
9934   static const int kSize = kInputOffset + kPointerSize;
9935   // Indices of in-object properties.
9936   static const int kIndexIndex = 0;
9937   static const int kInputIndex = 1;
9938  private:
9939   DISALLOW_IMPLICIT_CONSTRUCTORS(JSRegExpResult);
9940 };
9941
9942
9943 class AccessorInfo: public Struct {
9944  public:
9945   DECL_ACCESSORS(name, Object)
9946   DECL_ACCESSORS(flag, Smi)
9947   DECL_ACCESSORS(expected_receiver_type, Object)
9948
9949   inline bool all_can_read();
9950   inline void set_all_can_read(bool value);
9951
9952   inline bool all_can_write();
9953   inline void set_all_can_write(bool value);
9954
9955   inline bool is_special_data_property();
9956   inline void set_is_special_data_property(bool value);
9957
9958   inline PropertyAttributes property_attributes();
9959   inline void set_property_attributes(PropertyAttributes attributes);
9960
9961   // Checks whether the given receiver is compatible with this accessor.
9962   static bool IsCompatibleReceiverMap(Isolate* isolate,
9963                                       Handle<AccessorInfo> info,
9964                                       Handle<Map> map);
9965   inline bool IsCompatibleReceiver(Object* receiver);
9966
9967   DECLARE_CAST(AccessorInfo)
9968
9969   // Dispatched behavior.
9970   DECLARE_VERIFIER(AccessorInfo)
9971
9972   // Append all descriptors to the array that are not already there.
9973   // Return number added.
9974   static int AppendUnique(Handle<Object> descriptors,
9975                           Handle<FixedArray> array,
9976                           int valid_descriptors);
9977
9978   static const int kNameOffset = HeapObject::kHeaderSize;
9979   static const int kFlagOffset = kNameOffset + kPointerSize;
9980   static const int kExpectedReceiverTypeOffset = kFlagOffset + kPointerSize;
9981   static const int kSize = kExpectedReceiverTypeOffset + kPointerSize;
9982
9983  private:
9984   inline bool HasExpectedReceiverType() {
9985     return expected_receiver_type()->IsFunctionTemplateInfo();
9986   }
9987   // Bit positions in flag.
9988   static const int kAllCanReadBit = 0;
9989   static const int kAllCanWriteBit = 1;
9990   static const int kSpecialDataProperty = 2;
9991   class AttributesField : public BitField<PropertyAttributes, 3, 3> {};
9992
9993   DISALLOW_IMPLICIT_CONSTRUCTORS(AccessorInfo);
9994 };
9995
9996
9997 // An accessor must have a getter, but can have no setter.
9998 //
9999 // When setting a property, V8 searches accessors in prototypes.
10000 // If an accessor was found and it does not have a setter,
10001 // the request is ignored.
10002 //
10003 // If the accessor in the prototype has the READ_ONLY property attribute, then
10004 // a new value is added to the derived object when the property is set.
10005 // This shadows the accessor in the prototype.
10006 class ExecutableAccessorInfo: public AccessorInfo {
10007  public:
10008   DECL_ACCESSORS(getter, Object)
10009   DECL_ACCESSORS(setter, Object)
10010   DECL_ACCESSORS(data, Object)
10011
10012   DECLARE_CAST(ExecutableAccessorInfo)
10013
10014   // Dispatched behavior.
10015   DECLARE_PRINTER(ExecutableAccessorInfo)
10016   DECLARE_VERIFIER(ExecutableAccessorInfo)
10017
10018   static const int kGetterOffset = AccessorInfo::kSize;
10019   static const int kSetterOffset = kGetterOffset + kPointerSize;
10020   static const int kDataOffset = kSetterOffset + kPointerSize;
10021   static const int kSize = kDataOffset + kPointerSize;
10022
10023   static void ClearSetter(Handle<ExecutableAccessorInfo> info);
10024
10025  private:
10026   DISALLOW_IMPLICIT_CONSTRUCTORS(ExecutableAccessorInfo);
10027 };
10028
10029
10030 // Support for JavaScript accessors: A pair of a getter and a setter. Each
10031 // accessor can either be
10032 //   * a pointer to a JavaScript function or proxy: a real accessor
10033 //   * undefined: considered an accessor by the spec, too, strangely enough
10034 //   * the hole: an accessor which has not been set
10035 //   * a pointer to a map: a transition used to ensure map sharing
10036 class AccessorPair: public Struct {
10037  public:
10038   DECL_ACCESSORS(getter, Object)
10039   DECL_ACCESSORS(setter, Object)
10040
10041   DECLARE_CAST(AccessorPair)
10042
10043   static Handle<AccessorPair> Copy(Handle<AccessorPair> pair);
10044
10045   Object* get(AccessorComponent component) {
10046     return component == ACCESSOR_GETTER ? getter() : setter();
10047   }
10048
10049   void set(AccessorComponent component, Object* value) {
10050     if (component == ACCESSOR_GETTER) {
10051       set_getter(value);
10052     } else {
10053       set_setter(value);
10054     }
10055   }
10056
10057   // Note: Returns undefined instead in case of a hole.
10058   Object* GetComponent(AccessorComponent component);
10059
10060   // Set both components, skipping arguments which are a JavaScript null.
10061   void SetComponents(Object* getter, Object* setter) {
10062     if (!getter->IsNull()) set_getter(getter);
10063     if (!setter->IsNull()) set_setter(setter);
10064   }
10065
10066   bool Equals(AccessorPair* pair) {
10067     return (this == pair) || pair->Equals(getter(), setter());
10068   }
10069
10070   bool Equals(Object* getter_value, Object* setter_value) {
10071     return (getter() == getter_value) && (setter() == setter_value);
10072   }
10073
10074   bool ContainsAccessor() {
10075     return IsJSAccessor(getter()) || IsJSAccessor(setter());
10076   }
10077
10078   // Dispatched behavior.
10079   DECLARE_PRINTER(AccessorPair)
10080   DECLARE_VERIFIER(AccessorPair)
10081
10082   static const int kGetterOffset = HeapObject::kHeaderSize;
10083   static const int kSetterOffset = kGetterOffset + kPointerSize;
10084   static const int kSize = kSetterOffset + kPointerSize;
10085
10086  private:
10087   // Strangely enough, in addition to functions and harmony proxies, the spec
10088   // requires us to consider undefined as a kind of accessor, too:
10089   //    var obj = {};
10090   //    Object.defineProperty(obj, "foo", {get: undefined});
10091   //    assertTrue("foo" in obj);
10092   bool IsJSAccessor(Object* obj) {
10093     return obj->IsSpecFunction() || obj->IsUndefined();
10094   }
10095
10096   DISALLOW_IMPLICIT_CONSTRUCTORS(AccessorPair);
10097 };
10098
10099
10100 class AccessCheckInfo: public Struct {
10101  public:
10102   DECL_ACCESSORS(named_callback, Object)
10103   DECL_ACCESSORS(indexed_callback, Object)
10104   DECL_ACCESSORS(data, Object)
10105
10106   DECLARE_CAST(AccessCheckInfo)
10107
10108   // Dispatched behavior.
10109   DECLARE_PRINTER(AccessCheckInfo)
10110   DECLARE_VERIFIER(AccessCheckInfo)
10111
10112   static const int kNamedCallbackOffset   = HeapObject::kHeaderSize;
10113   static const int kIndexedCallbackOffset = kNamedCallbackOffset + kPointerSize;
10114   static const int kDataOffset = kIndexedCallbackOffset + kPointerSize;
10115   static const int kSize = kDataOffset + kPointerSize;
10116
10117  private:
10118   DISALLOW_IMPLICIT_CONSTRUCTORS(AccessCheckInfo);
10119 };
10120
10121
10122 class InterceptorInfo: public Struct {
10123  public:
10124   DECL_ACCESSORS(getter, Object)
10125   DECL_ACCESSORS(setter, Object)
10126   DECL_ACCESSORS(query, Object)
10127   DECL_ACCESSORS(deleter, Object)
10128   DECL_ACCESSORS(enumerator, Object)
10129   DECL_ACCESSORS(data, Object)
10130   DECL_BOOLEAN_ACCESSORS(can_intercept_symbols)
10131   DECL_BOOLEAN_ACCESSORS(all_can_read)
10132   DECL_BOOLEAN_ACCESSORS(non_masking)
10133
10134   inline int flags() const;
10135   inline void set_flags(int flags);
10136
10137   DECLARE_CAST(InterceptorInfo)
10138
10139   // Dispatched behavior.
10140   DECLARE_PRINTER(InterceptorInfo)
10141   DECLARE_VERIFIER(InterceptorInfo)
10142
10143   static const int kGetterOffset = HeapObject::kHeaderSize;
10144   static const int kSetterOffset = kGetterOffset + kPointerSize;
10145   static const int kQueryOffset = kSetterOffset + kPointerSize;
10146   static const int kDeleterOffset = kQueryOffset + kPointerSize;
10147   static const int kEnumeratorOffset = kDeleterOffset + kPointerSize;
10148   static const int kDataOffset = kEnumeratorOffset + kPointerSize;
10149   static const int kFlagsOffset = kDataOffset + kPointerSize;
10150   static const int kSize = kFlagsOffset + kPointerSize;
10151
10152   static const int kCanInterceptSymbolsBit = 0;
10153   static const int kAllCanReadBit = 1;
10154   static const int kNonMasking = 2;
10155
10156  private:
10157   DISALLOW_IMPLICIT_CONSTRUCTORS(InterceptorInfo);
10158 };
10159
10160
10161 class CallHandlerInfo: public Struct {
10162  public:
10163   DECL_ACCESSORS(callback, Object)
10164   DECL_ACCESSORS(data, Object)
10165
10166   DECLARE_CAST(CallHandlerInfo)
10167
10168   // Dispatched behavior.
10169   DECLARE_PRINTER(CallHandlerInfo)
10170   DECLARE_VERIFIER(CallHandlerInfo)
10171
10172   static const int kCallbackOffset = HeapObject::kHeaderSize;
10173   static const int kDataOffset = kCallbackOffset + kPointerSize;
10174   static const int kSize = kDataOffset + kPointerSize;
10175
10176  private:
10177   DISALLOW_IMPLICIT_CONSTRUCTORS(CallHandlerInfo);
10178 };
10179
10180
10181 class TemplateInfo: public Struct {
10182  public:
10183   DECL_ACCESSORS(tag, Object)
10184   inline int number_of_properties() const;
10185   inline void set_number_of_properties(int value);
10186   DECL_ACCESSORS(property_list, Object)
10187   DECL_ACCESSORS(property_accessors, Object)
10188
10189   DECLARE_VERIFIER(TemplateInfo)
10190
10191   static const int kTagOffset = HeapObject::kHeaderSize;
10192   static const int kNumberOfProperties = kTagOffset + kPointerSize;
10193   static const int kPropertyListOffset = kNumberOfProperties + kPointerSize;
10194   static const int kPropertyAccessorsOffset =
10195       kPropertyListOffset + kPointerSize;
10196   static const int kHeaderSize = kPropertyAccessorsOffset + kPointerSize;
10197
10198  private:
10199   DISALLOW_IMPLICIT_CONSTRUCTORS(TemplateInfo);
10200 };
10201
10202
10203 class FunctionTemplateInfo: public TemplateInfo {
10204  public:
10205   DECL_ACCESSORS(serial_number, Object)
10206   DECL_ACCESSORS(call_code, Object)
10207   DECL_ACCESSORS(prototype_template, Object)
10208   DECL_ACCESSORS(parent_template, Object)
10209   DECL_ACCESSORS(named_property_handler, Object)
10210   DECL_ACCESSORS(indexed_property_handler, Object)
10211   DECL_ACCESSORS(instance_template, Object)
10212   DECL_ACCESSORS(class_name, Object)
10213   DECL_ACCESSORS(signature, Object)
10214   DECL_ACCESSORS(instance_call_handler, Object)
10215   DECL_ACCESSORS(access_check_info, Object)
10216   DECL_ACCESSORS(flag, Smi)
10217
10218   inline int length() const;
10219   inline void set_length(int value);
10220
10221   // Following properties use flag bits.
10222   DECL_BOOLEAN_ACCESSORS(hidden_prototype)
10223   DECL_BOOLEAN_ACCESSORS(undetectable)
10224   // If the bit is set, object instances created by this function
10225   // requires access check.
10226   DECL_BOOLEAN_ACCESSORS(needs_access_check)
10227   DECL_BOOLEAN_ACCESSORS(read_only_prototype)
10228   DECL_BOOLEAN_ACCESSORS(remove_prototype)
10229   DECL_BOOLEAN_ACCESSORS(do_not_cache)
10230   DECL_BOOLEAN_ACCESSORS(instantiated)
10231   DECL_BOOLEAN_ACCESSORS(accept_any_receiver)
10232
10233   DECLARE_CAST(FunctionTemplateInfo)
10234
10235   // Dispatched behavior.
10236   DECLARE_PRINTER(FunctionTemplateInfo)
10237   DECLARE_VERIFIER(FunctionTemplateInfo)
10238
10239   static const int kSerialNumberOffset = TemplateInfo::kHeaderSize;
10240   static const int kCallCodeOffset = kSerialNumberOffset + kPointerSize;
10241   static const int kPrototypeTemplateOffset =
10242       kCallCodeOffset + kPointerSize;
10243   static const int kParentTemplateOffset =
10244       kPrototypeTemplateOffset + kPointerSize;
10245   static const int kNamedPropertyHandlerOffset =
10246       kParentTemplateOffset + kPointerSize;
10247   static const int kIndexedPropertyHandlerOffset =
10248       kNamedPropertyHandlerOffset + kPointerSize;
10249   static const int kInstanceTemplateOffset =
10250       kIndexedPropertyHandlerOffset + kPointerSize;
10251   static const int kClassNameOffset = kInstanceTemplateOffset + kPointerSize;
10252   static const int kSignatureOffset = kClassNameOffset + kPointerSize;
10253   static const int kInstanceCallHandlerOffset = kSignatureOffset + kPointerSize;
10254   static const int kAccessCheckInfoOffset =
10255       kInstanceCallHandlerOffset + kPointerSize;
10256   static const int kFlagOffset = kAccessCheckInfoOffset + kPointerSize;
10257   static const int kLengthOffset = kFlagOffset + kPointerSize;
10258   static const int kSize = kLengthOffset + kPointerSize;
10259
10260   // Returns true if |object| is an instance of this function template.
10261   bool IsTemplateFor(Object* object);
10262   bool IsTemplateFor(Map* map);
10263
10264   // Returns the holder JSObject if the function can legally be called with this
10265   // receiver.  Returns Heap::null_value() if the call is illegal.
10266   Object* GetCompatibleReceiver(Isolate* isolate, Object* receiver);
10267
10268  private:
10269   // Bit position in the flag, from least significant bit position.
10270   static const int kHiddenPrototypeBit   = 0;
10271   static const int kUndetectableBit      = 1;
10272   static const int kNeedsAccessCheckBit  = 2;
10273   static const int kReadOnlyPrototypeBit = 3;
10274   static const int kRemovePrototypeBit   = 4;
10275   static const int kDoNotCacheBit        = 5;
10276   static const int kInstantiatedBit      = 6;
10277   static const int kAcceptAnyReceiver = 7;
10278
10279   DISALLOW_IMPLICIT_CONSTRUCTORS(FunctionTemplateInfo);
10280 };
10281
10282
10283 class ObjectTemplateInfo: public TemplateInfo {
10284  public:
10285   DECL_ACCESSORS(constructor, Object)
10286   DECL_ACCESSORS(internal_field_count, Object)
10287
10288   DECLARE_CAST(ObjectTemplateInfo)
10289
10290   // Dispatched behavior.
10291   DECLARE_PRINTER(ObjectTemplateInfo)
10292   DECLARE_VERIFIER(ObjectTemplateInfo)
10293
10294   static const int kConstructorOffset = TemplateInfo::kHeaderSize;
10295   static const int kInternalFieldCountOffset =
10296       kConstructorOffset + kPointerSize;
10297   static const int kSize = kInternalFieldCountOffset + kPointerSize;
10298 };
10299
10300
10301 class TypeSwitchInfo: public Struct {
10302  public:
10303   DECL_ACCESSORS(types, Object)
10304
10305   DECLARE_CAST(TypeSwitchInfo)
10306
10307   // Dispatched behavior.
10308   DECLARE_PRINTER(TypeSwitchInfo)
10309   DECLARE_VERIFIER(TypeSwitchInfo)
10310
10311   static const int kTypesOffset = Struct::kHeaderSize;
10312   static const int kSize        = kTypesOffset + kPointerSize;
10313 };
10314
10315
10316 // The DebugInfo class holds additional information for a function being
10317 // debugged.
10318 class DebugInfo: public Struct {
10319  public:
10320   // The shared function info for the source being debugged.
10321   DECL_ACCESSORS(shared, SharedFunctionInfo)
10322   // Code object for the patched code. This code object is the code object
10323   // currently active for the function.
10324   DECL_ACCESSORS(code, Code)
10325   // Fixed array holding status information for each active break point.
10326   DECL_ACCESSORS(break_points, FixedArray)
10327
10328   // Check if there is a break point at a code position.
10329   bool HasBreakPoint(int code_position);
10330   // Get the break point info object for a code position.
10331   Object* GetBreakPointInfo(int code_position);
10332   // Clear a break point.
10333   static void ClearBreakPoint(Handle<DebugInfo> debug_info,
10334                               int code_position,
10335                               Handle<Object> break_point_object);
10336   // Set a break point.
10337   static void SetBreakPoint(Handle<DebugInfo> debug_info, int code_position,
10338                             int source_position, int statement_position,
10339                             Handle<Object> break_point_object);
10340   // Get the break point objects for a code position.
10341   Handle<Object> GetBreakPointObjects(int code_position);
10342   // Find the break point info holding this break point object.
10343   static Handle<Object> FindBreakPointInfo(Handle<DebugInfo> debug_info,
10344                                            Handle<Object> break_point_object);
10345   // Get the number of break points for this function.
10346   int GetBreakPointCount();
10347
10348   DECLARE_CAST(DebugInfo)
10349
10350   // Dispatched behavior.
10351   DECLARE_PRINTER(DebugInfo)
10352   DECLARE_VERIFIER(DebugInfo)
10353
10354   static const int kSharedFunctionInfoIndex = Struct::kHeaderSize;
10355   static const int kCodeIndex = kSharedFunctionInfoIndex + kPointerSize;
10356   static const int kBreakPointsStateIndex = kCodeIndex + kPointerSize;
10357   static const int kSize = kBreakPointsStateIndex + kPointerSize;
10358
10359   static const int kEstimatedNofBreakPointsInFunction = 16;
10360
10361  private:
10362   static const int kNoBreakPointInfo = -1;
10363
10364   // Lookup the index in the break_points array for a code position.
10365   int GetBreakPointInfoIndex(int code_position);
10366
10367   DISALLOW_IMPLICIT_CONSTRUCTORS(DebugInfo);
10368 };
10369
10370
10371 // The BreakPointInfo class holds information for break points set in a
10372 // function. The DebugInfo object holds a BreakPointInfo object for each code
10373 // position with one or more break points.
10374 class BreakPointInfo: public Struct {
10375  public:
10376   // The position in the code for the break point.
10377   DECL_ACCESSORS(code_position, Smi)
10378   // The position in the source for the break position.
10379   DECL_ACCESSORS(source_position, Smi)
10380   // The position in the source for the last statement before this break
10381   // position.
10382   DECL_ACCESSORS(statement_position, Smi)
10383   // List of related JavaScript break points.
10384   DECL_ACCESSORS(break_point_objects, Object)
10385
10386   // Removes a break point.
10387   static void ClearBreakPoint(Handle<BreakPointInfo> info,
10388                               Handle<Object> break_point_object);
10389   // Set a break point.
10390   static void SetBreakPoint(Handle<BreakPointInfo> info,
10391                             Handle<Object> break_point_object);
10392   // Check if break point info has this break point object.
10393   static bool HasBreakPointObject(Handle<BreakPointInfo> info,
10394                                   Handle<Object> break_point_object);
10395   // Get the number of break points for this code position.
10396   int GetBreakPointCount();
10397
10398   DECLARE_CAST(BreakPointInfo)
10399
10400   // Dispatched behavior.
10401   DECLARE_PRINTER(BreakPointInfo)
10402   DECLARE_VERIFIER(BreakPointInfo)
10403
10404   static const int kCodePositionIndex = Struct::kHeaderSize;
10405   static const int kSourcePositionIndex = kCodePositionIndex + kPointerSize;
10406   static const int kStatementPositionIndex =
10407       kSourcePositionIndex + kPointerSize;
10408   static const int kBreakPointObjectsIndex =
10409       kStatementPositionIndex + kPointerSize;
10410   static const int kSize = kBreakPointObjectsIndex + kPointerSize;
10411
10412  private:
10413   DISALLOW_IMPLICIT_CONSTRUCTORS(BreakPointInfo);
10414 };
10415
10416
10417 #undef DECL_BOOLEAN_ACCESSORS
10418 #undef DECL_ACCESSORS
10419 #undef DECLARE_CAST
10420 #undef DECLARE_VERIFIER
10421
10422 #define VISITOR_SYNCHRONIZATION_TAGS_LIST(V)                               \
10423   V(kStringTable, "string_table", "(Internalized strings)")                \
10424   V(kExternalStringsTable, "external_strings_table", "(External strings)") \
10425   V(kStrongRootList, "strong_root_list", "(Strong roots)")                 \
10426   V(kSmiRootList, "smi_root_list", "(Smi roots)")                          \
10427   V(kInternalizedString, "internalized_string", "(Internal string)")       \
10428   V(kBootstrapper, "bootstrapper", "(Bootstrapper)")                       \
10429   V(kTop, "top", "(Isolate)")                                              \
10430   V(kRelocatable, "relocatable", "(Relocatable)")                          \
10431   V(kDebug, "debug", "(Debugger)")                                         \
10432   V(kCompilationCache, "compilationcache", "(Compilation cache)")          \
10433   V(kHandleScope, "handlescope", "(Handle scope)")                         \
10434   V(kBuiltins, "builtins", "(Builtins)")                                   \
10435   V(kGlobalHandles, "globalhandles", "(Global handles)")                   \
10436   V(kEternalHandles, "eternalhandles", "(Eternal handles)")                \
10437   V(kThreadManager, "threadmanager", "(Thread manager)")                   \
10438   V(kStrongRoots, "strong roots", "(Strong roots)")                        \
10439   V(kExtensions, "Extensions", "(Extensions)")
10440
10441 class VisitorSynchronization : public AllStatic {
10442  public:
10443 #define DECLARE_ENUM(enum_item, ignore1, ignore2) enum_item,
10444   enum SyncTag {
10445     VISITOR_SYNCHRONIZATION_TAGS_LIST(DECLARE_ENUM)
10446     kNumberOfSyncTags
10447   };
10448 #undef DECLARE_ENUM
10449
10450   static const char* const kTags[kNumberOfSyncTags];
10451   static const char* const kTagNames[kNumberOfSyncTags];
10452 };
10453
10454 // Abstract base class for visiting, and optionally modifying, the
10455 // pointers contained in Objects. Used in GC and serialization/deserialization.
10456 class ObjectVisitor BASE_EMBEDDED {
10457  public:
10458   virtual ~ObjectVisitor() {}
10459
10460   // Visits a contiguous arrays of pointers in the half-open range
10461   // [start, end). Any or all of the values may be modified on return.
10462   virtual void VisitPointers(Object** start, Object** end) = 0;
10463
10464   // Handy shorthand for visiting a single pointer.
10465   virtual void VisitPointer(Object** p) { VisitPointers(p, p + 1); }
10466
10467   // Visit weak next_code_link in Code object.
10468   virtual void VisitNextCodeLink(Object** p) { VisitPointers(p, p + 1); }
10469
10470   // To allow lazy clearing of inline caches the visitor has
10471   // a rich interface for iterating over Code objects..
10472
10473   // Visits a code target in the instruction stream.
10474   virtual void VisitCodeTarget(RelocInfo* rinfo);
10475
10476   // Visits a code entry in a JS function.
10477   virtual void VisitCodeEntry(Address entry_address);
10478
10479   // Visits a global property cell reference in the instruction stream.
10480   virtual void VisitCell(RelocInfo* rinfo);
10481
10482   // Visits a runtime entry in the instruction stream.
10483   virtual void VisitRuntimeEntry(RelocInfo* rinfo) {}
10484
10485   // Visits the resource of an one-byte or two-byte string.
10486   virtual void VisitExternalOneByteString(
10487       v8::String::ExternalOneByteStringResource** resource) {}
10488   virtual void VisitExternalTwoByteString(
10489       v8::String::ExternalStringResource** resource) {}
10490
10491   // Visits a debug call target in the instruction stream.
10492   virtual void VisitDebugTarget(RelocInfo* rinfo);
10493
10494   // Visits the byte sequence in a function's prologue that contains information
10495   // about the code's age.
10496   virtual void VisitCodeAgeSequence(RelocInfo* rinfo);
10497
10498   // Visit pointer embedded into a code object.
10499   virtual void VisitEmbeddedPointer(RelocInfo* rinfo);
10500
10501   // Visits an external reference embedded into a code object.
10502   virtual void VisitExternalReference(RelocInfo* rinfo);
10503
10504   // Visits an external reference.
10505   virtual void VisitExternalReference(Address* p) {}
10506
10507   // Visits an (encoded) internal reference.
10508   virtual void VisitInternalReference(RelocInfo* rinfo) {}
10509
10510   // Visits a handle that has an embedder-assigned class ID.
10511   virtual void VisitEmbedderReference(Object** p, uint16_t class_id) {}
10512
10513   // Intended for serialization/deserialization checking: insert, or
10514   // check for the presence of, a tag at this position in the stream.
10515   // Also used for marking up GC roots in heap snapshots.
10516   virtual void Synchronize(VisitorSynchronization::SyncTag tag) {}
10517 };
10518
10519
10520 class StructBodyDescriptor : public
10521   FlexibleBodyDescriptor<HeapObject::kHeaderSize> {
10522  public:
10523   static inline int SizeOf(Map* map, HeapObject* object) {
10524     return map->instance_size();
10525   }
10526 };
10527
10528
10529 // BooleanBit is a helper class for setting and getting a bit in an
10530 // integer or Smi.
10531 class BooleanBit : public AllStatic {
10532  public:
10533   static inline bool get(Smi* smi, int bit_position) {
10534     return get(smi->value(), bit_position);
10535   }
10536
10537   static inline bool get(int value, int bit_position) {
10538     return (value & (1 << bit_position)) != 0;
10539   }
10540
10541   static inline Smi* set(Smi* smi, int bit_position, bool v) {
10542     return Smi::FromInt(set(smi->value(), bit_position, v));
10543   }
10544
10545   static inline int set(int value, int bit_position, bool v) {
10546     if (v) {
10547       value |= (1 << bit_position);
10548     } else {
10549       value &= ~(1 << bit_position);
10550     }
10551     return value;
10552   }
10553 };
10554
10555 } }  // namespace v8::internal
10556
10557 #endif  // V8_OBJECTS_H_