Loader →

FileLoader

Класс низкого уровня для загрузки ресурсов с помощью XMLHttpRequest, используемый внутри большинства загрузчиков. Он также может быть использован непосредственно для загрузки файлов любого типа, для которых нет загрузчика.

Пример


    const loader = new v3d.FileLoader();

    //load a text file and output the result to the console
    loader.load(
      // resource URL
      'example.txt',

      // onLoad callback
      function(data) {
        // output the text to the console
        console.log(data)
      },

      // onProgress callback
      function(xhr) {
        console.log((xhr.loaded / xhr.total * 100) + '% loaded');
      },

      // onError callback
      function(err) {
        console.error('An error happened');
      }
    );

Примечание: Кэш должен быть включен с помощью v3d.Cache.enabled = true; Это глобальное свойство, и его нужно установить только один раз, чтобы оно использовалось всеми загрузчиками, которые используют FileLoader внутри. Cache — это модуль кэша, который хранит ответ от каждого запроса, сделанного через этот загрузчик, поэтому каждый файл запрашивается один раз.

Конструктор

FileLoader (manager : LoadingManager)

manager — loadingManager для использования загрузчиком. По умолчанию DefaultLoadingManager.

Свойства

Общие свойства см. в базовом классе Loader.

# .mimeType : String

Ожидаемый mimeType. См. .setMimeType. По умолчанию undefined.

# .responseType : String

Ожидаемый тип отклика. См. .setResponseType. По умолчанию undefined.

Методы

Общие методы см. в базовом классе Loader.

# .load(url : String, onLoad : Function, onProgress : Function, onError : Function) → XMLHttpRequest

url — путь или URL-адрес к файлу. Это также может быть Data URI.
onLoad (optional) — Вызывается по завершении загрузки. Аргументом будет загруженный ответ.
onProgress (optional) — Будет вызываться во время загрузки. Аргументом будет экземпляр XMLHttpRequest, который содержит байты .total и .loaded.
onError (optional) — Будет вызван, если произошла ошибка.

Загрузите URL и передайте отклик в функцию onLoad.

# .setMimeType(mimeType : String) → FileLoader

Установите ожидаемый mimeType загружаемого файла. Обратите внимание, что во многих случаях оно будет определяться автоматически, поэтому по умолчанию оно undefined.

# .setResponseType(responseType : String) → FileLoader

Изменение типа отклика. Допустимыми значениями являются:
text или пустая строка (по умолчанию) - возвращает данные в виде String.
arraybuffer — загружает данные в ArrayBuffer и возвращает их.
blob — возвращает данные в виде Blob.
document — разбирает файл, используя DOMParser.
json — разбирает файл, используя JSON.parse.

Исходный файл

О том как получить исходный код этого модуля читайте тут.