Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

FileSystemEntry: remove()-Methode

Deprecated

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

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 unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die Methode remove() des FileSystemEntry-Interfaces löscht die Datei oder das Verzeichnis aus dem Dateisystem. Verzeichnisse müssen leer sein, bevor sie entfernt werden können.

Um ein Verzeichnis sowie alle seine Inhalte und Unterverzeichnisse rekursiv zu entfernen, rufen Sie stattdessen FileSystemDirectoryEntry.removeRecursively() auf.

Syntax

js
remove(successCallback)
remove(successCallback, errorCallback)

Parameter

successCallback

Eine Funktion, die aufgerufen wird, wenn die Datei erfolgreich entfernt wurde.

errorCallback Optional

Ein optionaler Rückruf, der aufgerufen wird, wenn der Versuch, die Datei zu entfernen, fehlschlägt.

Rückgabewert

Keiner (undefined).

Ausnahmen

DOMException.INVALID_MODIFICATION_ERR

Der angegebene Eintrag war das Stammverzeichnis des Dateisystems, oder der angegebene Eintrag ist ein Verzeichnis, das nicht leer ist.

DOMException.INVALID_STATE_ERR

Der zwischengespeicherte Status des Dateisystems ist inkonsistent mit seinem Status auf der Festplatte, sodass die Datei aus Sicherheitsgründen nicht gelöscht werden konnte.

DOMException.NO_MODIFICATION_ALLOWED_ERR

Der Zustand des Dateisystems erlaubt das Entfernen der Datei oder des Verzeichnisses nicht.

DOMException.NOT_FOUND_ERR

Die Datei oder das Verzeichnis existiert nicht.

DOMException.SECURITY_ERR

Der Eintrag konnte aufgrund von Berechtigungen oder anderen Zugriffsbeschränkungen nicht entfernt werden oder weil zu viele Aufrufe auf Dateiresourcen gemacht werden.

Beispiele

Dieses Beispiel löscht eine temporäre Arbeitsdatei.

js
workingDirectory.getFile(
  "tmp/work-file.json",
  {},
  (fileEntry) => {
    fileEntry.remove(() => {
      /* the file was removed successfully */
    });
  },
  handleError,
);

Browser-Kompatibilität

Siehe auch