Struct JsRuntimeInspector

pub struct JsRuntimeInspector { /* private fields */ }

This structure is used responsible for providing inspector interface to the JsRuntime.

It stores an instance of v8::inspector::V8Inspector and additionally implements v8::inspector::V8InspectorClientImpl.

After creating this structure it’s possible to connect multiple sessions to the inspector, in case of Deno it’s either: a “websocket session” that provides integration with Chrome Devtools, or an “in-memory session” that is used for REPL or coverage collection.

Implementations

impl JsRuntimeInspector

pub fn new( isolate_ptr: *mut Isolate, scope: &mut HandleScope<'_>, context: Local<'_, Context>, is_main_runtime: bool, ) -> Rc<RefCell<Self>>

pub fn is_dispatching_message(&self) -> bool

pub fn context_destroyed( &mut self, scope: &mut HandleScope<'_>, context: Global<Context>, )

pub fn exception_thrown( &self, scope: &mut HandleScope<'_>, exception: Local<'_, Value>, in_promise: bool, )

pub fn sessions_state(&self) -> SessionsState

pub fn poll_sessions( &self, invoker_cx: Option<&mut Context<'_>>, ) -> Result<Poll<()>, BorrowMutError>

pub fn wait_for_session(&mut self)

This function blocks the thread until at least one inspector client has established a websocket connection.

pub fn wait_for_session_and_break_on_next_statement(&mut self)

This function blocks the thread until at least one inspector client has established a websocket connection.

After that, it instructs V8 to pause at the next statement. Frontend must send “Runtime.runIfWaitingForDebugger” message to resume execution.

pub fn get_session_sender(&self) -> UnboundedSender<InspectorSessionProxy>

Obtain a sender for proxy channels.

pub fn add_deregister_handler(&mut self) -> Receiver<()>

Create a channel that notifies the frontend when inspector is dropped.

NOTE: Only a single handler is currently available.

pub fn create_raw_session( &self, options: InspectorSessionOptions, send: Box<dyn Fn(InspectorMsg)>, ) -> UnboundedSender<String>

pub fn create_local_session( &self, options: InspectorSessionOptions, ) -> LocalInspectorSession

Create a local inspector session that can be used on the same thread as the isolate.

Trait Implementations

impl Drop for JsRuntimeInspector

fn drop(&mut self)

Executes the destructor for this type.

impl V8InspectorClientImpl for JsRuntimeInspector

fn base(&self) -> &V8InspectorClientBase

unsafe fn base_ptr(this: *const Self) -> *const V8InspectorClientBase

where Self: Sized,

This is used for calculating the offset to the base field, and care must be taken not to create any references in the process of creating the pointer because the *const Self pointer is not valid (thus resulting in instant UB)

fn base_mut(&mut self) -> &mut V8InspectorClientBase

fn run_message_loop_on_pause(&mut self, context_group_id: i32)

fn quit_message_loop_on_pause(&mut self)

fn run_if_waiting_for_debugger(&mut self, context_group_id: i32)

fn ensure_default_context_in_group( &mut self, context_group_id: i32, ) -> Option<Local<'_, Context>>

fn generate_unique_id(&mut self) -> i64

fn console_api_message( &mut self, context_group_id: i32, level: i32, message: &StringView<'_>, url: &StringView<'_>, line_number: u32, column_number: u32, stack_trace: &mut V8StackTrace, )