neon 1.1.1

A safe abstraction layer for Node.js.
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

use std::mem::MaybeUninit;

use super::{
    bindings as napi,
    raw::{Env, Local},
};

pub(crate) struct HandleScope {
    env: Env,
    scope: napi::HandleScope,
}

impl HandleScope {
    pub(crate) unsafe fn new(env: Env) -> Self {
        let mut scope = MaybeUninit::uninit();

        napi::open_handle_scope(env, scope.as_mut_ptr()).unwrap();

        Self {
            env,
            scope: scope.assume_init(),
        }
    }
}

impl Drop for HandleScope {
    fn drop(&mut self) {
        unsafe {
            let _status = napi::close_handle_scope(self.env, self.scope);

            debug_assert_eq!(_status, Ok(()),);
        }
    }
}

pub(crate) struct EscapableHandleScope {
    env: Env,
    scope: napi::EscapableHandleScope,
}

impl EscapableHandleScope {
    pub(crate) unsafe fn new(env: Env) -> Self {
        let mut scope = MaybeUninit::uninit();

        napi::open_escapable_handle_scope(env, scope.as_mut_ptr()).unwrap();

        Self {
            env,
            scope: scope.assume_init(),
        }
    }

    pub(crate) unsafe fn escape(&self, value: napi::Value) -> napi::Value {
        let mut escapee = MaybeUninit::uninit();

        napi::escape_handle(self.env, self.scope, value, escapee.as_mut_ptr()).unwrap();

        escapee.assume_init()
    }
}

impl Drop for EscapableHandleScope {
    fn drop(&mut self) {
        unsafe {
            let _status = napi::close_escapable_handle_scope(self.env, self.scope);

            debug_assert_eq!(_status, Ok(()),);
        }
    }
}

pub unsafe fn get_global(env: Env, out: &mut Local) {
    super::get_global(env, out as *mut _).unwrap();
}