[page:Loader] →

# [name]

使用XMLHttpRequest来加载资源的低级类，并由大多数加载器内部使用。 它也可以直接用于加载任何没有对应加载器的文件类型。

## 例子

[example:webgl_loader_msgpack WebGL / loader / msgpack]
[example:webgl_morphtargets_human WebGL / morphtargets / human]

`var loader = new THREE.FileLoader(); //加载一个文本文件，并把结果输出到控制台上 loader.load( // resource URL 'example.txt', // onLoad回调 function ( data ) { // output the text to the console console.log( data ) }, // onProgress回调 function ( xhr ) { console.log( (xhr.loaded / xhr.total * 100) + '% loaded' ); }, // onError回调 function ( err ) { console.error( 'An error happened' ); } );`

注意: 必须启用缓存 `THREE.Cache.enabled = true;` 这是一个全局属性，只需要设置一次，供内部使用FileLoader的所有加载器使用。 [page:Cache Cache] 是​​一个缓存模块，用于保存通过此加载器发出的每个请求的响应，因此每个文件都会被请求一次。

## 构造函数

### [name] ( [param:LoadingManager manager] )

[page:LoadingManager manager] — [page:LoadingManager loadingManager] 是加载器所使用的加载管理器。 默认为 [page:DefaultLoadingManager].

## 属性

共有属性请参见其基类[page:Loader]。

### [property:String mimeType]

详情 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType]. 请参考 [page:.setMimeType]。默认为 *undefined*。

### [property:object requestHeader]

[link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header] 在HTTP 请求中使用。 请参考 [page:.setRequestHeader]。 默认为 *undefined*.

### [property:String responseType]

请求的响应类型。 请参考 [page:.setResponseType]. 默认为 *undefined*.

### [property:String withCredentials]

XMLHttpRequest是否使用证书。 请参考 [page:.setWithCredentials]. 默认为 *undefined*.

## 方法

共有方法请参见其基类[page:Loader]。

### [method:null load]( [param:String url], [param:Function onLoad], [param:Function onProgress], [param:Function onError] )

[page:String url] — 文件的URL或者路径，也可以为 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URI].
[page:Function onLoad] (可选) — 加载完成时将调用。回调参数将是加载的响应。
[page:Function onProgress] (可选) — 将在加载过程中进行调用。参数将是XMLHttpRequest实例， 其中包含 [page:Integer total] 和 [page:Integer loaded] 字节
[page:Function onError] (可选) — 在加载错误时被调用。
加载URL并将响应传递给onLoad函数。

### [method:FileLoader setMimeType]( [param:String mimeType] )

设置正在加载的文件预期类型 [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types mimeType] 。请注意，在许多情况下，这将自动确定，因此默认情况下它是 *undefined* 。

### [method:FileLoader setRequestHeader]( [param:object requestHeader] )

[page:object requestHeader] - key: 要设置header的名称。 value：要设置header的值。
请参考在HTTP 请求中的 [link:https://developer.mozilla.org/en-US/docs/Glossary/Request_header request header]。

### [method:FileLoader setResponseType]( [param:String responseType] )

改变响应的类型，其类型有效值如下:
[page:String text] 或者空 string (默认) - 返回的数据类型为 [page:String string].
[page:String arraybuffer] - 加载的数据类型到一个数组buffer中 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer ArrayBuffer] 并进行返回。
[page:String blob] - 返回的数据为 [link:https://developer.mozilla.org/en/docs/Web/API/Blob Blob]。
[page:String document] - 使用 [link:https://developer.mozilla.org/en-US/docs/Web/API/DOMParser DOMParser] 解析文件。
[page:String json] - 将文件解析为 [link:https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse JSON.parse].

### [method:FileLoader setWithCredentials]( [param:Boolean value] )

XMLHttpRequest是否使用cookie、授权头或TLS客户端证书等凭据。 请参考 [link:https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials XMLHttpRequest.withCredentials].
请注意，当您在本地或从同一域加载文件，则该方法无效。

## 源

[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]