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.
Unregisters a pointer to a GC thing so that it is no longer a member of the garbage collector's root set. This enables any pointed-at GC thing to be garbage collected as needed.
JSBool JS_RemoveRootRT(JSRuntime *rt, void *rp);
||Pointer to the runtime with which the root was registered.|
||Address of the pointer to no longer protect. This must have been passed to one of
JS_RemoveRootRT removes the GC thing that
rp points to from the list of GC things that are protected from garbage collection.
rp is thus a pointer to a pointer to a JS
Object. Do not pass a pointer to a JS double, string, or object -- you must pass a pointer to a pointer or a pointer to a jsval that's a GC thing. The entry for the GC thing
rp points to is removed in the garbage collection hash table for the specified runtime,
JS_RemoveRootRT always returns