Struct v8::MicrotaskQueue

#[repr(C)]
pub struct MicrotaskQueue(/* private fields */);

Represents the microtask queue, where microtasks are stored and processed. https://html.spec.whatwg.org/multipage/webappapis.html#microtask-queue https://html.spec.whatwg.org/multipage/webappapis.html#enqueuejob(queuename,-job,-arguments) https://html.spec.whatwg.org/multipage/webappapis.html#perform-a-microtask-checkpoint

A MicrotaskQueue instance may be associated to multiple Contexts by passing it to Context::New(), and they can be detached by Context::DetachGlobal(). The embedder must keep the MicrotaskQueue instance alive until all associated Contexts are gone or detached.

Use the same instance of MicrotaskQueue for all Contexts that may access each other synchronously. E.g. for Web embedding, use the same instance for all origins that share the same URL scheme and eTLD+1.

Implementations

impl MicrotaskQueue

pub fn new(isolate: &mut Isolate, policy: MicrotasksPolicy) -> UniqueRef<Self>

pub fn enqueue_microtask( &self, isolate: &mut Isolate, microtask: Local<'_, Function> )

pub fn perform_checkpoint(&self, isolate: &mut Isolate)

Adds a callback to notify the embedder after microtasks were run. The callback is triggered by explicit RunMicrotasks call or automatic microtasks execution (see Isolate::SetMicrotasksPolicy).

Callback will trigger even if microtasks were attempted to run, but the microtasks queue was empty and no single microtask was actually executed.

Executing scripts inside the callback will not re-trigger microtasks and the callback.

pub fn is_running_microtasks(&self) -> bool

Removes callback that was installed by AddMicrotasksCompletedCallback.

pub fn get_microtasks_scope_depth(&self) -> i32

Returns the current depth of nested MicrotasksScope that has kRunMicrotasks.

Trait Implementations

impl Debug for MicrotaskQueue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for MicrotaskQueue

fn drop(&mut self)

Executes the destructor for this type.