Compile a script, reading the source code from a file.


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.


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.

To compile JavaScript code that is already in memory, use


instead. To compile code from a stdio FILE, use



See Also

The JSAPI User Guide contains example code using compiled scripts.

MXR ID Search for JS_CompileFile

JS_CompileScript, JS_DecompileScript, JS_DestroyScript, JS_EvaluateScript, JS_ExecuteScript

Document Tags and Contributors

 Contributors to this page: GeertVL
 Last updated by: GeertVL,