DieFileSystemWritableFileStream-Schnittstelle derFile System API ist einWritableStream-Objekt mit zusätzlichen Komfortmethoden, das auf einer einzelnen Datei auf der Festplatte arbeitet. Auf die Schnittstelle wird über dieFileSystemFileHandle.createWritable()-Methode zugegriffen.

Instanz-Eigenschaften

Erbt Eigenschaften von seinem übergeordneten ElementWritableStream.

Instanz-Methoden

Erbt Methoden von seinem übergeordneten ElementWritableStream.

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 einenFileSystemFileHandle zurückgibt, sobald eine Datei ausgewählt ist. Daraus wird ein beschreibbarer Stream erstellt, indem dieFileSystemFileHandle.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 diewrite()-Methode übergeben werden können.

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

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