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
JSObject * JS_CompileUTF8FileHandle(JSContext *cx, JSObject *obj, const char *filename, FILE *file); JSObject * JS_CompileUTF8FileHandleForPrincipals( JSContext *cx, JSObject *obj, const char *filename, FILE *file, JSPrincipals *principals);
||The context in which to compile the script. Requires request. In a
||Object with which the script is associated.|
||Filename to associate with the compiled script. This filename is used for error messages. It should be the name of the file that contains the script, if available.|
||The file handle containing the script to compile.|
JS_CompileUTF8FileHandle reads a script from a
FileHandleForPrincipals is a version of the function for use with SpiderMonkey's security features.
filename is the name of the file containing the script to compile.
file is the file handle.
JS_CompileUTF8FileHandle does not close the file handle.
principals is non-null, it points to a
JSPrincipals object that is associated with the new script and any functions it creates.
file to EOF and returns an object representing the newly compiled script. If an error occurs during compilation,
FileHandle stops reading from the file and returns
JS_CompileUTF8FileHandleForPrincipals are deprecated, use