Loader

Abstract base class for loaders.

Constructor

(abstract) new Loader(manageropt)

Constructs a new Loader.

Parameters:
NameTypeAttributesDefaultDescription
managerLoadingManager<optional>
DefaultLoadingManager

The loading manager.

Members

crossOrigin :string

The crossOrigin string to implement CORS for loading the url from a different domain that allows CORS.

Type:
  • string
Default Value
  • 'anonymous'

manager :LoadingManager

The loading manager.

Default Value
  • DefaultLoadingManager

path :string

The base path from which the asset will be loaded.

Type:
  • string
Default Value
  • ''

requestHeader :object

The request header used in HTTP request.

Type:
  • object
Default Value
  • {}

withCredentials :boolean

Whether the XMLHttpRequest uses credentials.

Type:
  • boolean
Default Value
  • false

Methods

load(url, onLoad, onProgressopt, onErroropt)

This method needs to be implement by all concrete loaders. It holds the logic for loading the asset from the backend.

Parameters:
NameTypeAttributesDescription
urlstring

The path/URL of the file to be loaded.

onLoadfunction

Executed when the loading process has been finished.

onProgressonProgressCallback<optional>

Executed while the loading is in progress.

onErroronErrorCallback<optional>

Executed when errors occur.

loadAsync(url, onProgressopt) → {Promise}

A async version of Loader#load.

Parameters:
NameTypeAttributesDescription
urlstring

The path/URL of the file to be loaded.

onProgressfunction<optional>

Executed while the loading is in progress.

Returns:

A Promise that resolves when the asset has been loaded.

Type: 
Promise

setCrossOrigin(crossOrigin) → {Loader}

Sets the crossOrigin String to implement CORS for loading the URL from a different domain that allows CORS.

Parameters:
NameTypeDescription
crossOriginstring

The crossOrigin value.

Returns:

A reference to this instance.

Type: 
Loader

setPath(path) → {Loader}

Sets the base path for the asset.

Parameters:
NameTypeDescription
pathstring

The base path.

Returns:

A reference to this instance.

Type: 
Loader

setRequestHeader(requestHeader) → {Loader}

Sets the given request header.

Parameters:
NameTypeDescription
requestHeaderobject

A request header for configuring the HTTP request.

Returns:

A reference to this instance.

Type: 
Loader

setWithCredentials(value) → {Loader}

Whether the XMLHttpRequest uses credentials such as cookies, authorization headers or TLS client certificates, see XMLHttpRequest.withCredentials. Note: This setting has no effect if you are loading files locally or from the same domain.

Parameters:
NameTypeDescription
valueboolean

The withCredentials value.

Returns:

A reference to this instance.

Type: 
Loader