JS_EvaluateScriptForPrincipals 编辑

Obsolete since JSAPI 30
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 security-enabled script.

Syntax

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

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

JSBool
JS_EvaluateScriptForPrincipalsVersion(JSContext *cx, JSObject *obj,
    JSPrincipals *principals, const char *bytes, unsigned int length,
    const char *filename, unsigned int lineno, jsval *rval, JSVersion version);

JSBool
JS_EvaluateUCScriptForPrincipalsVersion(JSContext *cx, JSObject *obj,
    JSPrincipals *principals, const jschar *chars, unsigned int length,
    const char *filename, unsigned int lineno, jsval *rval, JSVersion version);

Description

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

principals is a pointer to the JSPrincipals structure that contains the security information to associate with this script.

src is the string containing the text of the script. length is the length 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.

If the script compiles and executes successfully, *rval receives the value from the last-executed expression statement processed in the script, and JS_EvaluateScriptForPrincipals or JS_EvaluateUCScriptForPrincipals returns JS_TRUE. Otherwise it returns JS_FALSE, and the value left in *rval is undefined.

See Also

• JS::Evaluate
• JS_CompileFile
• JS_CompileScriptForPrincipals
• JS_EvaluateScript
• bug 980180