ferrijs-std 0.2.2

Node and web standard library for the ferrijs QuickJS runtime: WHATWG Streams, Events, AbortController, Buffer, crypto, fs, os, url, zlib and the capability model they enforce (partly derived from awslabs/llrt, Apache-2.0).
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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

use crate::utils::option::Undefined;
use rquickjs::{
    class::{JsClass, OwnedBorrowMut},
    Class, Ctx, FromJs, IntoAtom, Object, Result, Value,
};

pub mod promise;
pub mod queue;

// the trait used elsewhere in this repo accepts null values as 'None', which causes many web platform tests to fail as they
// like to check that undefined is accepted and null isn't.
pub trait ValueOrUndefined<'js> {
    fn get_value_or_undefined<K: IntoAtom<'js> + Clone, V: FromJs<'js>>(
        &self,
        k: K,
    ) -> Result<Option<V>>;
}

impl<'js> ValueOrUndefined<'js> for Object<'js> {
    fn get_value_or_undefined<K: IntoAtom<'js> + Clone, V: FromJs<'js> + Sized>(
        &self,
        k: K,
    ) -> Result<Option<V>> {
        let value = self.get::<K, Value<'js>>(k)?;
        Ok(Undefined::from_js(self.ctx(), value)?.0)
    }
}

impl<'js> ValueOrUndefined<'js> for Value<'js> {
    fn get_value_or_undefined<K: IntoAtom<'js> + Clone, V: FromJs<'js>>(
        &self,
        k: K,
    ) -> Result<Option<V>> {
        if let Some(obj) = self.as_object() {
            return obj.get_value_or_undefined(k);
        }
        Ok(None)
    }
}

pub trait UnwrapOrUndefined<'js> {
    fn unwrap_or_undefined(self, ctx: &Ctx<'js>) -> Value<'js>;
}

impl<'js> UnwrapOrUndefined<'js> for Option<Value<'js>> {
    fn unwrap_or_undefined(self, ctx: &Ctx<'js>) -> Value<'js> {
        self.unwrap_or_else(|| Value::new_undefined(ctx.clone()))
    }
}

pub fn class_from_owned_borrow_mut<'js, T: JsClass<'js>>(
    borrow: OwnedBorrowMut<'js, T>,
) -> (Class<'js, T>, OwnedBorrowMut<'js, T>) {
    let class = borrow.into_inner();
    let borrow = OwnedBorrowMut::from_class(class.clone());
    (class, borrow)
}