FileSystemDirectoryHandle: removeEntry() Methode

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die removeEntry() Methode des FileSystemDirectoryHandle Interface versucht, einen Eintrag zu entfernen, wenn der Verzeichnishandle eine Datei oder ein Verzeichnis mit dem angegebenen Namen enthält.

Syntax

js
removeEntry(name)
removeEntry(name, options)

Parameter

name

Ein String, der den FileSystemHandle.name des Eintrags repräsentiert, den Sie entfernen möchten.

options Optional

Ein optionales Objekt, das Optionen enthält, welche wie folgt sind:

recursive Optional

Ein boolescher Wert, der standardmäßig false ist. Wenn auf true gesetzt, werden Einträge rekursiv entfernt.

Rückgabewert

Ein Promise, der mit undefined aufgelöst wird.

Ausnahmen

TypeError

Wird ausgelöst, wenn der Name kein gültiger String ist oder Zeichen enthält, die im Dateisystem nicht erlaubt sind.

NotAllowedError DOMException

Wird ausgelöst, wenn der PermissionStatus.state für den Handle nicht 'granted' im readwrite Modus ist.

InvalidModificationError DOMException

Wird ausgelöst, wenn recursive auf false gesetzt ist und der zu entfernende Eintrag Kinder hat.

NotFoundError DOMException

Wird ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird oder wenn der spezifische Name nicht gefunden oder abgeglichen wird.

Beispiele

Das folgende Beispiel entfernt einen Eintrag innerhalb des Verzeichnishandles.

js
const entryName = "entryToRemove";

// assuming we have a directory handle: 'currentDirHandle'
currentDirHandle.removeEntry(entryName).then(() => {
  // code to run if removing was successful
});

Spezifikationen

Specification
File System Standard
# api-filesystemdirectoryhandle-removeentry

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch