JS_SetOperationCallback 编辑

Obsolete since JSAPI 30
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

This article covers features introduced in SpiderMonkey 1.8.5

Set a callback function that is automatically called periodically while JavaScript code runs. These methods/types are renamed to JS_SetInterruptCallback, JS_GetInterruptCallback, JS_RequestInterruptCallback and JSInterruptCallback in SpiderMonkey 30.

Syntax

void
JS_SetOperationCallback(JSContext *cx, JSOperationCallback callback);

JSOperationCallback
JS_GetOperationCallback(JSContext *cx);

void
JS_TriggerOperationCallback(JSRuntime *rt);

Callback syntax

JSBool
(*JSOperationCallback)(JSContext *cx);

Applications must not use both the operation callback API and the older branch callback API.

Description

These functions allow setting an operation callback that will be called from the JS thread some time after any thread triggered the callback using JS_TriggerOperationCallback.
To schedule the GC and for other activities the engine internally triggers operation callbacks. The embedding should thus not rely on callbacks being triggered through the external API only.

Important note: Additional callbacks can occur inside the callback handler if it re-enters the JS engine. The embedding must ensure that the callback is disconnected before attempting such re-entry.

JS_SetOperationCallback sets a callback that can be called asynchronously. Some common uses for an operation callback are:

• To run garbage collection periodically, by calling JS_MaybeGC;
• To periodically take a break from script execution to update the UI (though note that Mozilla does not do this, by design);
• To enforce application limits on the amount of time a script may run. (In this case, the callback may terminate the script by returning JS_FALSE.)

JS_GetOperationCallback returns the currently installed operation callback, or NULL if none is currently installed.

JS_TriggerOperationCallback triggers a callback set using JS_SetOperationCallback.

JS_ClearOperationCallback clears the current operation callback. Obsolete since JavaScript 1.9.1

JS_SetOperationCallbackFunction sets the operation callback without changing the operation limit. Obsolete since JavaScript 1.9.1

JS_GetOperationLimit returns the current operation limit, or JS_MAX_OPERATION_LIMIT if no operation callback is currently installed. Obsolete since JavaScript 1.9.1

JS_SetOperationLimit sets the operation limit without changing the operation callback. It must be called only when an operation callback is installed. Obsolete since JavaScript 1.9.1

See Also

• MXR ID Search for JS_SetOperationCallback
• MXR ID Search for JS_GetOperationCallback
• MXR ID Search for JS_TriggerOperationCallback
• JS_SetInterruptCallback
• JS_GetInterruptCallback
• JS_RequestInterruptCallback
• JSInterruptCallback
• bug 477187
• bug 977287