Window: requestFileSystem() Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

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 nicht standardisierte Window Methode requestFileSystem() ist eine spezifische Methode von Google Chrome, die es einer Webseite oder App ermöglicht, Zugriff auf ein eigenes, Sandkasten-Dateisystem zu erhalten. Das zurückgegebene FileSystem kann dann mit den anderen Dateisystem-APIs genutzt werden.

Hinweis: Diese Methode ist in allen Browsern, die sie implementieren, mit webkit vorangestellt.

Syntax

js
requestFileSystem(type, size, successCallback)
requestFileSystem(type, size, successCallback, errorCallback)

Parameter

type

Der Typ des anzufordernden Speichers. Geben Sie Window.TEMPORARY an, wenn es akzeptabel ist, dass der Browser die Dateien nach eigenem Ermessen löscht, zum Beispiel wenn der Speicherplatz knapp wird, oder Window.PERSISTENT, wenn die Dateien an ihrem Platz bleiben sollen, es sei denn, der Benutzer oder die Website/App erlaubt ausdrücklich das Löschen. Persistenter Speicher erfordert, dass der Benutzer der Seite ein Kontingent zuweist.

size

Die Menge an Speicherplatz, die Sie für die Nutzung Ihrer App bereitgestellt haben möchten.

successCallback

Eine Funktion, die aufgerufen wird, wenn das Dateisystem erfolgreich erlangt wurde. Der Callback erhält ein einzelnes Parameter: ein FileSystem-Objekt, das das Dateisystem darstellt, das die App nutzen darf.

errorCallback Optional

Ein optionaler Parameter, der eine Funktion angibt, die aufgerufen wird, wenn ein Fehler beim Versuch, das Dateisystem zu erhalten, auftritt oder wenn der Benutzer die Erlaubnis zum Erstellen oder Zugreifen auf das Dateisystem verweigert. Der Callback erhält ein einzelnes Parameter: ein DOMException-Objekt, das den Fehler beschreibt.

Rückgabewert

Keiner (undefined).

Spezifikationen

Da diese Methode aus dem File and Directory Entries API-Vorschlag entfernt wurde, gibt es keine offizielle W3C- oder WHATWG-Spezifikation. Sie ist nicht mehr auf dem Weg, ein Standard zu werden.

Browser-Kompatibilität