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

    JS_AddFinalizeCallback

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

    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
    Name Type Description
    rt JSRuntime * The JSRuntime for which to set the finalization callback.
    cb JSFinalizeCallback Pointer to the new callback function to use.
    data void * Passed to data parameter for JSFinalizeCallback.

    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);
    Name Type Description
    fop JSFreeOp * A pointer to an instance of JSFreeOp.
    status JSFinalizeStatus One of the JSFinalizeStatus constants, described below, indicating the stage of finalize.
    isCompartment bool false if all compartments are being collected, true if a compartment is being collected.
    data void * data parameter specified in JS_AddFinalizeCallback. Added in SpiderMonkey 38
    Name Description
    JSFINALIZE_GROUP_START Called when preparing to sweep a group of compartments, before anything has been swept. The collector will not yield to the mutator before calling the callback with JSFINALIZE_GROUP_END status.
    JSFINALIZE_GROUP_END Called when preparing to sweep a group of compartments. Weak references to unmarked things have been removed and things that are not swept incrementally have been finalized at this point. The collector may yield to the mutator after this point.
    JSFINALIZE_COLLECTION_END Called at the end of collection when everything has been swept.

    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

    Document Tags and Contributors

    Tags: 
     Contributors to this page: kscarfone, arai
     Last updated by: kscarfone,