JS_AddFinalizeCallback 编辑

This article covers features introduced in SpiderMonkey 17

Add/remove callback function for finalization.

Syntax

bool
JS_AddFinalizeCallback(JSRuntime *rt, JSFinalizeCallback cb, void *data); // Added in SpiderMonkey 38 (JSAPI 32)

void
JS_RemoveFinalizeCallback(JSRuntime *rt, JSFinalizeCallback cb); // Added in SpiderMonkey 38 (JSAPI 32)

void
JS_SetFinalizeCallback(JSRuntime *rt, JSFinalizeCallback cb); // Obsolete since JSAPI 32

Callback syntax

typedef enum JSFinalizeStatus {
    JSFINALIZE_GROUP_START,
    JSFINALIZE_GROUP_END,
    JSFINALIZE_COLLECTION_END
} JSFinalizeStatus;

typedef void
(* JSFinalizeCallback)(JSFreeOp *fop, JSFinalizeStatus status, bool isCompartment, void *data);

Description

JS_AddFinalizeCallback add a callback function which the garbage collector calls at several points during garbage collection. rt is the runtime in which you specify the callback. cb is a pointer to the callback function to add.

JS_RemoveFinalizeCallback removes the previously added callback function.

Obsolete since JSAPI 32

JS_SetFinalizeCallback sets a new callback function. It was replaced with JS_AddFinalizeCallback, to allow adding multiple callback functions.

See Also

• MXR ID Search for JS_AddFinalizeCallback
• MXR ID Search for JS_RemoveFinalizeCallback
• MXR ID Search for JSFinalizeStatus
• MXR ID Search for JSFINALIZE_GROUP_START
• MXR ID Search for JSFINALIZE_GROUP_END
• MXR ID Search for JSFINALIZE_COLLECTION_END
• MXR ID Search for JSFinalizeCallback
• JSFreeOp
• JS_SetGCCallback
• bug 723286 - separated from JS_SetGCCallback as JS_SetFinalizeCallback
• bug 996785 - replaced with JS_AddFinalizeCallback