Spec-Zone.ru › Web APIs

FileSystemFileEntry: метод file()

Метод интерфейса FileSystemFileEntry file() возвращает объект File, который можно использовать для чтения данных из файла, представленного этим элементом каталога.

Синтаксис

file(successCallback)
file(successCallback, errorCallback)

Параметры

successCallback

Функция обратного вызова, которая вызывается, когда File был успешно создан; File передаётся в функцию обратного вызова в качестве единственного параметра.

errorCallback Необязательно

Если указана, эта функция вызывается при возникновении ошибки во время попытки создать File. В качестве входного параметра этот обратный вызов получает объект DOMException, описывающий ошибку.

Возвращаемое значение

None (undefined).

Примеры

В этом примере создаётся метод readFile(), который считывает текстовый файл и вызывает указанную функцию обратного вызова с полученным текстом (в строковом формате), как только чтение завершится. Если произойдёт ошибка, вызывается указанная (необязательная) функция обратного вызова ошибки.

function readFile(entry, successCallback, errorCallback) {
  entry.file((file) => {
    let reader = new FileReader();

    reader.onload = () => {
      successCallback(reader.result);
    };

    reader.onerror = () => {
      errorCallback(reader.error);
    };

    reader.readAsText(file);
  }, errorCallback);
}

Эта функция вызывает file(), задавая в качестве функции обратного вызова успех метод, который переходит к использованию FileReader для чтения файла как текста. Обработчик события load объекта FileReader настроен так, чтобы передавать загруженную строку в функцию обратного вызова successCallback , указанную при вызове метода readFile(); аналогичным образом, его обработчик события error настроен так, чтобы вызвать функцию обратного вызова ошибки errorCallback.

Спецификации

Спецификация
API для элементов файлов и каталогов
# dom-filesystemfileentry-file

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
file 8 79 50 15 11.1 18 50 14 11.3 1.0 ≤37

См. также

  • API для элементов файлов и каталогов
  • Введение в API для элементов файлов и каталогов

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemFileEntry/file

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API