load function can be used with any loader object. They takes a
url and one or more loader objects, checks what type of data that loader prefers to work on (e.g. text, JSON, binary, stream, ...), loads the data in the appropriate way, and passes it to the loader.
load(url : String | File, loaders : Object | Object, options?: object]): Promise.Response
load(url : String | File, options?: Object): Promise.Response
load function is used to load and parse data with a specific loader object. An array of loader objects can be provided, in which case
load will attempt to autodetect which loader is appropriate for the file.
loaders parameter can also be omitted, in which case any loader objects previously registered with
registerLoaders will be used.
url- Urls can be data urls (
data://) or a request (
https://) urls, or a file name (Node.js only). Also accepts
Blobobject (Browser only). Can also accept any format that is accepted by
parse, with the exception of strings that are interpreted as urls.
loaders- can be a single loader or an array of loaders. If single loader is provided, will force to use it. If ommitted, will use the list of pre-registered loaders (see
- Return value depends on the loader category.
urlis not a
- Any path prefix set by
setPathPrefixwill be appended to relative urls.
urland a loader object, checks what type of data that loader prefers to work on (e.g. text, binary, stream, ...), loads the data in the appropriate way, and passes it to the loader.
loadwill work under Node.js as well.
A loader object, that can contain a mix of options:
- options defined by the
parsefunction can be specified.
- options specific to any loaders can also be specified (in loader specific sub-objects).
Please refer to the corresponding documentation page for for
parse and for each loader for details.