JS_DefineFunctions 编辑

Add native methods to an object.

Syntax

bool
JS_DefineFunctions(JSContext *cx, JS::Handle<JSObject*> obj,
                   const JSFunctionSpec *fs,
                   PropertyDefinitionBehavior behavior = DefineAllProperties);

In SpiderMonkey versions prior to SpiderMonkey 24, fs was not const.

enum PropertyDefinitionBehavior {
    DefineAllProperties,
    OnlyDefineLateProperties,
    DontDefineLateProperties
};

Description

JS_DefineFunctions creates zero or more functions and makes them properties (methods) of a specified object, obj, as if by calling JS_DefineFunction repeatedly.

fs is a pointer to the first element of an array of JSFunctionSpec records. This array is usually defined as a static global, with each record initialized using JS_FS or JS_FN. Each array element defines a single function: its name, the native C/C++ implementation, the number of JavaScript arguments the function expects, and any property attributes. The last element of the array must contain 0 values. (The macro JS_FS_END can be used for the last element.) JS_DefineFunctions creates one function for each non-zero element in the array.

PropertyDefinitionBehavior is used to select if properties with JSPROP_DEFINE_LATE flag should be defined on the object. Normal JSAPI consumers probably always want DefineAllProperties here.

On success, JS_DefineFunctions returns true. On error or exception, it stops defining functions and returns false.

See Also

• MXR ID Search for JS_DefineFunctions
• JS_CallFunctionName
• JS_DefineObject
• JS_DefineProperties
• JS_NewFunction
• bug 959787 - make fs type to const
• bug 825199 - added PropertyDefinitionBehavior