Struct neon::prelude::Root

#[repr(transparent)]pub struct Root<T> { /* fields omitted */ }

Root<T> holds a reference to a JavaScript object and prevents it from being garbage collected. Root<T> may be sent across threads, but the referenced objected may only be accessed on the JavaScript thread that created it.

Implementations

impl<T: Object> Root<T>

pub fn new<'a, C: Context<'a>>(cx: &mut C, value: &T) -> Self

Create a reference to a JavaScript object. The object will not be garbage collected until the Root is dropped. A Root<T> may only be dropped on the JavaScript thread that created it.

The caller must ensure Root::into_inner or Root::drop is called to properly dispose of the Root<T>. If the value is dropped without calling one of these methods, it will panic.

pub fn clone<'a, C: Context<'a>>(&self, cx: &mut C) -> Self

Clone a reference to the contained JavaScript object. This method can be considered identical to the following:

let inner = root.into_inner(&mut cx);
let cloned = inner.root(&mut cx);
let root = inner.root(&mut cx);

pub fn drop<'a, C: Context<'a>>(self, cx: &mut C)

Safely drop a Root<T> without returning the referenced JavaScript object.

pub fn into_inner<'a, C: Context<'a>>(self, cx: &mut C) -> Handle<'a, T>

Return the referenced JavaScript object and allow it to be garbage collected

pub fn to_inner<'a, C: Context<'a>>(&self, cx: &mut C) -> Handle<'a, T>

Access the inner JavaScript object without consuming the Root This method aliases the reference without changing the reference count. It can be used in place of a clone immediately followed by a call to into_inner.

Trait Implementations

impl<T> Debug for Root<T>

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

Formats the value using the given formatter.

impl<T> Drop for Root<T>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: Object> Finalize for Root<T>

fn finalize<'a, C: Context<'a>>(self, cx: &mut C)

impl<T> Send for Root<T>

impl<T> Sync for Root<T>