FileSystemFileEntry: Methode createWriter()
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 createWriter() des FileSystemFileEntry-Interfaces gibt ein FileWriter-Objekt zurück, das verwendet werden kann, um Daten in die durch den Verzeichniseintrag dargestellte Datei zu schreiben.
Syntax
createWriter(successCallback)
createWriter(successCallback, errorCallback)
Parameter
successCallback-
Eine Callback-Funktion, die aufgerufen wird, wenn der
FileWritererfolgreich erstellt wurde; derFileWriterwird als einziger Parameter an den Callback übergeben. errorCallbackOptional-
Falls angegeben, muss dies eine Methode sein, die aufgerufen wird, wenn ein Fehler auftritt, während versucht wird, den
FileWriterzu erstellen. Dieser Callback erhält einDOMException-Objekt als Eingabe, das den Fehler beschreibt.
Rückgabewert
Keiner (undefined).
Beispiele
Dieses Beispiel definiert eine Methode, writeToFileEntry(), die einen Textstring in die Datei ausgibt, die dem übergebenen Verzeichniseintrag entspricht.
function writeToFileEntry(entry, text) {
entry.createWriter(
(fileWriter) => {
let data = Blob([text], { type: "text/plain" });
fileWriter.write(data);
},
(error) => {
/* do whatever to handle the error */
},
);
}
Der Erfolgscallback für den createWriter()-Aufruf nimmt den übergebenen Text und erstellt ein neues Blob-Objekt vom Typ text/plain, das den übergebenen Text enthält. Dieses Blob wird dann an das FileWriter-Objekt ausgegeben, um in die Datei geschrieben zu werden.
Spezifikationen
Dieses Feature gehört mittlerweile zu keiner Spezifikation mehr. Es ist nicht mehr auf dem Weg, ein Standard zu werden.