FileSystemDirectoryReader: readEntries()-Methode

Die readEntries()-Methode der FileSystemDirectoryReader-Schnittstelle ruft die Verzeichniseinträge innerhalb des gelesenen Verzeichnisses ab und liefert sie in einem Array an eine bereitgestellte Callback-Funktion.

Die Objekte im Array basieren alle auf FileSystemEntry. Im Allgemeinen sind sie entweder FileSystemFileEntry-Objekte, die normale Dateien repräsentieren, oder FileSystemDirectoryEntry-Objekte, die Verzeichnisse darstellen.

Syntax

js
readEntries(successCallback)
readEntries(successCallback, errorCallback)

Parameter

successCallback

Eine Funktion, die aufgerufen wird, wenn die Inhalte des Verzeichnisses abgerufen wurden. Die Funktion erhält einen einzelnen Eingabeparameter: ein Array von Dateisystemeintragsobjekten, die jeweils auf FileSystemEntry basieren. Im Allgemeinen sind sie entweder FileSystemFileEntry-Objekte, die normale Dateien repräsentieren, oder FileSystemDirectoryEntry-Objekte, die Verzeichnisse darstellen. Wenn keine Dateien mehr vorhanden sind oder Sie bereits readEntries() auf diesem FileSystemDirectoryReader aufgerufen haben, ist das Array leer.

errorCallback Optional

Eine Callback-Funktion, die aufgerufen wird, wenn ein Fehler beim Lesen aus dem Verzeichnis auftritt. Sie erhält einen Eingabeparameter: ein DOMException-Objekt, das den aufgetretenen Fehler beschreibt.

Rückgabewert

Keiner (undefined).

Beispiele

Sehen Sie sich DataTransferItem.webkitGetAsEntry() für Beispielcode an, der diese Methode verwendet.

Spezifikationen

Specification
File and Directory Entries API
# dom-filesystemdirectoryreader-readentries

Browser-Kompatibilität

BCD tables only load in the browser

Ab Chrome 77 gibt readEntries() nur die ersten 100 FileSystemEntry-Instanzen zurück. Um alle Instanzen zu erhalten, muss readEntries() mehrfach aufgerufen werden.

Siehe auch