[DevTools] Split a part of V8Inspector into V8Debugger.

third_party/WebKit/Source/platform/v8_inspector/V8Debugger.h

+// Copyright 2016 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef V8Debugger_h
+#define V8Debugger_h
+
+#include "platform/inspector_protocol/Allocator.h"
+#include "platform/inspector_protocol/Maybe.h"
+#include "platform/inspector_protocol/Platform.h"
+#include "platform/v8_inspector/JavaScriptCallFrame.h"
+#include "platform/v8_inspector/V8DebuggerScript.h"
+#include "platform/v8_inspector/protocol/Runtime.h"
+#include "platform/v8_inspector/public/V8ContextInfo.h"
+
+#include <v8-debug.h>
+#include <v8.h>
+#include <vector>
+
+namespace blink {
+
+struct ScriptBreakpoint;
+class V8DebuggerAgentImpl;
+class V8InspectorImpl;
+class V8StackTraceImpl;
+
+class V8Debugger {
+    PROTOCOL_DISALLOW_COPY(V8Debugger);
+public:
+    V8Debugger(v8::Isolate*, V8InspectorImpl*);
+    ~V8Debugger();
+
+    static int contextId(v8::Local<v8::Context>);
+    static int getGroupId(v8::Local<v8::Context>);
+    int markContext(const V8ContextInfo&);
+
+    bool enabled() const;
+
+    String16 setBreakpoint(const String16& sourceID, const ScriptBreakpoint&, int* actualLineNumber, int* actualColumnNumber, bool interstatementLocation);
+    void removeBreakpoint(const String16& breakpointId);
+    void setBreakpointsActivated(bool);
+    bool breakpointsActivated() const { return m_breakpointsActivated; }
+
+    enum PauseOnExceptionsState {
+        DontPauseOnExceptions,
+        PauseOnAllExceptions,
+        PauseOnUncaughtExceptions
+    };
+    PauseOnExceptionsState getPauseOnExceptionsState();
+    void setPauseOnExceptionsState(PauseOnExceptionsState);
+    void setPauseOnNextStatement(bool);
+    bool canBreakProgram();
+    void breakProgram();
+    void continueProgram();
+    void stepIntoStatement();
+    void stepOverStatement();
+    void stepOutOfFunction();
+    void clearStepping();
+
+    bool setScriptSource(const String16& sourceID, v8::Local<v8::String> newSource, bool preview, ErrorString*, protocol::Maybe<protocol::Runtime::ExceptionDetails>*, JavaScriptCallFrames* newCallFrames, protocol::Maybe<bool>* stackChanged);
+    JavaScriptCallFrames currentCallFrames(int limit = 0);
+
+    // Each script inherits debug data from v8::Context where it has been compiled.
+    // Only scripts whose debug data matches |contextGroupId| will be reported.
+    // Passing 0 will result in reporting all scripts.
+    void getCompiledScripts(int contextGroupId, std::vector<std::unique_ptr<V8DebuggerScript>>&);
+    void enable();
+    void disable();
+
+    bool isPaused();
+    v8::Local<v8::Context> pausedContext() { return m_pausedContext; }
+
+    int maxAsyncCallChainDepth() { return m_maxAsyncCallStackDepth; }
+    V8StackTraceImpl* currentAsyncCallChain();
+    void setAsyncCallStackDepth(V8DebuggerAgentImpl*, int);
+    std::unique_ptr<V8StackTraceImpl> createStackTrace(v8::Local<v8::StackTrace>);
+    std::unique_ptr<V8StackTraceImpl> captureStackTrace(bool fullStack);
+
+    v8::MaybeLocal<v8::Value> functionScopes(v8::Local<v8::Function>);
+    v8::MaybeLocal<v8::Array> internalProperties(v8::Local<v8::Context>, v8::Local<v8::Value>);
+
+    void asyncTaskScheduled(const String16& taskName, void* task, bool recurring);
+    void asyncTaskCanceled(void* task);
+    void asyncTaskStarted(void* task);
+    void asyncTaskFinished(void* task);
+    void allAsyncTasksCanceled();
+
+private:
+    void compileDebuggerScript();
+    v8::MaybeLocal<v8::Value> callDebuggerMethod(const char* functionName, int argc, v8::Local<v8::Value> argv[]);
+    v8::Local<v8::Context> debuggerContext() const;
+    void clearBreakpoints();
+
+    static void breakProgramCallback(const v8::FunctionCallbackInfo<v8::Value>&);
+    void handleProgramBreak(v8::Local<v8::Context> pausedContext, v8::Local<v8::Object> executionState, v8::Local<v8::Value> exception, v8::Local<v8::Array> hitBreakpoints, bool isPromiseRejection = false);
+    static void v8DebugEventCallback(const v8::Debug::EventDetails&);
+    v8::Local<v8::Value> callInternalGetterFunction(v8::Local<v8::Object>, const char* functionName);
+    void handleV8DebugEvent(const v8::Debug::EventDetails&);
+    void handleV8AsyncTaskEvent(v8::Local<v8::Context>, v8::Local<v8::Object> executionState, v8::Local<v8::Object> eventData);
+
+    v8::Local<v8::Value> collectionEntries(v8::Local<v8::Context>, v8::Local<v8::Object>);
+    v8::Local<v8::Value> generatorObjectLocation(v8::Local<v8::Object>);
+    v8::Local<v8::Value> functionLocation(v8::Local<v8::Context>, v8::Local<v8::Function>);
+
+    v8::Isolate* m_isolate;
+    V8InspectorImpl* m_inspector;
+    int m_lastContextId;
+    int m_enableCount;
+    bool m_breakpointsActivated;
+    v8::Global<v8::Object> m_debuggerScript;
+    v8::Global<v8::Context> m_debuggerContext;
+    v8::Local<v8::Object> m_executionState;
+    v8::Local<v8::Context> m_pausedContext;
+    bool m_runningNestedMessageLoop;
+
+    using AsyncTaskToStackTrace = protocol::HashMap<void*, std::unique_ptr<V8StackTraceImpl>>;
+    AsyncTaskToStackTrace m_asyncTaskStacks;
+    protocol::HashSet<void*> m_recurringTasks;
+    int m_maxAsyncCallStackDepth;
+    std::vector<void*> m_currentTasks;
+    std::vector<std::unique_ptr<V8StackTraceImpl>> m_currentStacks;
+    protocol::HashMap<V8DebuggerAgentImpl*, int> m_maxAsyncCallStackDepthMap;
+};
+
+} // namespace blink
+
+#endif // V8Debugger_h