DirectoryEntrySync

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern untersttzt werden und sich in Zukunft ndern oder entfernt werden knnen. Unter Umstnden kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die DirectoryEntrySync-Schnittstelle reprsentiert ein Verzeichnis in einem Dateisystem. Sie enthlt Methoden zum Erstellen, Lesen, Suchen und rekursiven Entfernen von Dateien in einem Verzeichnis.

Warnung: Diese Schnittstelle ist veraltet und befindet sich nicht mehr auf dem Standardweg. Verwenden Sie sie nicht mehr. Verwenden Sie stattdessen die File and Directory Entries API.

Grundlegende Konzepte

Wenn Sie Unterverzeichnisse erstellen mchten, mssen Sie jedes Unterverzeichnis nacheinander erstellen. Wenn Sie versuchen, ein Verzeichnis mit einem vollstndigen Pfad zu erstellen, der bergeordnete Verzeichnisse enthlt, die noch nicht existieren, erhalten Sie einen Fehler. Erstellen Sie also die Hierarchie, indem Sie rekursiv einen neuen Pfad hinzufgen, nachdem Sie das bergeordnete Verzeichnis erstellt haben.

Beispiel

Die Methode getFile() gibt ein FileEntrySync zurck, das eine Datei im Dateisystem darstellt. Folgendes erstellt eine leere Datei namens logs.txt im Stammverzeichnis.

const fileEntry = fs.root.getFile("logs.txt", { create: true });

Die Methode getDirectory() gibt ein DirectoryEntrySync zurck, das ein Verzeichnis im Dateisystem darstellt. Folgendes erstellt ein neues Verzeichnis namens project_dir im Stammverzeichnis.

const dirEntry = fs.root.getDirectory("project_dir", { create: true });

Methodenbersicht

createReader()
getFile()
getDirectory()
removeRecursively()

Instanzmethoden

createReader()

Erstellt einen neuen DirectoryReaderSync, um Eintrge aus diesem Verzeichnis zu lesen.

Syntax

createReader()

Parameter

Keine.

Rckgabewert

Ein DirectoryReaderSync-Objekt, das ein Verzeichnis in einem Dateisystem darstellt.

Ausnahmen

Diese Methode kann eine DOMException mit den folgenden Codes auslsen:

Ausnahme	Beschreibung
`NOT_FOUND_ERR`	Das Verzeichnis existiert nicht.
`SECURITY_ERR`	Der Browser hat festgestellt, dass es nicht sicher war, die Metadaten abzurufen. [todo: Erklren, warum]

getFile()

Abhngig davon, wie Sie den options-Parameter festgelegt haben, erstellt die Methode entweder eine Datei oder sucht eine vorhandene Datei.

Syntax

getFile(path)
getFile(path, options)

Parameter

path: Entweder ein absoluter Pfad oder ein relativer Pfad vom Verzeichnis zur zu suchenden oder zu erstellenden Datei. Sie knnen keine Datei erstellen, deren unmittelbarer Elternknoten nicht existiert. Erstellen Sie zuerst das bergeordnete Verzeichnis.
options: (optional) Ein Objektliteral, das das Verhalten der Methode beschreibt. Wenn die Datei nicht existiert, wird sie erstellt.

Objektliteral	Bedingung	Ergebnis
`create: true` `exclusive: true`	Pfad existiert bereits	Ein Fehler wird ausgelst.
`create: true` `exclusive: false`	Pfad existiert nicht und es tritt kein anderer Fehler auf	Eine Datei wird erstellt. Wenn bereits eine Datei existiert, tritt kein Fehler auf.
`create: false` (`exclusive` wird ignoriert)	Pfad existiert	Die Datei wird zurckgegeben.
`create: false` (`exclusive` wird ignoriert)	Pfad existiert nicht	Ein Fehler wird ausgelst.
`create: false` (`exclusive` wird ignoriert)	Pfad existiert, ist jedoch ein Verzeichnis	Ein Fehler wird ausgelst.

Rckgabewert

Ein FileEntrySync-Objekt, das eine Datei in einem Dateisystem darstellt.

Ausnahmen

Diese Methode kann eine DOMException mit den folgenden Codes auslsen:

Ausnahme	Beschreibung
`ENCODING_ERR`	Der angegebene Pfad ist ungltig.
`NOT_FOUND_ERR`	Der Pfad war strukturell korrekt, bezieht sich jedoch auf eine Ressource, die nicht existiert.
`NO_MODIFICATION_ALLOWED_ERR`	Dies ist ein Berechtigungsproblem. Das Zielverzeichnis oder die Datei ist nicht beschreibbar.
`PATH_EXISTS_ERR`	Die Datei existiert bereits. Es kann keine weitere mit dem gleichen Pfad erstellt werden.
`QUOTA_EXCEEDED_ERROR`	Die Operation wrde dazu fhren, dass die Anwendung ihr Speicherkontingent berschreitet.
`SECURITY_ERR`	Die Anwendung hat keine Berechtigung, auf das durch den Pfad referenzierte Element zuzugreifen. [todo: Erklren, warum]
`TYPE_MISMATCH_ERR`	Der angegebene Pfad existiert, aber es ist kein Verzeichnis.

