JS_AlreadyHasOwnProperty 编辑

This article covers features introduced in SpiderMonkey 1.8

Determine whether a property is already physically present on a JSObject.

Syntax

boo
JS_AlreadyHasOwnProperty(JSContext *cx, JS::HandleObject obj, const char *name,
                         bool *foundp);

boo
JS_AlreadyHasOwnUCProperty(JSContext *cx, JS::HandleObject obj, const char16_t *name,
                           size_t namelen, bool *foundp);

boo
JS_AlreadyHasOwnPropertyById(JSContext *cx, JS::HandleObject obj, JS::HandleId id,
                             bool *foundp); // Added in SpiderMonkey 1.8.1

boo
JS_AlreadyHasOwnElement(JSContext *cx, JS::HandleObject obj, uint32_t index,
                        bool *foundp);

Description

These functions attempt to determine whether a property already exists on a specific JSObject without modifying the object. By design, this search may not find a property that other property lookup functions, such as JS_LookupProperty, would find.

For native objects—objects whose properties are stored in the default data structure provided by SpiderMonkey—these functions simply check that data structure to see if the specified field is present. They do not search anywhere else for the property. This means that:

• The prototype chain of obj is not searched.
• The object's JSClass.resolve hook is not called, so lazily defined properties are not found. (This is the only API that can directly detect that a lazily resolved property has not yet been resolved.)
• Shared, permanent, delegated properties are not found. (Such properties are an implementation detail of SpiderMonkey. They are meant to be a transparent optimization; this is the only API that breaks the abstraction.)

For non-native objects, this falls back on a complete search. This calls the JSObjectOps.lookupProperty hook. *foundp is set to true only if lookupProperty reports that the property was found on obj itself and not on some other object (even the corresponding outer object, if any).

If the property is found on obj, this sets *foundp to true and returns true.

If the property is not found on obj, this sets *foundp to false and returns true (to indicate that no error occurred).

If the search fails with an error or exception, this returns false.

See Also

• MXR ID Search for JS_AlreadyHasOwnProperty
• MXR ID Search for JS_AlreadyHasOwnUCProperty
• MXR ID Search for JS_AlreadyHasOwnPropertyById
• MXR ID Search for JS_AlreadyHasOwnElement
• bug 400793
• bug 461163