from_js_ref 0.2.0

Trait for converting from JS interface reference wrappers
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

//! Convert JS-imported reference types to Rust-exported types.

#![cfg_attr(not(feature = "std"), no_std)]

use wasm_bindgen::{JsCast, JsValue};

/// A trait for converting from a JS reference type to a Rust type.
pub trait FromJsRef: Sized {
    type JsRef: wasm_bindgen::JsCast;

    /// Converts from a JS reference type to the Rust type.
    fn from_js_ref(castable: &Self::JsRef) -> Self;

    /// Attempts to convert from a `JsValue` to the Rust type by going through the JS reference type.
    fn try_from_js_value(js_value: &JsValue) -> Option<Self> {
        js_value
            .dyn_ref::<Self::JsRef>()
            .map(|js_ref| Self::from_js_ref(js_ref))
    }
}

pub trait JsDeref<T: FromJsRef> {
    fn js_deref(&self) -> T;
}

impl<T: FromJsRef> JsDeref<T> for T::JsRef {
    fn js_deref(&self) -> T {
        T::from_js_ref(self)
    }
}

/// Re-exports for use by generated code. Not part of the public API.
#[doc(hidden)]
pub mod __private {
    pub use js_sys;
    pub use wasm_bindgen;
}