getDirectory()

Erstellt oder sucht ein Verzeichnis. Die Methode ist hnlich wie getFile(), wobei DirectoryEntrySync bergeben wird.

Syntax

getDirectory(path)
getDirectory(path, options)

Parameter

path: Entweder ein absoluter Pfad oder ein relativer Pfad vom Verzeichnis zur zu suchenden oder zu erstellenden Datei. Sie knnen keine Datei erstellen, deren unmittelbarer Elternknoten nicht existiert. Erstellen Sie zuerst das bergeordnete Verzeichnis.
options: (optional) Ein Objektliteral, das das Verhalten der Methode beschreibt, wenn die Datei nicht existiert.

Objektliteral	Bedingung	Ergebnis
`create: true` `exclusive: true`	Pfad existiert bereits	Ein Fehler wird ausgelst.
`create: true` `exclusive: false`	Pfad existiert nicht und es tritt kein anderer Fehler auf	Ein Verzeichnis wird erstellt. Wenn bereits eine Datei existiert, tritt kein Fehler auf.
`create: false` (`exclusive` wird ignoriert)	Pfad existiert	Das Verzeichnis wird zurckgegeben.
`create: false` (`exclusive` wird ignoriert)	Pfad existiert nicht	Ein Fehler wird ausgelst.
`create: false` (`exclusive` wird ignoriert)	Pfad existiert, ist jedoch ein Verzeichnis	Ein Fehler wird ausgelst.

Rckgabewert

Ein DirectoryEntrySync-Objekt, das ein Verzeichnis in einem Dateisystem darstellt.

Ausnahmen

Diese Methode kann eine DOMException mit den folgenden Codes auslsen:

Ausnahme	Beschreibung
`ENCODING_ERR`	Der angegebene Pfad ist ungltig.
`NOT_FOUND_ERR`	Der Pfad war strukturell korrekt, bezieht sich jedoch auf eine Ressource, die nicht existiert.
`NO_MODIFICATION_ALLOWED_ERR`	Dies ist ein Berechtigungsproblem. Das Zielverzeichnis oder die Datei ist nicht beschreibbar.
`PATH_EXISTS_ERR`	Die Datei existiert bereits. Es kann keine weitere mit dem gleichen Pfad erstellt werden.
`QUOTA_EXCEEDED_ERROR`	Die Operation wrde dazu fhren, dass die Anwendung ihr Speicherkontingent berschreitet.
`SECURITY_ERR`	Die Anwendung hat keine Berechtigung, auf das durch den Pfad referenzierte Element zuzugreifen. [todo: Erklren, warum]
`TYPE_MISMATCH_ERR`	Der angegebene Pfad existiert, aber es ist kein Verzeichnis.

removeRecursively()

Lscht ein Verzeichnis und dessen gesamten Inhalt. Sie knnen das Stammverzeichnis eines Dateisystems nicht lschen.

Wenn Sie ein Verzeichnis lschen, das eine Datei enthlt, die nicht entfernt werden kann, oder wenn ein Fehler auftritt, whrend das Lschen im Gange ist, werden mglicherweise einige der Inhalte nicht gelscht. Fangen Sie diese Flle mit Fehler-Callbacks ab und versuchen Sie das Lschen erneut.

Syntax

removeRecursively()

Parameter

Keine.

Rckgabewert

undefined

Ausnahmen

Diese Methode kann eine DOMException mit den folgenden Codes auslsen:

Ausnahme	Beschreibung
`NOT_FOUND_ERR`	Das Zielverzeichnis existiert nicht.
`INVALID_STATE_ERR`	Dieses Verzeichnis ist aus einem anderen als dem Grund des Gelschtseins nicht mehr gltig. [todo: Mehr erklren]
`NO_MODIFICATION_ALLOWED_ERR`	Eines der Folgenden ist nicht beschreibbar: das Verzeichnis, dessen bergeordnetes Verzeichnis und einige der Inhalte im Verzeichnis.
`SECURITY_ERR`	Die Anwendung hat keine Berechtigung, auf das Zielverzeichnis, dessen bergeordnetes Verzeichnis oder einige seiner Inhalte zuzugreifen.

File and Directory Entries API

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

File and Directory Entries API
DirectoryEntrySync
Verwandte Seiten fr File and Directory Entries API