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'
}