This article needs a technical review. How you can help.
JSTraceOp is the type of the JSClass.trace.
Syntax
typedef void (* JSTraceOp)(JSTracer *trc, JSObject *obj);
| Name | Type | Description |
|---|---|---|
trc |
JSTracer * |
The tracer visiting obj. |
obj |
JSObject * |
The object being visited. |
Description
JSTraceOp is the function type for trace operation of the class called to enumerate all traceable things reachable from obj's private data structure. For each such thing, a trace implementation must call one of the JS_Call*Tracer variants on the thing.
JSTraceOp implementation can assume that no other threads mutates object state. It must not change state of the object or corresponding native structures. The only exception for this rule is the case when the embedding needs a tight integration with GC. In that case the embedding can check if the traversal is a part of the marking phase through calling JS_IsGCMarkingTracer and apply a special code like emptying caches or marking its native structures.
JSClass hooks
JSClass offers the following hook:
-
The
JSClass.tracecallback is called to enumerate all traceable things reachable.