Struct script::dom::bindings::refcounted::Trusted

pub struct Trusted<T: DomObject> {
    refcount: Arc<TrustedReference>,
    owner_thread: *const LiveDOMReferences,
    phantom: PhantomData<T>,
}

A safe wrapper around a raw pointer to a DOM object that can be shared among threads for use in asynchronous operations. The underlying DOM object is guaranteed to live at least as long as the last outstanding Trusted<T> instance.

Fields

refcount: Arc<TrustedReference>

A pointer to the Rust DOM object of type T, but void to allow sending Trusted<T> between threads, regardless of T’s sendability.

owner_thread: *const LiveDOMReferences

phantom: PhantomData<T>

Implementations

impl<T: DomObject> Trusted<T>

pub fn new(ptr: &T) -> Trusted<T>

Create a new Trusted<T> instance from an existing DOM pointer. The DOM object will be prevented from being GCed for the duration of the resulting Trusted<T> object’s lifetime.

pub fn root(&self) -> Root<Dom<T>>

Obtain a usable DOM pointer from a pinned Trusted<T> value. Fails if used on a different thread than the original value from which this Trusted<T> was obtained.

Trait Implementations

impl<T: DomObject> Clone for Trusted<T>

fn clone(&self) -> Trusted<T>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: DomObject> JSTraceable for Trusted<T>

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

Trace self.

impl<T: DomObject> Send for Trusted<T>