Struct Guarded 

pub struct Guarded {
    pub value: JsValue,
    pub guard: Option<Guard<JsObject>>,
}

A JsValue bundled with a Guard that keeps it alive.

IMPORTANT: Access the value through destructuring ONLY to ensure the guard stays alive for the correct duration. See CLAUDE.md for rules.

The fields are public to allow struct destructuring pattern, which is the ONLY approved way to access the contents.

Fields

value: JsValue

guard: Option<Guard<JsObject>>

Implementations

impl Guarded

pub fn with_guard(value: JsValue, guard: Guard<JsObject>) -> Self

Create a guarded value with a guard. If the value is a primitive, the guard is dropped and guard will be None. NOTE: You must call value.guard_by(&guard) before this if the value is an object.

pub fn unguarded(value: JsValue) -> Self

Create an unguarded value (for primitives or already-owned objects)

pub fn from_value(value: JsValue, heap: &Heap<JsObject>) -> Self

Create a guarded value for returning from the VM. Creates a new guard from the heap if the value is an object. For primitives, returns an unguarded value.

pub fn with_value(self, value: JsValue) -> Self

Return a new value with the same guard (for derived values)

Use this when you derive a value from a guarded input and want to propagate the guard to keep the original object alive.

Trait Implementations

impl Debug for Guarded

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

Formats the value using the given formatter.