wext 0.7.2

web-sys extension traits, convenience functions and types
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

use std::ops::DerefMut as _;

pub trait RcRefCellCallbackExt<T> {
    fn strong_await_queue<F, C>(&self, future: F, callback: C)
    where
        F: std::future::Future + 'static,
        C: FnMut(&mut T, F::Output) + 'static;
    fn strong_queue<C>(&self, callback: C)
    where
        C: FnMut(&mut T) + 'static;
}

impl<T: 'static> RcRefCellCallbackExt<T> for std::rc::Rc<std::cell::RefCell<T>> {
    fn strong_await_queue<F, C>(&self, future: F, mut callback: C)
    where
        F: std::future::Future + 'static,
        C: FnMut(&mut T, F::Output) + 'static,
    {
        let strong = self.clone();
        wasm_bindgen_futures::spawn_local(async move {
            let output = future.await;
            rc_ref_cell_try_run(&strong, |r| callback(r, output))
        })
    }

    fn strong_queue<C>(&self, mut callback: C)
    where
        C: FnMut(&mut T) + 'static,
    {
        self.strong_await_queue(async {}, move |r, ()| callback(r))
    }
}

pub trait WeakRcRefCellCallbackExt<T> {
    fn await_queue<F, C>(&self, future: F, callback: C)
    where
        F: std::future::Future + 'static,
        C: FnMut(&mut T, F::Output) + 'static;
    fn queue<C>(&self, callback: C)
    where
        C: FnMut(&mut T) + 'static;
    fn callback<C>(&self, callback: C) -> Box<dyn Fn()>
    where
        C: FnMut(&mut T) + 'static;
}

impl<T: 'static> WeakRcRefCellCallbackExt<T> for std::rc::Rc<std::cell::RefCell<T>> {
    fn await_queue<F, C>(&self, future: F, callback: C)
    where
        F: std::future::Future + 'static,
        C: FnMut(&mut T, F::Output) + 'static,
    {
        std::rc::Rc::downgrade(self).await_queue(future, callback)
    }

    fn queue<C>(&self, callback: C)
    where
        C: FnMut(&mut T) + 'static,
    {
        std::rc::Rc::downgrade(self).queue(callback)
    }

    fn callback<C>(&self, callback: C) -> Box<dyn Fn()>
    where
        C: FnMut(&mut T) + 'static,
    {
        std::rc::Rc::downgrade(self).callback(callback)
    }
}

impl<T: 'static> WeakRcRefCellCallbackExt<T> for std::rc::Weak<std::cell::RefCell<T>> {
    fn await_queue<F, C>(&self, future: F, mut callback: C)
    where
        F: std::future::Future + 'static,
        C: FnMut(&mut T, F::Output) + 'static,
    {
        let weak = self.clone();
        wasm_bindgen_futures::spawn_local(async move {
            let output = future.await;
            weak_ref_cell_try_run(&weak, move |r| callback(r, output))
        })
    }

    fn queue<C>(&self, mut callback: C)
    where
        C: FnMut(&mut T) + 'static,
    {
        self.await_queue(async {}, move |r, ()| callback(r))
    }

    fn callback<C>(&self, callback: C) -> Box<dyn Fn()>
    where
        C: FnMut(&mut T) + 'static,
    {
        let weak = self.clone();
        let callback = std::rc::Rc::new(std::cell::RefCell::new(callback));
        Box::new(move || {
            let callback = callback.clone();
            weak.queue(move |this| try_run_ref_cell_fn(this, &callback))
        })
    }
}

fn try_run_ref_cell_fn<T, F: FnMut(&mut T) + 'static>(this: &mut T, f: &std::rc::Rc<std::cell::RefCell<F>>) {
    match f.try_borrow_mut() {
        Ok(mut guard) => guard(this),
        Err(_) => log::warn!("already borrowed callback triggered (maybe due to a leak or panic)"),
    }
}

fn weak_ref_cell_try_run<T>(weak_ref_cell: &std::rc::Weak<std::cell::RefCell<T>>, callback: impl FnOnce(&mut T)) {
    match weak_ref_cell.upgrade() {
        None => log::warn!("callback triggered with dropped receiver"),
        Some(strong) => rc_ref_cell_try_run(&strong, callback),
    }
}
fn rc_ref_cell_try_run<T>(rc_ref_cell: &std::rc::Rc<std::cell::RefCell<T>>, callback: impl FnOnce(&mut T)) {
    match rc_ref_cell.try_borrow_mut() {
        Ok(mut guard) => callback(guard.deref_mut()),
        Err(_) => log::warn!("callback triggered with already borrowed receiver (maybe due to a leak or panic)"),
    }
}