Files
servo/components/script_bindings/realms.rs
Sam fa12f7a5e5 script: Add cx_no_gc/cx/realm codegen option and demostrate them (#40582)
Companion to https://github.com/servo/mozjs/pull/650

We added 3 new options to bindings.conf, each more powerful then the
previous one, so one should use the least powerful as possible to keep
things flexible:
1 `cx_no_gc` prepends argument `&JSContext`, which allows creating NoGC
tokens and using functions that do not trigger GC.
2. `cx` prepends argument `&mut JSContext`, which allows everything that
previous one allows, but it also allows calling GC triggering functions.
3. `realm` prepends argument `&mut CurrentRealm`, which can be deref_mut
to `&mut JSContext` (so it can do everything that previous can), but it
also ensures that there is current entered realm, which can be used for
creation of InRealm.

next steps: #40600 

reviewable per commit

Testing: It's just refactoring
try run: https://github.com/sagudev/servo/actions/runs/19287700927

---------

Signed-off-by: sagudev <16504129+sagudev@users.noreply.github.com>
2025-11-16 04:53:54 +00:00

72 lines
1.8 KiB
Rust

/* 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/. */
use js::jsapi::{GetCurrentRealmOrNull, JSAutoRealm};
use js::realm::CurrentRealm;
use crate::DomTypes;
use crate::interfaces::GlobalScopeHelpers;
use crate::reflector::DomObject;
use crate::script_runtime::JSContext;
pub struct AlreadyInRealm(());
impl AlreadyInRealm {
#![allow(unsafe_code)]
pub fn assert<D: DomTypes>() -> AlreadyInRealm {
unsafe {
assert!(!GetCurrentRealmOrNull(*D::GlobalScope::get_cx()).is_null());
}
AlreadyInRealm(())
}
pub fn assert_for_cx(cx: JSContext) -> AlreadyInRealm {
unsafe {
assert!(!GetCurrentRealmOrNull(*cx).is_null());
}
AlreadyInRealm(())
}
}
impl<'a, 'b> From<&'a mut CurrentRealm<'b>> for AlreadyInRealm {
fn from(_: &'a mut CurrentRealm<'b>) -> AlreadyInRealm {
AlreadyInRealm(())
}
}
#[derive(Clone, Copy)]
pub enum InRealm<'a> {
Already(&'a AlreadyInRealm),
Entered(&'a JSAutoRealm),
}
impl<'a> From<&'a AlreadyInRealm> for InRealm<'a> {
fn from(token: &'a AlreadyInRealm) -> InRealm<'a> {
InRealm::already(token)
}
}
impl<'a> From<&'a JSAutoRealm> for InRealm<'a> {
fn from(token: &'a JSAutoRealm) -> InRealm<'a> {
InRealm::entered(token)
}
}
impl InRealm<'_> {
pub fn already(token: &AlreadyInRealm) -> InRealm<'_> {
InRealm::Already(token)
}
pub fn entered(token: &JSAutoRealm) -> InRealm<'_> {
InRealm::Entered(token)
}
}
pub fn enter_realm<D: DomTypes>(object: &impl DomObject) -> JSAutoRealm {
JSAutoRealm::new(
*D::GlobalScope::get_cx(),
object.reflector().get_jsobject().get(),
)
}