servo-script-bindings 0.3.0

A component of the servo web-engine.
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

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */

//! Machinery to initialise namespace objects.

use std::ffi::CStr;
use std::ptr;

use js::jsapi::{JSClass, JSFunctionSpec};
use js::rust::{HandleObject, MutableHandleObject};

use crate::DomTypes;
use crate::constant::ConstantSpec;
use crate::guard::Guard;
use crate::interface::{create_object, define_on_global_object};
use crate::script_runtime::JSContext;

/// The class of a namespace object.
#[derive(Clone, Copy)]
pub(crate) struct NamespaceObjectClass(JSClass);

unsafe impl Sync for NamespaceObjectClass {}

impl NamespaceObjectClass {
    /// Create a new `NamespaceObjectClass` structure.
    pub(crate) const unsafe fn new(name: &'static CStr) -> Self {
        NamespaceObjectClass(JSClass {
            name: name.as_ptr(),
            flags: 0,
            cOps: ptr::null(),
            spec: ptr::null(),
            ext: ptr::null(),
            oOps: ptr::null(),
        })
    }
}

/// Create a new namespace object.
#[expect(clippy::too_many_arguments)]
pub(crate) fn create_namespace_object<D: DomTypes>(
    cx: JSContext,
    global: HandleObject,
    proto: HandleObject,
    class: &'static NamespaceObjectClass,
    methods: &[Guard<&'static [JSFunctionSpec]>],
    constants: &[Guard<&'static [ConstantSpec]>],
    name: &CStr,
    mut rval: MutableHandleObject,
) {
    create_object::<D>(
        cx,
        global,
        proto,
        &class.0,
        methods,
        &[],
        constants,
        rval.reborrow(),
    );
    define_on_global_object(cx, global, name, rval.handle());
}