JS_EnterCompartment 编辑

This article covers features introduced in SpiderMonkey 24

Note: the preferred way of changing a context's current compartment is using JSAutoCompartment.

Enter a different compartment on the given context, so that objects in that compartment can be accessed.

Syntax

JSCompartment *
JS_EnterCompartment(JSContext *cx, JSObject *target);

Name	Type	Description
cx	JSContext *	The context on which a cross-compartment call is needed.
target	JSObject *	The object in a different compartment to be accessed. This implicitly identifies the compartment to be entered.

Description

Every JSContext has a current compartment. Any access to an object in a different compartment must be bracketed by calling JS_EnterCompartment and JS_LeaveCompartment.

On success, JS_EnterCompartmentreturns a pointer to the previously entered compartment. To return to that compartment, pass it to JS_LeaveCompartment.JS_EnterCompartment is infallible, so a NULL return value doesn't indicate failure.

See Also

• MXR ID Search for JS_EnterCompartment
• JS_LeaveCompartment
• JSAutoCompartment
• bug 786068