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
FileSystemEntrybasieren. Im Allgemeinen sind sie entwederFileSystemFileEntry-Objekte, die Standarddateien repräsentieren, oderFileSystemDirectoryEntry-Objekte, die Verzeichnisse darstellen. Wenn keine Dateien mehr vorhanden sind oder Sie bereitsreadEntries()auf diesemFileSystemDirectoryReaderaufgerufen haben, ist das Array leer. errorCallbackOptional-
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
| Specification |
|---|
| File and Directory Entries API # dom-filesystemdirectoryreader-readentries |
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.