• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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