JSTraceOp

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.trace callback is called to enumerate all traceable things reachable.

See Also