FileSystemDirectoryReader: Methode readEntries()

Die readEntries()-Methode des FileSystemDirectoryReader-Interfaces ruft die Verzeichniseinträge innerhalb des zu lesenden 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 darstellen.

Syntax

readEntries(successCallback)
readEntries(successCallback, errorCallback)

Parameter

successCallback

Eine Funktion, die aufgerufen wird, wenn der Inhalt des Verzeichnisses abgerufen wurde. Die Funktion erhält ein einzelnes Eingabeparameter: ein Array von Dateisystemeintragsobjekten, die alle auf FileSystemEntry basieren. Im Allgemeinen sind sie entweder FileSystemFileEntry-Objekte, die Standarddateien 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 beim Lesen aus dem Verzeichnis ein Fehler auftritt. Sie erhält ein 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

Browser-Kompatibilität

In Browsern, die auf Chromium basieren, gibt readEntries() nur die ersten 100 FileSystemEntry-Instanzen zurück. Um alle Instanzen zu erhalten, muss readEntries() mehrfach aufgerufen werden.

Siehe auch

• File and Directory Entries API
• FileSystemDirectoryEntry
• FileSystem