JS::Compile 编辑

This article covers features introduced in SpiderMonkey 17

Compile a script for execution.

Syntax

// Added in SpiderMonkey 45

bool
JS::Compile(JSContext *cx,
            const JS::ReadOnlyCompileOptions &options,
            JS::SourceBufferHolder &srcBuf, JS::MutableHandleScript script);

bool
JS::Compile(JSContext *cx,
            const JS::ReadOnlyCompileOptions &options,
            const char *bytes, size_t length, JS::MutableHandleScript script);

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

bool
JS::Compile(JSContext *cx,
            const JS::ReadOnlyCompileOptions &options, FILE *file,
            JS::MutableHandleScript script);

bool
JS::Compile(JSContext *cx,
            const JS::ReadOnlyCompileOptions &options, const char *filename,
            JS::MutableHandleScript script);

// Obsolete since JSAPI 39

bool
JS::Compile(JSContext *cx, JS::HandleObject obj,
            const JS::ReadOnlyCompileOptions &options,
            JS::SourceBufferHolder &srcBuf, JS::MutableHandleScript script);

bool
JS::Compile(JSContext *cx, JS::HandleObject obj,
            const JS::ReadOnlyCompileOptions &options,
            const char *bytes, size_t length, JS::MutableHandleScript script);

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

bool
JS::Compile(JSContext *cx, JS::HandleObject obj,
            const JS::ReadOnlyCompileOptions &options, FILE *file,
            JS::MutableHandleScript script);

bool
JS::Compile(JSContext *cx, JS::HandleObject obj,
            const JS::ReadOnlyCompileOptions &options, const char *filename,
            JS::MutableHandleScript script);

Description

JS::Compile compiles a script, srcBuf, chars, bytes, or file, for execution.

The script is associated with a JS object. srcBuf, chars, bytes is the string containing the text of the script. length indicates the size of the text version of the script in characters.

file is the filehandle containing the text of the script.

filename is the name of the file (or URL) containing the script. This information is included in error messages if an error occurs during compilation..

On success, JS::Compile stores an object representing the newly compiled script into script, and returns true. Otherwise, it returns false and the value left in script is undefined.

See Also

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