Enum JsValue 

pub enum JsValue {
    Undefined,
    Null,
    Bool(bool),
    Number(f64),
    String(String),
    Object(*mut JSObject),
}

Variants

Undefined

Null

Bool(bool)

Number(f64)

String(String)

Object(*mut JSObject)

GC-unsafe: the *mut JSObject pointer is NOT rooted. This variant must only be used as a transient conversion value within a single no-GC window (i.e., created from jsval_to_jsvalue and consumed by to_jsval before any JS code runs that could trigger GC). Storing JsValue::Object in a struct field, local variable across an await point, or collection that outlives the current SM API call will cause use-after-free if GC moves or collects the object.

For persistent storage, use GcStore (see bao_runtime::gc_store):

• gc_store_insert(cx, key, obj) — store with simple key (__gc_cache_{key})
• gc_store_insert_ns(cx, namespace, key, obj) — store with namespaced key (__gc_{namespace}_{key})
• gc_store_get(cx, key) / gc_store_get_ns(cx, namespace, key) — retrieve
• gc_store_remove(cx, key) / gc_store_remove_ns(cx, namespace, key) — remove

GcStore stores objects as properties on the JS global, so SpiderMonkey’s GC manages them naturally — no raw pointer that could dangle after GC.

Implementations

impl JsValue

pub fn is_undefined(&self) -> bool

pub fn is_null(&self) -> bool

pub fn is_number(&self) -> bool

pub fn is_string(&self) -> bool

pub fn is_object(&self) -> bool

pub fn as_bool(&self) -> Option<bool>

pub fn as_number(&self) -> Option<f64>

pub fn as_string(&self) -> Option<&str>

pub fn as_object(&self) -> Option<*mut JSObject>

pub fn to_display_string(&self) -> String

pub unsafe fn to_jsval(&self, cx: *mut JSContext) -> Value

Safety

cx must be a valid JSContext pointer. The returned JSVal borrows from SpiderMonkey GC — caller must ensure the value is rooted before any GC.

impl JsValue

pub unsafe fn set_as_rval(self, cx: *mut JSContext, args: &mut CallArgs)

Set this value as the return value of a JSNative callback.

Safety

cx must be a valid JSContext. args must be valid CallArgs.

Trait Implementations

impl Clone for JsValue

fn clone(&self) -> JsValue

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JsValue

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.