JS_CompileScript 编辑

Compiles a script for execution.

Syntax

// Added in SpiderMonkey 45

bool
JS_CompileScript(JSContext *cx,
                 const char *ascii, size_t length,
                 const JS::CompileOptions &options,
                 JS::MutableHandleScript script);

bool
JS_CompileUCScript(JSContext *cx,
                   const char16_t *chars, size_t length,
                   const JS::CompileOptions &options,
                   JS::MutableHandleScript script);

// Obsolete since JSAPI 39

bool
JS_CompileScript(JSContext *cx, JS::HandleObject obj,
                 const char *ascii, size_t length,
                 const JS::CompileOptions &options,
                 JS::MutableHandleScript script);

bool
JS_CompileUCScript(JSContext *cx, JS::HandleObject obj,
                   const char16_t *chars, size_t length,
                   const JS::CompileOptions &options,
                   JS::MutableHandleScript script);

Description

JS_CompileScript compiles a script, source, for execution. JS_CompileUCScript is the Unicode version of the function.

The script is associated with a JS object. ascii and chars are the string containing the text of the script. length indicates the size of the text version of the script in characters.

On success, JS_CompileScript and JS_CompileUCScript stores the newly compiled script to *script and returns true. Otherwise, they report an error, stores NULL to *script, and return false.

See Also

• The JSAPI User Guide contains example code using compiled scripts.
• MXR ID Search for JS_CompileScript
• MXR ID Search for JS_CompileUCScript
• JS::Evaluate
• JS::CompileOffThread
• JS::CompileFunction
• JS_ExecuteScript
• JS_DecompileScript
• bug 1143793 -- removed obj parameter