Spec-Zone.ru › Web APIs

FileSystemDirectoryReader: метод readEntries()

Метод FileSystemDirectoryReader интерфейса readEntries() извлекает записи каталога, который читается, и предоставляет их в виде массива предоставленной функции обратного вызова.

Объекты в массиве основаны на FileSystemEntry. Обычно это объекты FileSystemFileEntry, представляющие стандартные файлы, или объекты FileSystemDirectoryEntry, представляющие каталоги.

Синтаксис

readEntries(successCallback)
readEntries(successCallback, errorCallback)

Параметры

successCallback

Функция, которая вызывается, когда содержимое каталога было получено. Функция получает один входной параметр: массив объектов записи файловой системы, каждый из которых основан на FileSystemEntry. Обычно это объекты FileSystemFileEntry, представляющие стандартные файлы, или объекты FileSystemDirectoryEntry, представляющие каталоги. Если файлов больше нет или вы уже вызвали readEntries() для этого FileSystemDirectoryReader, массив пустой.

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

Функция обратного вызова, которая вызывается, если при чтении из каталога произошла ошибка. Она принимает один входной параметр: объект DOMException, описывающий произошедшую ошибку.

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

None (undefined).

Примеры

См. DataTransferItem.webkitGetAsEntry() для примера кода, использующего этот метод.

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

Спецификация
API файлов и каталогов
# dom-filesystemdirectoryreader-readentries

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

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

В Chrome 77 readEntries() вернет только первые 100 FileSystemEntry экземпляров. Чтобы получить все экземпляры, readEntries() необходимо вызвать несколько раз.

См. также

  • API файлов и каталогов
  • Введение в API файлов и каталогов
  • FileSystemDirectoryEntry
  • FileSystem

© 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/FileSystemDirectoryReader/readEntries

Spec-Zone.ru

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