FileSystemDirectoryHandle: removeEntry() Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die removeEntry()-Methode der FileSystemDirectoryHandle-Schnittstelle versucht, einen Eintrag zu entfernen, wenn der Verzeichnis-Handle eine Datei oder ein Verzeichnis mit dem angegebenen Namen enthält.
Syntax
removeEntry(name)
removeEntry(name, options)
Parameter
name-
Ein String, der den
FileSystemHandle.namedes zu entfernenden Eintrags darstellt. optionsOptional-
Ein optionales Objekt, das Optionen enthält, die wie folgt sind:
recursiveOptional-
Ein boolescher Wert, der standardmäßig auf
falsegesetzt ist. Wenn auftruegesetzt, werden Einträge rekursiv entfernt.
Rückgabewert
Ein Promise, das mit undefined aufgelöst wird.
Ausnahmen
TypeError-
Ausgelöst, wenn der Name kein gültiger String ist oder Zeichen enthält, die im Dateisystem nicht erlaubt sind.
NotAllowedErrorDOMException-
Ausgelöst, wenn der
PermissionStatus.statefür den Handle imreadwrite-Modus nicht'granted'ist. InvalidModificationErrorDOMException-
Ausgelöst, wenn
recursiveauf false gesetzt ist und der zu entfernende Eintrag untergeordnete Elemente hat. NotFoundErrorDOMException-
Ausgelöst, wenn der aktuelle Eintrag nicht gefunden wird oder wenn der Eintrag mit dem spezifischen Namen nicht gefunden oder übereinstimmt.
Beispiele
Das folgende Beispiel entfernt einen Eintrag innerhalb des Verzeichnis-Handles.
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 # api-filesystemdirectoryhandle-removeentry |
Browser-Kompatibilität
Loading…