JS_ConvertValue 编辑

Obsolete since JSAPI 38
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

Converts a JavaScript value to a value of a specific JavaScript type.

Syntax

bool
JS_ConvertValue(JSContext *cx, JS::HandleValue v, JSType type, JS::MutableHandleValue vp);

Description

JS_ConvertValue converts a JavaScript value, v, to the specified type. On success, the converted value is stored in *vp. Typically users of this function set vp to point to v, so that if conversion is successful, v now contains the converted value.

JS_ConvertValue calls other, type-specific conversion routines based on the type argument.

• Converting any value to JSTYPE_VOID always succeeds. The result is undefined value.
• Converting to JSTYPE_OBJECT works exactly like JS::ToObject if v.isNullOrUndefined() is false, otherwise the result is nullptr.
• Converting to JSTYPE_FUNCTION works like JS_ValueToFunction, but better: the result is a function object that has not been stripped of its lexical scope. It is safe to call the result (e.g. using JS_CallFunctionValue).
• Converting to JSTYPE_STRING works like JS::ToString.
• Converting to JSTYPE_NUMBER works exactly like JS::ToNumber.
• Converting to JSTYPE_BOOLEAN works exactly like JS::ToBoolean.

On success, JS_ConvertValue stores the converted value in *vp and returns true. On error or exception, it returns false, and the value left in *vp is undefined.

See Also

• MXR ID Search for JS_ConvertValue
• JS_ConvertArguments
• JS_GetTypeName
• JS_TypeOfValue
• bug 1125784