Obsolete since JSAPI 19
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 a script, reading the source code from a file.
Syntax
JSObject * JS_CompileUTF8File(JSContext *cx, JSObject *obj, const char *filename);
Name | Type | Description |
---|---|---|
cx |
JSContext * |
The context in which to compile the script. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext . |
obj |
JSObject * |
Object with which the script is associated. |
filename |
const char * |
Name of file containing the script to compile. |
Description
JS_CompileUTF8File
compiles the text of script in an external file location for execution by the JS engine. filename
is the name of the file containing the script to compile.
On success, JS_CompileUTF8File
returns an object that represents the newly compiled script. Otherwise it returns NULL
.
JS_CompileUTF8File
is deprecated, use FILE
, use JS::Compile
instead.
See Also
- The JSAPI User Guide contains example code using compiled scripts.
- MXR ID Search for
JS_CompileFile
JS::Compile
JS_DecompileScript
JS::Evaluate
JS_ExecuteScript
- bug 805080