5#ifndef V8_V8_INSPECTOR_H_
6#define V8_V8_INSPECTOR_H_
56 StringView() : m_is8Bit(true), m_length(0), m_characters8(nullptr) {}
59 : m_is8Bit(true), m_length(length), m_characters8(characters) {}
62 : m_is8Bit(false), m_length(length), m_characters16(characters) {}
64 bool is8Bit()
const {
return m_is8Bit; }
65 size_t length()
const {
return m_length; }
94 contextGroupId(contextGroupId),
95 humanReadableName(humanReadableName),
96 hasMemoryOnConsole(false) {}
110 void*
operator new(size_t) =
delete;
112 void*
operator new(size_t,
void*) =
delete;
131 std::pair<int64_t, int64_t>
pair()
const;
134 friend class internal::V8DebuggerId;
138 int64_t m_second = 0;
165 virtual std::unique_ptr<protocol::Runtime::API::StackTrace>
167 virtual std::unique_ptr<StringBuffer>
toString()
const = 0;
170 virtual std::unique_ptr<V8StackTrace>
clone() = 0;
172 virtual std::vector<V8StackFrame>
frames()
const = 0;
191 virtual std::vector<uint8_t>
state() = 0;
192 virtual std::vector<std::unique_ptr<protocol::Schema::API::Domain>>
204 virtual void resume(
bool setTerminateOnResume =
false) = 0;
206 virtual std::vector<std::unique_ptr<protocol::Debugger::API::SearchMatch>>
211 virtual std::unique_ptr<protocol::Runtime::API::RemoteObject>
wrapObject(
213 bool generatePreview) = 0;
218 std::unique_ptr<StringBuffer>* objectGroup) = 0;
236 bool includeCommandLineAPI =
false) = 0;
245 : type(std::move(type)), value(value) {}
246 std::unique_ptr<StringBuffer>
type;
252 std::unique_ptr<DeepSerializedValue> serializedValue)
253 : serializedValue(std::move(serializedValue)), isSuccess(true) {}
255 : errorMessage(std::move(errorMessage)), isSuccess(false) {}
269 runMessageLoopOnPause(contextGroupId);
295 int contextGroupId) {
313 unsigned columnNumber,
315 consoleAPIMessage(contextGroupId, level, message, url, lineNumber,
316 columnNumber, stackTrace);
333 typedef void (*TimerCallback)(
void*);
360 bool should_pause =
false;
372 bool IsInvalid() const;
425 unsigned lineNumber,
unsigned columnNumber,
426 std::unique_ptr<V8StackTrace>,
440 std::unique_ptr<StringBuffer> message) = 0;
450 std::unique_ptr<StringBuffer> message) = 0;
461 virtual std::unique_ptr<V8InspectorSession>
connect(
Definition: garbage-collected.h:53
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
virtual ~Inspectable()=default
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 void stepOver()=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 ~Channel()=default
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 ~ManagedChannel()=default
virtual void flushProtocolNotifications()=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
Definition: v8-inspector.h:222
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(StringView)
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