script/dom/
servointernals.rs

1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
4
5use std::rc::Rc;
6
7use constellation_traits::ScriptToConstellationMessage;
8use dom_struct::dom_struct;
9use js::gc::MutableHandleValue;
10use js::jsapi::Heap;
11use js::jsval::UndefinedValue;
12use js::rust::HandleObject;
13use profile_traits::mem::MemoryReportResult;
14use script_bindings::conversions::SafeToJSValConvertible;
15use script_bindings::error::{Error, Fallible};
16use script_bindings::interfaces::ServoInternalsHelpers;
17use script_bindings::script_runtime::JSContext;
18use script_bindings::str::USVString;
19use servo_config::prefs::{self, PrefValue, Preferences};
20
21use crate::dom::bindings::codegen::Bindings::ServoInternalsBinding::ServoInternalsMethods;
22use crate::dom::bindings::import::base::SafeJSContext;
23use crate::dom::bindings::reflector::{DomGlobal, Reflector, reflect_dom_object};
24use crate::dom::bindings::root::DomRoot;
25use crate::dom::globalscope::GlobalScope;
26use crate::dom::promise::Promise;
27use crate::realms::{AlreadyInRealm, InRealm};
28use crate::routed_promise::{RoutedPromiseListener, callback_promise};
29use crate::script_runtime::CanGc;
30use crate::script_thread::ScriptThread;
31
32fn pref_to_jsval(pref: &PrefValue, cx: JSContext, rval: MutableHandleValue, can_gc: CanGc) {
33    match pref {
34        PrefValue::Bool(b) => b.safe_to_jsval(cx, rval, can_gc),
35        PrefValue::Int(i) => i.safe_to_jsval(cx, rval, can_gc),
36        PrefValue::UInt(u) => u.safe_to_jsval(cx, rval, can_gc),
37        PrefValue::Str(s) => s.safe_to_jsval(cx, rval, can_gc),
38        PrefValue::Float(f) => f.safe_to_jsval(cx, rval, can_gc),
39        PrefValue::Array(arr) => {
40            rooted_vec!(let mut js_arr);
41            for item in arr {
42                rooted!(in(*cx) let mut js_val = UndefinedValue());
43                pref_to_jsval(item, cx, js_val.handle_mut(), can_gc);
44                js_arr.push(Heap::boxed(js_val.get()));
45            }
46            js_arr.safe_to_jsval(cx, rval, can_gc);
47        },
48    }
49}
50
51#[dom_struct]
52pub(crate) struct ServoInternals {
53    reflector_: Reflector,
54}
55
56impl ServoInternals {
57    pub fn new_inherited() -> ServoInternals {
58        ServoInternals {
59            reflector_: Reflector::new(),
60        }
61    }
62
63    pub(crate) fn new(global: &GlobalScope, can_gc: CanGc) -> DomRoot<ServoInternals> {
64        reflect_dom_object(Box::new(ServoInternals::new_inherited()), global, can_gc)
65    }
66}
67
68impl ServoInternalsMethods<crate::DomTypeHolder> for ServoInternals {
69    /// <https://servo.org/internal-no-spec>
70    fn ReportMemory(&self, comp: InRealm, can_gc: CanGc) -> Rc<Promise> {
71        let global = &self.global();
72        let promise = Promise::new_in_current_realm(comp, can_gc);
73        let task_source = global.task_manager().dom_manipulation_task_source();
74        let callback = callback_promise(&promise, self, task_source);
75
76        let script_to_constellation_chan = global.script_to_constellation_chan();
77        if script_to_constellation_chan
78            .send(ScriptToConstellationMessage::ReportMemory(callback))
79            .is_err()
80        {
81            promise.reject_error(Error::Operation(None), can_gc);
82        }
83        promise
84    }
85
86    /// <https://servo.org/internal-no-spec>
87    fn PreferenceList(&self) -> Vec<USVString> {
88        Preferences::all_fields()
89            .into_iter()
90            .map(|s| USVString::from(s.to_string()))
91            .collect()
92    }
93
94    /// <https://servo.org/internal-no-spec>
95    fn PreferenceType(&self, name: USVString) -> Fallible<USVString> {
96        if !Preferences::exists(&name) {
97            return Err(Error::NotFound(None));
98        }
99        let type_name = Preferences::type_of(&name).split("::").last().unwrap();
100        Ok(USVString::from(type_name.to_string()))
101    }
102
103    /// <https://servo.org/internal-no-spec>
104    fn DefaultPreferenceValue(
105        &self,
106        cx: SafeJSContext,
107        name: USVString,
108        rval: MutableHandleValue,
109    ) -> Fallible<()> {
110        if !Preferences::exists(&name) {
111            return Err(Error::NotFound(None));
112        }
113        let pref = Preferences::default().get_value(&name);
114        pref_to_jsval(&pref, cx, rval, CanGc::note());
115        Ok(())
116    }
117
118    /// <https://servo.org/internal-no-spec>
119    fn GetPreference(
120        &self,
121        cx: JSContext,
122        name: USVString,
123        rval: MutableHandleValue,
124    ) -> Fallible<()> {
125        if !Preferences::exists(&name) {
126            return Err(Error::NotFound(None));
127        }
128        let pref = prefs::get().get_value(&name);
129        pref_to_jsval(&pref, cx, rval, CanGc::note());
130        Ok(())
131    }
132
133    /// <https://servo.org/internal-no-spec>
134    fn GetBoolPreference(&self, name: USVString) -> Fallible<bool> {
135        if !Preferences::exists(&name) {
136            return Err(Error::NotFound(None));
137        }
138        if let PrefValue::Bool(b) = prefs::get().get_value(&name) {
139            return Ok(b);
140        }
141        Err(Error::TypeMismatch(None))
142    }
143
144    /// <https://servo.org/internal-no-spec>
145    fn GetIntPreference(&self, name: USVString) -> Fallible<i64> {
146        if !Preferences::exists(&name) {
147            return Err(Error::NotFound(None));
148        }
149        if let PrefValue::Int(i) = prefs::get().get_value(&name) {
150            return Ok(i);
151        }
152        Err(Error::TypeMismatch(None))
153    }
154
155    /// <https://servo.org/internal-no-spec>
156    fn GetStringPreference(&self, name: USVString) -> Fallible<USVString> {
157        if !Preferences::exists(&name) {
158            return Err(Error::NotFound(None));
159        }
160        if let PrefValue::Str(s) = prefs::get().get_value(&name) {
161            return Ok(s.into());
162        }
163        Err(Error::TypeMismatch(None))
164    }
165
166    /// <https://servo.org/internal-no-spec>
167    fn SetBoolPreference(&self, name: USVString, value: bool) {
168        let mut current_prefs = prefs::get().clone();
169        current_prefs.set_value(&name, value.into());
170        prefs::set(current_prefs);
171    }
172
173    /// <https://servo.org/internal-no-spec>
174    fn SetIntPreference(&self, name: USVString, value: i64) {
175        let mut current_prefs = prefs::get().clone();
176        current_prefs.set_value(&name, value.into());
177        prefs::set(current_prefs);
178    }
179
180    /// <https://servo.org/internal-no-spec>
181    fn SetStringPreference(&self, name: USVString, value: USVString) {
182        let mut current_prefs = prefs::get().clone();
183        current_prefs.set_value(&name, value.0.into());
184        prefs::set(current_prefs);
185    }
186}
187
188impl RoutedPromiseListener<MemoryReportResult> for ServoInternals {
189    fn handle_response(&self, response: MemoryReportResult, promise: &Rc<Promise>, can_gc: CanGc) {
190        let stringified = serde_json::to_string(&response.results)
191            .unwrap_or_else(|_| "{ error: \"failed to create memory report\"}".to_owned());
192        promise.resolve_native(&stringified, can_gc);
193    }
194}
195
196impl ServoInternalsHelpers for ServoInternals {
197    /// The navigator.servo api is exposed to about: pages except about:blank, as
198    /// well as any URLs provided by embedders that register new protocol handlers.
199    #[expect(unsafe_code)]
200    fn is_servo_internal(cx: JSContext, _global: HandleObject) -> bool {
201        unsafe {
202            let in_realm_proof = AlreadyInRealm::assert_for_cx(cx);
203            let global_scope = GlobalScope::from_context(*cx, InRealm::Already(&in_realm_proof));
204            let url = global_scope.get_url();
205            (url.scheme() == "about" && url.as_str() != "about:blank") ||
206                ScriptThread::is_servo_privileged(url)
207        }
208    }
209}
script/dom/servointernals.rs

script/dom/
servointernals.rs
