Struct CallbackObject

pub(crate) struct CallbackObject<D: DomTypes> {
    callback: Heap<*mut JSObject>,
    permanent_js_root: Heap<JSVal>,
    incumbent: Option<Dom<D::GlobalScope>>,
}

A common base class for representing IDL callback function and callback interface types.

Fields

callback: Heap<*mut JSObject>

The underlying JSObject.

permanent_js_root: Heap<JSVal>

incumbent: Option<Dom<D::GlobalScope>>

The “callback context”, that is, the global to use as incumbent global when calling the callback.

Looking at the WebIDL standard, it appears as though there would always be a value here, but sometimes callback functions are created by hand-waving without defining the value of the callback context, and without any JavaScript code on the stack to grab an incumbent global from.

Implementations

impl<D: DomTypes> CallbackObject<D>

fn new() -> Self

pub(crate) fn get(&self) -> *mut JSObject

unsafe fn init(&mut self, cx: JSContext, callback: *mut JSObject)

Trait Implementations

impl<D: DomTypes> Drop for CallbackObject<D>

fn drop(&mut self)

Executes the destructor for this type.

impl<D: DomTypes> PartialEq for CallbackObject<D>

fn eq(&self, other: &CallbackObject<D>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<D> Traceable for CallbackObject<D>

where D: JSTraceable + DomTypes,

unsafe fn trace(&self, tracer: *mut JSTracer)

Trace self.