mozilla
Your Search Results

    JSAutoCompartment

    This article is in need of a technical review.

    This article covers features introduced in SpiderMonkey 24

    RAII helper to enter a different compartment on the given context and automatically leave it once the JSAutoCompartment instance gets out of scope.

    Syntax

    JSAutoCompartment(JSContext *cx, JSObject *target);
    
    JSAutoCompartment(JSContext *cx, JSScript *target);
    
    Name Type Description
    cx JSContext * The context on which a cross-compartment call is needed.
    target JSObject * / JSScript *

    The object in a different compartment to be accessed. This implicitly identifies the compartment to be entered.

    Description

    Every JSContext has a current compartment. Only objects in the current compartment can be accessed, so to access an object in a different compartment, this containing compartment has to be entered first. Compartments have to be entered and left in LIFO order. JSAutoCompartment guarantees that by automatically entering the given compartment and leaving it upon getting out of scope:
    void foo(JSContext *cx, JObject *obj) {
        // in some compartment 'c'
        {
            JSAutoCompartment ac(cx, obj);  // constructor enters
            // in the compartment of 'obj'
        }                                 // destructor leaves
        // back in compartment 'c'
    }
    

    See Also

    Document Tags and Contributors

    Contributors to this page: tschneidereit, fscholz, arai
    Last updated by: arai,
    Hide Sidebar