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
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 auftrue
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'
imreadwrite
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.
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