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.
Спецификации
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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 |
См. также
© 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