FileSystemDirectoryReader: Methode readEntries()

Die Methode readEntries() der Schnittstelle FileSystemDirectoryReader ruft die Verzeichniseinträge innerhalb des gerade 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 Standarddateien repräsentieren, oder FileSystemDirectoryEntry-Objekte, die Verzeichnisse repräsentieren.

Syntax

js
readEntries(successCallback)
readEntries(successCallback, errorCallback)

Parameter

successCallback

Eine Funktion, die aufgerufen wird, wenn der Inhalt des Verzeichnisses abgerufen wurde. Die Funktion erhält einen einzelnen Eingabeparameter: ein Array von Dateisystemeintragsobjekten, die jeweils auf FileSystemEntry basieren. Im Allgemeinen sind sie entweder FileSystemFileEntry-Objekte, die Standarddateien repräsentieren, oder FileSystemDirectoryEntry-Objekte, die Verzeichnisse repräsentieren. Wenn es keine Dateien mehr gibt oder Sie bereits readEntries() für dieses 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

Siehe DataTransferItem.webkitGetAsEntry() für Beispielcode, der diese Methode verwendet.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

In Chrome 77 wird readEntries() nur die ersten 100 FileSystemEntry-Instanzen zurückgeben. Um alle Instanzen zu erhalten, muss readEntries() mehrmals aufgerufen werden.

Siehe auch