JS_EvaluateScript 编辑

Obsolete since JSAPI 36
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.

Compile and execute a script.

Syntax

JSBool
JS_EvaluateScript(JSContext *cx, JSObject *obj,
    const char *src, unsigned int length, const char *filename,
    unsigned int lineno, jsval *rval);

JSBool
JS_EvaluateUCScript(JSContext *cx, JSObject *obj,
    const jschar *src, unsigned int length, const char *filename,
    unsigned int lineno, jsval *rval);

Description

JS_EvaluateScript compiles and executes a script in the specified scope, obj. JS_EvaluateUCScript is the Unicode version of the function.

src is the string containing the text of the script. length indicates the size of the text version of the script in characters.

filename is the name of the file (or URL) containing the script. This information is used in messages if an error occurs during compilation. Similarly, lineno is used to report the line number of the script or file where an error occurred during compilation.

rval is an optional out parameter. If it is non-null, then on success, the result value is stored in *rval. This value is determined the same way as for the standard eval function. In the common case where the script is just an expression, the result value is simply the value of that expression. More generally, the result value is the value of the last-executed expression statement in the script that isn't in a function.

If a script compiles and executes successfully, JS_EvaluateScript or JS_EvaluateUCScript stores the result in *rval, if non-null, and returns JS_TRUE. Otherwise it returns JS_FALSE and the value left in *rval is undefined.

See Also

• MXR ID Search for JS_EvaluateScript
• MXR ID Search for JS_EvaluateUCScript
• JS_CompileFile
• JS_CompileScript
• JS_DecompileScript
• JS_DestroyScript
• JS_EvaluateScriptForPrincipals
• bug 1100579