Sets the parent for an object.
||Pointer to a JS context from which to derive runtime information. Requires request. In a
||Pointer to the object for which to set the parent. This must be an object that has not yet been exposed to script. See the Description for details.|
||Pointer to the parent object to use.|
JS_SetParent sets an object's parent.
Each object may have at most one parent, which is another object. Applications that use SpiderMonkey's security features typically use the parent relation to determine both (a) what security principals are attached to the currently executing script; and (b) what security principals are attached to the object being accessed. (For some function objects, the parent chain is also used to implement lexical scoping, but this should be considered an implementation detail.)
Ordinarily an application sets a new object's parent by passing the parent object to
JS_NewObject, and that is the preferred approach. But an application may instead use
JS_SetParent after the object is created.
Applications can get an object's parent using
JS_GetParent. Scripts can determine an object's parent by using the
__parent__ property, but scripts cannot assign to the
JS_SetParent has no way to check that this is the case, but nonetheless, applications must not call
JS_SetParent on an object that has already been exposed to a script. If an application does this, the behavior is undefined.
JS_TRUE. Otherwise, it reports an error or sets an exception and returns