1 // Copyright 2017 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_FRAME_ARRAY_H_ 6 #define V8_OBJECTS_FRAME_ARRAY_H_ 7 8 #include "src/objects/objects.h" 9 #include "src/wasm/wasm-objects.h" 10 11 // Has to be the last include (doesn't have include guards): 12 #include "src/objects/object-macros.h" 13 14 namespace v8 { 15 namespace internal { 16 17 template <typename T> 18 class Handle; 19 20 #define FRAME_ARRAY_FIELD_LIST(V) \ 21 V(WasmInstance, WasmInstanceObject) \ 22 V(WasmFunctionIndex, Smi) \ 23 V(WasmCodeObject, Object) \ 24 V(Receiver, Object) \ 25 V(Function, JSFunction) \ 26 V(Code, AbstractCode) \ 27 V(Offset, Smi) \ 28 V(Flags, Smi) \ 29 V(Parameters, FixedArray) 30 31 // Container object for data collected during simple stack trace captures. 32 class FrameArray : public FixedArray { 33 public: 34 #define DECL_FRAME_ARRAY_ACCESSORS(name, type) \ 35 inline type name(int frame_ix) const; \ 36 inline void Set##name(int frame_ix, type value); 37 FRAME_ARRAY_FIELD_LIST(DECL_FRAME_ARRAY_ACCESSORS) 38 #undef DECL_FRAME_ARRAY_ACCESSORS 39 40 inline bool IsWasmFrame(int frame_ix) const; 41 inline bool IsAsmJsWasmFrame(int frame_ix) const; 42 inline bool IsAnyWasmFrame(int frame_ix) const; 43 inline int FrameCount() const; 44 45 void ShrinkToFit(Isolate* isolate); 46 47 // Flags. 48 enum Flag { 49 kIsWasmFrame = 1 << 0, 50 kIsAsmJsWasmFrame = 1 << 1, 51 kIsStrict = 1 << 2, 52 kIsConstructor = 1 << 3, 53 kAsmJsAtNumberConversion = 1 << 4, 54 kIsAsync = 1 << 5, 55 kIsPromiseAll = 1 << 6, 56 kIsPromiseAny = 1 << 7 57 }; 58 59 static Handle<FrameArray> AppendJSFrame(Handle<FrameArray> in, 60 Handle<Object> receiver, 61 Handle<JSFunction> function, 62 Handle<AbstractCode> code, int offset, 63 int flags, 64 Handle<FixedArray> parameters); 65 static Handle<FrameArray> AppendWasmFrame( 66 Handle<FrameArray> in, Handle<WasmInstanceObject> wasm_instance, 67 int wasm_function_index, wasm::WasmCode* code, int offset, int flags); 68 69 DECL_CAST(FrameArray) 70 71 private: 72 // The underlying fixed array embodies a captured stack trace. Frame i 73 // occupies indices 74 // 75 // kFirstIndex + 1 + [i * kElementsPerFrame, (i + 1) * kElementsPerFrame[, 76 // 77 // with internal offsets as below: 78 79 static const int kWasmInstanceOffset = 0; 80 static const int kWasmFunctionIndexOffset = 1; 81 static const int kWasmCodeObjectOffset = 2; 82 83 static const int kReceiverOffset = 0; 84 static const int kFunctionOffset = 1; 85 86 static const int kCodeOffset = 2; 87 static const int kOffsetOffset = 3; 88 89 static const int kFlagsOffset = 4; 90 91 static const int kParametersOffset = 5; 92 93 static const int kElementsPerFrame = 6; 94 95 // Array layout indices. 96 97 static const int kFrameCountIndex = 0; 98 static const int kFirstIndex = 1; 99 LengthFor(int frame_count)100 static int LengthFor(int frame_count) { 101 return kFirstIndex + frame_count * kElementsPerFrame; 102 } 103 104 static Handle<FrameArray> EnsureSpace(Isolate* isolate, 105 Handle<FrameArray> array, int length); 106 107 friend class Factory; 108 OBJECT_CONSTRUCTORS(FrameArray, FixedArray); 109 }; 110 111 } // namespace internal 112 } // namespace v8 113 114 #include "src/objects/object-macros-undef.h" 115 116 #endif // V8_OBJECTS_FRAME_ARRAY_H_ 117