Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

JSAutoCompartment

This article needs a technical review. How you can help.

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: arai, fscholz, tschneidereit
 Last updated by: arai,