1 // Copyright 2016 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_INSPECTOR_V8STACKTRACEIMPL_H_ 6 #define V8_INSPECTOR_V8STACKTRACEIMPL_H_ 7 8 #include <vector> 9 10 #include "src/base/macros.h" 11 #include "src/inspector/protocol/Forward.h" 12 #include "src/inspector/protocol/Runtime.h" 13 14 #include "include/v8-inspector.h" 15 16 namespace v8_inspector { 17 18 class TracedValue; 19 class V8Debugger; 20 21 // Note: async stack trace may have empty top stack with non-empty tail to 22 // indicate 23 // that current native-only state had some async story. 24 // On the other hand, any non-top async stack is guaranteed to be non-empty. 25 class V8StackTraceImpl final : public V8StackTrace { 26 public: 27 static const size_t maxCallStackSizeToCapture = 200; 28 29 class Frame { 30 public: 31 Frame(); 32 Frame(const String16& functionName, const String16& scriptId, 33 const String16& scriptName, int lineNumber, int column = 0); 34 ~Frame(); 35 functionName()36 const String16& functionName() const { return m_functionName; } scriptId()37 const String16& scriptId() const { return m_scriptId; } sourceURL()38 const String16& sourceURL() const { return m_scriptName; } lineNumber()39 int lineNumber() const { return m_lineNumber; } columnNumber()40 int columnNumber() const { return m_columnNumber; } 41 Frame clone() const; 42 43 private: 44 friend class V8StackTraceImpl; 45 std::unique_ptr<protocol::Runtime::CallFrame> buildInspectorObject() const; 46 void toTracedValue(TracedValue*) const; 47 48 String16 m_functionName; 49 String16 m_scriptId; 50 String16 m_scriptName; 51 int m_lineNumber; 52 int m_columnNumber; 53 }; 54 55 static void setCaptureStackTraceForUncaughtExceptions(v8::Isolate*, 56 bool capture); 57 static std::unique_ptr<V8StackTraceImpl> create( 58 V8Debugger*, int contextGroupId, v8::Local<v8::StackTrace>, 59 size_t maxStackSize, const String16& description = String16()); 60 static std::unique_ptr<V8StackTraceImpl> capture( 61 V8Debugger*, int contextGroupId, size_t maxStackSize, 62 const String16& description = String16()); 63 64 // This method drops the async chain. Use cloneImpl() instead. 65 std::unique_ptr<V8StackTrace> clone() override; 66 std::unique_ptr<V8StackTraceImpl> cloneImpl(); 67 std::unique_ptr<protocol::Runtime::StackTrace> buildInspectorObjectForTail( 68 V8Debugger*) const; 69 std::unique_ptr<protocol::Runtime::StackTrace> buildInspectorObjectImpl() 70 const; 71 ~V8StackTraceImpl() override; 72 73 // V8StackTrace implementation. isEmpty()74 bool isEmpty() const override { return !m_frames.size(); }; 75 StringView topSourceURL() const override; 76 int topLineNumber() const override; 77 int topColumnNumber() const override; 78 StringView topScriptId() const override; 79 StringView topFunctionName() const override; 80 std::unique_ptr<protocol::Runtime::API::StackTrace> buildInspectorObject() 81 const override; 82 std::unique_ptr<StringBuffer> toString() const override; 83 84 void setCreation(std::unique_ptr<V8StackTraceImpl> creation); 85 86 private: 87 V8StackTraceImpl(int contextGroupId, const String16& description, 88 std::vector<Frame>& frames, 89 std::unique_ptr<V8StackTraceImpl> parent); 90 91 int m_contextGroupId; 92 String16 m_description; 93 std::vector<Frame> m_frames; 94 std::unique_ptr<V8StackTraceImpl> m_parent; 95 std::unique_ptr<V8StackTraceImpl> m_creation; 96 97 DISALLOW_COPY_AND_ASSIGN(V8StackTraceImpl); 98 }; 99 100 } // namespace v8_inspector 101 102 #endif // V8_INSPECTOR_V8STACKTRACEIMPL_H_ 103