Compiles a script for execution.
JSObject * JS_CompileScript(JSContext *cx, JSObject *obj, const char *bytes, size_t length, const char *filename, uintN lineno); JSObject * JS_CompileUCScript(JSContext *cx, JSObject *obj, const jschar *chars, size_t length, const char *filename, uintN lineno);
| || ||Pointer to a JS context from which to derive runtime information. Requires request. In a |
| || ||The global object, or |
| || ||String containing the script to compile.|
| || ||The length, in characters, of |
| || ||Name of file or URL containing the function. Used to report filename or URL in error messages.|
| || ||Line number of the first line of |
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.
source 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 included in error 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 is not part of a larger document,
lineno should be
1 (as the first line of a file is universally considered to be line
1, not line
JS_CompileUCScript return an object representing the newly compiled script. Otherwise, they report an error and return
To compile a script from an external file source rather than passing the actual script as an argument, use
The JSAPI User Guide contains example code using compiled scripts.