Loading...
Searching...
No Matches
v8-inspector.h
Go to the documentation of this file.
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_V8_INSPECTOR_H_
6#define V8_V8_INSPECTOR_H_
7
8#include <stdint.h>
9
10#include <cctype>
11#include <map>
12#include <memory>
13#include <optional>
14#include <string>
15
16#include "cppgc/garbage-collected.h" // NOLINT(build/include_directory)
17#include "v8-isolate.h" // NOLINT(build/include_directory)
18#include "v8-local-handle.h" // NOLINT(build/include_directory)
19
20namespace v8 {
21class Context;
22class Name;
23class Object;
24class StackTrace;
25class Value;
26} // namespace v8
27
28namespace v8_inspector {
29
30namespace internal {
31class V8DebuggerId;
32} // namespace internal
33
34namespace protocol {
35namespace Debugger {
36namespace API {
37class SearchMatch;
38}
39} // namespace Debugger
40namespace Runtime {
41namespace API {
42class RemoteObject;
43class StackTrace;
44class StackTraceId;
45} // namespace API
46} // namespace Runtime
47namespace Schema {
48namespace API {
49class Domain;
50}
51} // namespace Schema
52} // namespace protocol
53
55 public:
56 StringView() : m_is8Bit(true), m_length(0), m_characters8(nullptr) {}
57
58 StringView(const uint8_t* characters, size_t length)
59 : m_is8Bit(true), m_length(length), m_characters8(characters) {}
60
61 StringView(const uint16_t* characters, size_t length)
62 : m_is8Bit(false), m_length(length), m_characters16(characters) {}
63
64 bool is8Bit() const { return m_is8Bit; }
65 size_t length() const { return m_length; }
66
67 // TODO(dgozman): add DCHECK(m_is8Bit) to accessors once platform can be used
68 // here.
69 const uint8_t* characters8() const { return m_characters8; }
70 const uint16_t* characters16() const { return m_characters16; }
71
72 private:
73 bool m_is8Bit;
74 size_t m_length;
75 union {
76 const uint8_t* m_characters8;
77 const uint16_t* m_characters16;
78 };
79};
80
82 public:
83 virtual ~StringBuffer() = default;
84 virtual StringView string() const = 0;
85 // This method copies contents.
86 static std::unique_ptr<StringBuffer> create(StringView);
87};
88
90 public:
91 V8ContextInfo(v8::Local<v8::Context> context, int contextGroupId,
92 StringView humanReadableName)
93 : context(context),
94 contextGroupId(contextGroupId),
95 humanReadableName(humanReadableName),
96 hasMemoryOnConsole(false) {}
97
99 // Each v8::Context is a part of a group. The group id must be non-zero.
105
107
108 // Disallow copying and allocating this one.
109 enum NotNullTagEnum { NotNullLiteral };
110 void* operator new(size_t) = delete;
111 void* operator new(size_t, NotNullTagEnum, void*) = delete;
112 void* operator new(size_t, void*) = delete;
113 V8ContextInfo(const V8ContextInfo&) = delete;
115};
116
117// This debugger id tries to be unique by generating two random
118// numbers, which should most likely avoid collisions.
119// Debugger id has a 1:1 mapping to context group. It is used to
120// attribute stack traces to a particular debugging, when doing any
121// cross-debugger operations (e.g. async step in).
122// See also Runtime.UniqueDebuggerId in the protocol.
124 public:
125 V8DebuggerId() = default;
126 V8DebuggerId(const V8DebuggerId&) = default;
128
129 std::unique_ptr<StringBuffer> toString() const;
130 bool isValid() const;
131 std::pair<int64_t, int64_t> pair() const;
132
133 private:
134 friend class internal::V8DebuggerId;
135 explicit V8DebuggerId(std::pair<int64_t, int64_t>);
136
137 int64_t m_first = 0;
138 int64_t m_second = 0;
139};
140
147};
148
150 public:
152 virtual bool isEmpty() const = 0;
153 virtual StringView topSourceURL() const = 0;
154 virtual int topLineNumber() const = 0;
155 virtual int topColumnNumber() const = 0;
156 virtual int topScriptId() const = 0;
157 virtual StringView topFunctionName() const = 0;
158 // Returns true if the script of the top frame was compiled with
159 // resource_is_opaque set in its ScriptOrigin (code created via eval or
160 // new Function inherits this from the calling script). Like the other
161 // top*() accessors, this must only be called if !isEmpty().
162 virtual bool isTopScriptOpaque() const = 0;
163
164 virtual ~V8StackTrace() = default;
165 virtual std::unique_ptr<protocol::Runtime::API::StackTrace>
166 buildInspectorObject(int maxAsyncDepth) const = 0;
167 virtual std::unique_ptr<StringBuffer> toString() const = 0;
168
169 // Safe to pass between threads, drops async chain.
170 virtual std::unique_ptr<V8StackTrace> clone() = 0;
171
172 virtual std::vector<V8StackFrame> frames() const = 0;
173};
174
176 public:
177 virtual ~V8InspectorSession() = default;
178
179 // Cross-context inspectable values (DOM nodes in different worlds, etc.).
181 public:
183 virtual ~Inspectable() = default;
184 };
185 virtual void addInspectedObject(std::unique_ptr<Inspectable>) = 0;
186
187 // Dispatching protocol messages.
188 static bool canDispatchMethod(StringView method);
190 StringView associated_data = {}) = 0;
191 virtual std::vector<uint8_t> state() = 0;
192 virtual std::vector<std::unique_ptr<protocol::Schema::API::Domain>>
194
195 // Debugger actions.
196 virtual void schedulePauseOnNextStatement(StringView breakReason,
197 StringView breakDetails) = 0;
198 virtual void cancelPauseOnNextStatement() = 0;
199 virtual void breakProgram(StringView breakReason,
200 StringView breakDetails) = 0;
201 virtual void setSkipAllPauses(bool) = 0;
202 // Temporarily overrides the protocol setting without changing session state.
203 virtual void setSkipAllPausesForInternalUse(bool) = 0;
204 virtual void resume(bool setTerminateOnResume = false) = 0;
205 virtual void stepOver() = 0;
206 virtual std::vector<std::unique_ptr<protocol::Debugger::API::SearchMatch>>
207 searchInTextByLines(StringView text, StringView query, bool caseSensitive,
208 bool isRegex) = 0;
209
210 // Remote objects.
211 virtual std::unique_ptr<protocol::Runtime::API::RemoteObject> wrapObject(
213 bool generatePreview) = 0;
214
215 virtual bool unwrapObject(std::unique_ptr<StringBuffer>* error,
218 std::unique_ptr<StringBuffer>* objectGroup) = 0;
221
223 enum class ResultType {
224 kNotRun,
225 kSuccess,
226 kException,
227 };
228
231 };
232 // Evalaute 'expression' in the provided context. Does the same as
233 // Runtime#evaluate under-the-hood but exposed on the C++ side.
235 StringView expression,
236 bool includeCommandLineAPI = false) = 0;
237
238 // Prepare for shutdown (disables debugger pausing, etc.).
239 virtual void stop() = 0;
240};
241
243 explicit DeepSerializedValue(std::unique_ptr<StringBuffer> type,
244 v8::MaybeLocal<v8::Value> value = {})
245 : type(std::move(type)), value(value) {}
246 std::unique_ptr<StringBuffer> type;
248};
249
252 std::unique_ptr<DeepSerializedValue> serializedValue)
253 : serializedValue(std::move(serializedValue)), isSuccess(true) {}
254 explicit DeepSerializationResult(std::unique_ptr<StringBuffer> errorMessage)
255 : errorMessage(std::move(errorMessage)), isSuccess(false) {}
256
257 // Use std::variant when available.
258 std::unique_ptr<DeepSerializedValue> serializedValue;
259 std::unique_ptr<StringBuffer> errorMessage;
261};
262
264 public:
265 virtual ~V8InspectorClient() = default;
266
267 virtual void runMessageLoopOnPause(int contextGroupId) {}
268 virtual void runMessageLoopOnInstrumentationPause(int contextGroupId) {
269 runMessageLoopOnPause(contextGroupId);
270 }
271 virtual void quitMessageLoopOnPause() {}
272 virtual void runIfWaitingForDebugger(int contextGroupId) {}
273
274 virtual void muteMetrics(int contextGroupId) {}
275 virtual void unmuteMetrics(int contextGroupId) {}
276
277 virtual void beginUserGesture() {}
278 virtual void endUserGesture() {}
279
280 virtual std::unique_ptr<DeepSerializationResult> deepSerialize(
281 v8::Local<v8::Value> v8Value, int maxDepth,
282 v8::Local<v8::Object> additionalParameters) {
283 return nullptr;
284 }
285 virtual std::unique_ptr<StringBuffer> valueSubtype(v8::Local<v8::Value>) {
286 return nullptr;
287 }
288 virtual std::unique_ptr<StringBuffer> descriptionForValueSubtype(
290 return nullptr;
291 }
292 virtual bool isInspectableHeapObject(v8::Local<v8::Object>) { return true; }
293
295 int contextGroupId) {
296 return v8::Local<v8::Context>();
297 }
298 virtual void beginEnsureAllContextsInGroup(int contextGroupId) {}
299 virtual void endEnsureAllContextsInGroup(int contextGroupId) {}
300
303 // Deprecated. Use version with contextId.
304 virtual void consoleAPIMessage(int contextGroupId,
306 const StringView& message,
307 const StringView& url, unsigned lineNumber,
308 unsigned columnNumber, V8StackTrace*) {}
309 virtual void consoleAPIMessage(int contextGroupId, int contextId,
311 const StringView& message,
312 const StringView& url, unsigned lineNumber,
313 unsigned columnNumber,
314 V8StackTrace* stackTrace) {
315 consoleAPIMessage(contextGroupId, level, message, url, lineNumber,
316 columnNumber, stackTrace);
317 }
321 }
322
323 virtual void consoleTime(v8::Isolate* isolate, v8::Local<v8::String> label) {}
324 virtual void consoleTimeEnd(v8::Isolate* isolate,
325 v8::Local<v8::String> label) {}
326 virtual void consoleTimeStamp(v8::Isolate* isolate,
327 v8::Local<v8::String> label) {}
329 v8::Isolate* isolate, v8::Local<v8::String> label,
330 const v8::LocalVector<v8::Value>& args) {}
331 virtual void consoleClear(int contextGroupId) {}
332 virtual double currentTimeMS() { return 0; }
333 typedef void (*TimerCallback)(void*);
334 virtual void startRepeatingTimer(double, TimerCallback, void* data) {}
335 virtual void cancelTimer(void* data) {}
336
337 virtual bool canExecuteScripts(int contextGroupId) { return true; }
338
339 virtual void maxAsyncCallStackDepthChanged(int depth) {}
340
341 virtual std::unique_ptr<StringBuffer> resourceNameToUrl(
342 const StringView& resourceName) {
343 return nullptr;
344 }
345
346 // The caller would defer to generating a random 64 bit integer if
347 // this method returns 0.
348 virtual int64_t generateUniqueId() { return 0; }
349
352};
353
354// These stack trace ids are intended to be passed between debuggers and be
355// resolved later. This allows to track cross-debugger calls and step between
356// them if a single client connects to multiple debuggers.
358 uintptr_t id;
359 std::pair<int64_t, int64_t> debugger_id;
360 bool should_pause = false;
361
364 V8StackTraceId(uintptr_t id, const std::pair<int64_t, int64_t> debugger_id);
365 V8StackTraceId(uintptr_t id, const std::pair<int64_t, int64_t> debugger_id,
366 bool should_pause);
370 ~V8StackTraceId() = default;
371
372 bool IsInvalid() const;
373 std::unique_ptr<StringBuffer> ToString();
374};
375
379 std::optional<int> columnNumber;
380
381 enum SelectorType { kUrl, kUrlRegex, kScriptHash };
384
386};
387
389 std::vector<V8URLBreakpoint> urlBreakpoints;
390};
391
393 public:
394 static std::unique_ptr<V8Inspector> create(v8::Isolate*, V8InspectorClient*);
395 virtual ~V8Inspector() = default;
396
397 // Contexts instrumentation.
398 virtual void contextCreated(const V8ContextInfo&) = 0;
400 virtual void resetContextGroup(int contextGroupId) = 0;
401 virtual v8::MaybeLocal<v8::Context> contextById(int contextId) = 0;
402 virtual V8DebuggerId uniqueDebuggerId(int contextId) = 0;
403 virtual uint64_t isolateId() = 0;
404
405 // Various instrumentation.
406 virtual void idleStarted() = 0;
407 virtual void idleFinished() = 0;
408
409 // Async stack traces instrumentation.
410 virtual void asyncTaskScheduled(StringView taskName, void* task,
411 bool recurring) = 0;
412 virtual void asyncTaskCanceled(void* task) = 0;
413 virtual void asyncTaskStarted(void* task) = 0;
414 virtual void asyncTaskFinished(void* task) = 0;
415 virtual void allAsyncTasksCanceled() = 0;
416
418 virtual void externalAsyncTaskStarted(const V8StackTraceId& parent) = 0;
419 virtual void externalAsyncTaskFinished(const V8StackTraceId& parent) = 0;
420
421 // Exceptions instrumentation.
423 v8::Local<v8::Value> exception,
424 StringView detailedMessage, StringView url,
425 unsigned lineNumber, unsigned columnNumber,
426 std::unique_ptr<V8StackTrace>,
427 int scriptId) = 0;
428 virtual void exceptionRevoked(v8::Local<v8::Context>, unsigned exceptionId,
429 StringView message) = 0;
431 v8::Local<v8::Value> exception,
433 v8::Local<v8::Value> value) = 0;
434
435 // Connection.
437 public:
438 virtual ~Channel() = default;
439 virtual void sendResponse(int callId,
440 std::unique_ptr<StringBuffer> message) = 0;
441 virtual void sendNotification(std::unique_ptr<StringBuffer> message) = 0;
442 virtual void flushProtocolNotifications() = 0;
443 };
444
446 : public cppgc::GarbageCollected<ManagedChannel> {
447 public:
448 virtual ~ManagedChannel() = default;
449 virtual void sendResponse(int callId,
450 std::unique_ptr<StringBuffer> message) = 0;
451 virtual void sendNotification(std::unique_ptr<StringBuffer> message) = 0;
452 virtual void flushProtocolNotifications() = 0;
453 virtual void Trace(cppgc::Visitor* visitor) const {}
454 };
455
456 enum ClientTrustLevel { kUntrusted, kFullyTrusted };
457 enum SessionPauseState { kWaitingForDebugger, kNotWaitingForDebugger };
458 // Deprecated: Use `connectShared` instead.
459 // Channel is owned by the embedder. Ensure to keep it alive as long as the
460 // returned session is alive.
461 virtual std::unique_ptr<V8InspectorSession> connect(
462 int contextGroupId, Channel*, StringView state,
463 ClientTrustLevel client_trust_level,
464 SessionPauseState = kNotWaitingForDebugger) = 0;
465
466 // Same as `connect` but returns a std::shared_ptr instead.
467 // Embedders should not deconstruct V8 sessions while the nested run loop
468 // (V8InspectorClient::runMessageLoopOnPause) is running. To partially ensure
469 // this, we defer session deconstruction until no "dispatchProtocolMessages"
470 // remains on the stack.
471 // Channel is owned by the embedder. Ensure to keep it alive as long as the
472 // returned session is alive.
473 virtual std::shared_ptr<V8InspectorSession> connectShared(
474 int contextGroupId, Channel* channel, StringView state,
475 ClientTrustLevel clientTrustLevel, SessionPauseState pauseState) = 0;
476
477 // Same as `connectShared` but takes a `ManagedChannel` instead. The session
478 // will take a cppgc::Persistent on the ManagedChannel so the embedder doesn't
479 // have to worry about the life-time of `channel`.
480 virtual std::shared_ptr<V8InspectorSession> connectShared(
481 int contextGroupId, ManagedChannel* channel, StringView state,
482 ClientTrustLevel clientTrustLevel, SessionPauseState pauseState,
483 V8EmbedderState = {}) = 0;
484
485 // API methods.
486 virtual std::unique_ptr<V8StackTrace> createStackTrace(
488 virtual std::unique_ptr<V8StackTrace> captureStackTrace(bool fullStack) = 0;
489};
490
491} // namespace v8_inspector
492
493#endif // V8_V8_INSPECTOR_H_
Definition: garbage-collected.h:53
Definition: visitor.h:78
Definition: v8-isolate.h:305
MessageErrorLevel
Definition: v8-isolate.h:695
Definition: v8-local-handle.h:584
Definition: v8-local-handle.h:356
Definition: v8-local-handle.h:724
Definition: v8-inspector.h:81
virtual ~StringBuffer()=default
virtual StringView string() const =0
static std::unique_ptr< StringBuffer > create(StringView)
Definition: v8-inspector.h:54
const uint8_t * m_characters8
Definition: v8-inspector.h:76
size_t length() const
Definition: v8-inspector.h:65
StringView()
Definition: v8-inspector.h:56
const uint8_t * characters8() const
Definition: v8-inspector.h:69
const uint16_t * characters16() const
Definition: v8-inspector.h:70
StringView(const uint8_t *characters, size_t length)
Definition: v8-inspector.h:58
bool is8Bit() const
Definition: v8-inspector.h:64
StringView(const uint16_t *characters, size_t length)
Definition: v8-inspector.h:61
const uint16_t * m_characters16
Definition: v8-inspector.h:77
Definition: v8-inspector.h:89
v8::Local< v8::Context > context
Definition: v8-inspector.h:98
V8ContextInfo(const V8ContextInfo &)=delete
bool hasMemoryOnConsole
Definition: v8-inspector.h:104
StringView humanReadableName
Definition: v8-inspector.h:101
int contextGroupId
Definition: v8-inspector.h:100
V8ContextInfo & operator=(const V8ContextInfo &)=delete
static int executionContextId(v8::Local< v8::Context > context)
V8ContextInfo(v8::Local< v8::Context > context, int contextGroupId, StringView humanReadableName)
Definition: v8-inspector.h:91
StringView origin
Definition: v8-inspector.h:102
StringView auxData
Definition: v8-inspector.h:103
NotNullTagEnum
Definition: v8-inspector.h:109
Definition: v8-inspector.h:123
std::unique_ptr< StringBuffer > toString() const
std::pair< int64_t, int64_t > pair() const
V8DebuggerId(const V8DebuggerId &)=default
V8DebuggerId & operator=(const V8DebuggerId &)=default
Definition: v8-inspector.h:263
virtual void beginEnsureAllContextsInGroup(int contextGroupId)
Definition: v8-inspector.h:298
virtual void consoleClear(int contextGroupId)
Definition: v8-inspector.h:331
virtual bool isInspectableHeapObject(v8::Local< v8::Object >)
Definition: v8-inspector.h:292
virtual std::unique_ptr< StringBuffer > descriptionForValueSubtype(v8::Local< v8::Context >, v8::Local< v8::Value >)
Definition: v8-inspector.h:288
virtual void endUserGesture()
Definition: v8-inspector.h:278
virtual ~V8InspectorClient()=default
virtual void unmuteMetrics(int contextGroupId)
Definition: v8-inspector.h:275
virtual void startRepeatingTimer(double, TimerCallback, void *data)
Definition: v8-inspector.h:334
virtual void muteMetrics(int contextGroupId)
Definition: v8-inspector.h:274
virtual v8::Local< v8::Context > ensureDefaultContextInGroup(int contextGroupId)
Definition: v8-inspector.h:294
virtual void runIfWaitingForDebugger(int contextGroupId)
Definition: v8-inspector.h:272
virtual void consoleTimeStamp(v8::Isolate *isolate, v8::Local< v8::String > label)
Definition: v8-inspector.h:326
virtual void consoleAPIMessage(int contextGroupId, int contextId, v8::Isolate::MessageErrorLevel level, const StringView &message, const StringView &url, unsigned lineNumber, unsigned columnNumber, V8StackTrace *stackTrace)
Definition: v8-inspector.h:309
virtual void consoleTime(v8::Isolate *isolate, v8::Local< v8::String > label)
Definition: v8-inspector.h:323
virtual bool canExecuteScripts(int contextGroupId)
Definition: v8-inspector.h:337
virtual void dispatchError(v8::Local< v8::Context >, v8::Local< v8::Message >, v8::Local< v8::Value >)
Definition: v8-inspector.h:350
virtual void beginUserGesture()
Definition: v8-inspector.h:277
virtual void consoleTimeEnd(v8::Isolate *isolate, v8::Local< v8::String > label)
Definition: v8-inspector.h:324
virtual v8::MaybeLocal< v8::Value > memoryInfo(v8::Isolate *, v8::Local< v8::Context >)
Definition: v8-inspector.h:318
virtual std::unique_ptr< StringBuffer > valueSubtype(v8::Local< v8::Value >)
Definition: v8-inspector.h:285
virtual double currentTimeMS()
Definition: v8-inspector.h:332
virtual void consoleAPIMessage(int contextGroupId, v8::Isolate::MessageErrorLevel level, const StringView &message, const StringView &url, unsigned lineNumber, unsigned columnNumber, V8StackTrace *)
Definition: v8-inspector.h:304
virtual void installAdditionalCommandLineAPI(v8::Local< v8::Context >, v8::Local< v8::Object >)
Definition: v8-inspector.h:301
virtual void consoleTimeStampWithArgs(v8::Isolate *isolate, v8::Local< v8::String > label, const v8::LocalVector< v8::Value > &args)
Definition: v8-inspector.h:328
virtual std::unique_ptr< DeepSerializationResult > deepSerialize(v8::Local< v8::Value > v8Value, int maxDepth, v8::Local< v8::Object > additionalParameters)
Definition: v8-inspector.h:280
virtual int64_t generateUniqueId()
Definition: v8-inspector.h:348
virtual void runMessageLoopOnPause(int contextGroupId)
Definition: v8-inspector.h:267
virtual void runMessageLoopOnInstrumentationPause(int contextGroupId)
Definition: v8-inspector.h:268
virtual void quitMessageLoopOnPause()
Definition: v8-inspector.h:271
virtual std::unique_ptr< StringBuffer > resourceNameToUrl(const StringView &resourceName)
Definition: v8-inspector.h:341
virtual void cancelTimer(void *data)
Definition: v8-inspector.h:335
virtual void maxAsyncCallStackDepthChanged(int depth)
Definition: v8-inspector.h:339
virtual void endEnsureAllContextsInGroup(int contextGroupId)
Definition: v8-inspector.h:299
Definition: v8-inspector.h:180
virtual v8::Local< v8::Value > get(v8::Local< v8::Context >)=0
Definition: v8-inspector.h:175
virtual void releaseObjectGroup(StringView)=0
virtual std::vector< std::unique_ptr< protocol::Schema::API::Domain > > supportedDomains()=0
static bool canDispatchMethod(StringView method)
virtual bool unwrapObject(std::unique_ptr< StringBuffer > *error, StringView objectId, v8::Local< v8::Value > *, v8::Local< v8::Context > *, std::unique_ptr< StringBuffer > *objectGroup)=0
virtual void addInspectedObject(std::unique_ptr< Inspectable >)=0
virtual void setSkipAllPausesForInternalUse(bool)=0
virtual void breakProgram(StringView breakReason, StringView breakDetails)=0
virtual std::unique_ptr< protocol::Runtime::API::RemoteObject > wrapObject(v8::Local< v8::Context >, v8::Local< v8::Value >, StringView groupName, bool generatePreview)=0
virtual void triggerPreciseCoverageDeltaUpdate(StringView occasion)=0
virtual ~V8InspectorSession()=default
virtual std::vector< std::unique_ptr< protocol::Debugger::API::SearchMatch > > searchInTextByLines(StringView text, StringView query, bool caseSensitive, bool isRegex)=0
virtual void schedulePauseOnNextStatement(StringView breakReason, StringView breakDetails)=0
virtual void dispatchProtocolMessage(StringView message, StringView associated_data={})=0
virtual void cancelPauseOnNextStatement()=0
virtual EvaluateResult evaluate(v8::Local< v8::Context > context, StringView expression, bool includeCommandLineAPI=false)=0
virtual void setSkipAllPauses(bool)=0
virtual std::vector< uint8_t > state()=0
virtual void resume(bool setTerminateOnResume=false)=0
Definition: v8-inspector.h:436
virtual void sendNotification(std::unique_ptr< StringBuffer > message)=0
virtual void flushProtocolNotifications()=0
virtual void sendResponse(int callId, std::unique_ptr< StringBuffer > message)=0
Definition: v8-inspector.h:446
virtual void Trace(cppgc::Visitor *visitor) const
Definition: v8-inspector.h:453
virtual void sendNotification(std::unique_ptr< StringBuffer > message)=0
virtual void sendResponse(int callId, std::unique_ptr< StringBuffer > message)=0
Definition: v8-inspector.h:392
virtual void externalAsyncTaskFinished(const V8StackTraceId &parent)=0
virtual void asyncTaskStarted(void *task)=0
static std::unique_ptr< V8Inspector > create(v8::Isolate *, V8InspectorClient *)
virtual unsigned exceptionThrown(v8::Local< v8::Context >, StringView message, v8::Local< v8::Value > exception, StringView detailedMessage, StringView url, unsigned lineNumber, unsigned columnNumber, std::unique_ptr< V8StackTrace >, int scriptId)=0
virtual void contextCreated(const V8ContextInfo &)=0
virtual void allAsyncTasksCanceled()=0
virtual std::shared_ptr< V8InspectorSession > connectShared(int contextGroupId, Channel *channel, StringView state, ClientTrustLevel clientTrustLevel, SessionPauseState pauseState)=0
virtual uint64_t isolateId()=0
virtual ~V8Inspector()=default
virtual V8StackTraceId storeCurrentStackTrace(StringView description)=0
virtual void contextDestroyed(v8::Local< v8::Context >)=0
virtual v8::MaybeLocal< v8::Context > contextById(int contextId)=0
virtual void idleFinished()=0
virtual bool associateExceptionData(v8::Local< v8::Context >, v8::Local< v8::Value > exception, v8::Local< v8::Name > key, v8::Local< v8::Value > value)=0
virtual std::unique_ptr< V8InspectorSession > connect(int contextGroupId, Channel *, StringView state, ClientTrustLevel client_trust_level, SessionPauseState=kNotWaitingForDebugger)=0
virtual void asyncTaskScheduled(StringView taskName, void *task, bool recurring)=0
virtual void idleStarted()=0
virtual void asyncTaskFinished(void *task)=0
SessionPauseState
Definition: v8-inspector.h:457
virtual void resetContextGroup(int contextGroupId)=0
virtual void exceptionRevoked(v8::Local< v8::Context >, unsigned exceptionId, StringView message)=0
virtual std::unique_ptr< V8StackTrace > captureStackTrace(bool fullStack)=0
ClientTrustLevel
Definition: v8-inspector.h:456
virtual void asyncTaskCanceled(void *task)=0
virtual V8DebuggerId uniqueDebuggerId(int contextId)=0
virtual std::shared_ptr< V8InspectorSession > connectShared(int contextGroupId, ManagedChannel *channel, StringView state, ClientTrustLevel clientTrustLevel, SessionPauseState pauseState, V8EmbedderState={})=0
virtual std::unique_ptr< V8StackTrace > createStackTrace(v8::Local< v8::StackTrace >)=0
virtual void externalAsyncTaskStarted(const V8StackTraceId &parent)=0
Definition: v8-inspector.h:149
virtual StringView topFunctionName() const =0
virtual std::unique_ptr< V8StackTrace > clone()=0
virtual int topLineNumber() const =0
virtual StringView firstNonEmptySourceURL() const =0
virtual std::unique_ptr< protocol::Runtime::API::StackTrace > buildInspectorObject(int maxAsyncDepth) const =0
virtual StringView topSourceURL() const =0
virtual bool isTopScriptOpaque() const =0
virtual std::unique_ptr< StringBuffer > toString() const =0
virtual int topColumnNumber() const =0
virtual bool isEmpty() const =0
virtual ~V8StackTrace()=default
virtual int topScriptId() const =0
virtual std::vector< V8StackFrame > frames() const =0
Definition: v8-inspector.h:28
Definition: libplatform.h:15
Definition: v8-inspector.h:250
std::unique_ptr< DeepSerializedValue > serializedValue
Definition: v8-inspector.h:258
bool isSuccess
Definition: v8-inspector.h:260
std::unique_ptr< StringBuffer > errorMessage
Definition: v8-inspector.h:259
DeepSerializationResult(std::unique_ptr< DeepSerializedValue > serializedValue)
Definition: v8-inspector.h:251
DeepSerializationResult(std::unique_ptr< StringBuffer > errorMessage)
Definition: v8-inspector.h:254
Definition: v8-inspector.h:242
DeepSerializedValue(std::unique_ptr< StringBuffer > type, v8::MaybeLocal< v8::Value > value={})
Definition: v8-inspector.h:243
std::unique_ptr< StringBuffer > type
Definition: v8-inspector.h:246
v8::MaybeLocal< v8::Value > value
Definition: v8-inspector.h:247
Definition: v8-inspector.h:388
std::vector< V8URLBreakpoint > urlBreakpoints
Definition: v8-inspector.h:389
v8::Local< v8::Value > value
Definition: v8-inspector.h:230
ResultType
Definition: v8-inspector.h:223
ResultType type
Definition: v8-inspector.h:229
Definition: v8-inspector.h:141
int scriptId
Definition: v8-inspector.h:146
StringView functionName
Definition: v8-inspector.h:143
int columnNumber
Definition: v8-inspector.h:145
StringView sourceURL
Definition: v8-inspector.h:142
int lineNumber
Definition: v8-inspector.h:144
Definition: v8-inspector.h:357
V8StackTraceId & operator=(const V8StackTraceId &)=default
V8StackTraceId(uintptr_t id, const std::pair< int64_t, int64_t > debugger_id)
V8StackTraceId(const V8StackTraceId &)=default
V8StackTraceId & operator=(V8StackTraceId &&) noexcept=default
V8StackTraceId(uintptr_t id, const std::pair< int64_t, int64_t > debugger_id, bool should_pause)
std::pair< int64_t, int64_t > debugger_id
Definition: v8-inspector.h:359
uintptr_t id
Definition: v8-inspector.h:358
Definition: v8-inspector.h:376
StringView breakpointId
Definition: v8-inspector.h:377
std::optional< int > columnNumber
Definition: v8-inspector.h:379
SelectorType
Definition: v8-inspector.h:381
int lineNumber
Definition: v8-inspector.h:378
StringView condition
Definition: v8-inspector.h:385
StringView selector
Definition: v8-inspector.h:383
SelectorType selectorType
Definition: v8-inspector.h:382
#define V8_EXPORT
Definition: v8config.h:875