FileSystemWritableFileStream

Die FileSystemWritableFileStream-Schnittstelle der File System API ist ein WritableStream-Objekt mit zusätzlichen Komfortmethoden, das auf einer einzelnen Datei auf der Festplatte arbeitet. Auf die Schnittstelle wird über die FileSystemFileHandle.createWritable()-Methode zugegriffen.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem übergeordneten Element WritableStream.

Instanz-Methoden

Erbt Methoden von seinem übergeordneten Element WritableStream.

FileSystemWritableFileStream.write()

Schreibt Inhalt in die Datei, auf die die Methode angewendet wird, an der aktuellen Cursorposition der Datei.

FileSystemWritableFileStream.seek()

Aktualisiert die aktuelle Cursorposition der Datei auf die angegebene Position (in Bytes).

FileSystemWritableFileStream.truncate()

Ändert die Größe der Datei, die mit dem Stream verbunden ist, auf die angegebene Größe in Bytes.

Beispiele

Die folgende asynchrone Funktion öffnet den 'Datei speichern'-Dialog, der einen FileSystemFileHandle zurückgibt, sobald eine Datei ausgewählt ist. Daraus wird ein beschreibbarer Stream erstellt, indem die FileSystemFileHandle.createWritable()-Methode verwendet wird.

Ein Textstring wird dann in den Stream geschrieben, der danach geschlossen wird.

async function saveFile() {
 // create a new handle
 const newHandle = await window.showSaveFilePicker();
 // create a FileSystemWritableFileStream to write to
 const writableStream = await newHandle.createWritable();
 // write our file
 await writableStream.write("This is my file content");
 // close the file and write the contents to disk.
 await writableStream.close();
}

Die folgenden Beispiele zeigen verschiedene Optionen, die in die write()-Methode übergeben werden können.

// just pass in the data (no options)
writableStream.write(data);
// writes the data to the stream from the determined position
writableStream.write({ type: "write", position, data });
// updates the current file cursor offset to the position specified
writableStream.write({ type: "seek", position });
// resizes the file to be size bytes long
writableStream.write({ type: "truncate", size });

Spezifikationen

Browser-Kompatibilität

Siehe auch

• File System API
• The File System Access API: simplifying access to local files