FileSystemWritableFileStream: write()-Methode

Baseline 2025

Neu verfügbar

Seit September 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die write()-Methode des FileSystemWritableFileStream-Interfaces schreibt Inhalte in die Datei, auf die die Methode aufgerufen wird, an der aktuellen Dateicursor-Position.

Keine Änderungen werden auf die tatsächliche Datei auf der Festplatte geschrieben, bis der Stream geschlossen wurde. Änderungen werden typischerweise stattdessen in eine temporäre Datei geschrieben. Diese Methode kann auch verwendet werden, um zu einem Byte-Punkt innerhalb des Streams zu suchen und ihn zu kürzen, um die Gesamtanzahl der Bytes, die die Datei enthält, zu ändern.

In diesem Artikel

Syntax

write(data)

Parameter

data

Kann eines der folgenden sein:

Die Dateidaten, die in Form eines ArrayBuffer, TypedArray, DataView, Blob oder Strings geschrieben werden sollen.
Ein Objekt, das die folgenden Eigenschaften enthält: type
Ein String, der entweder "write", "seek" oder "truncate" ist.
data
Die Dateidaten, die geschrieben werden sollen. Kann ein ArrayBuffer, TypedArray, DataView, Blob oder String sein. Diese Eigenschaft ist erforderlich, wenn type auf "write" gesetzt ist.
position
Die Byte-Position, zu der der aktuelle Dateicursor bewegt werden soll, wenn type auf "seek" gesetzt ist. Kann auch gesetzt werden, wenn type auf "write" ist, wobei das Schreiben an der angegebenen Position beginnt.
size
Eine Zahl, die die Anzahl der Bytes repräsentiert, die der Stream enthalten soll. Diese Eigenschaft ist erforderlich, wenn type auf "truncate" gesetzt ist.

Rückgabewert

Ein Promise das undefined zurückgibt.

Ausnahmen

NotAllowedError DOMException

Ausgelöst, wenn PermissionStatus.state nicht granted ist.

QuotaExceededError

Ausgelöst, wenn die neue Größe der Datei größer ist als die ursprüngliche Größe der Datei und das Speicherlimit des Browsers überschreitet.

TypeError

Ausgelöst, wenn data undefiniert ist oder wenn position oder size ungültig sind.

Beispiele

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

Ein Textstring wird dann in den Stream geschrieben, welcher anschließend geschlossen wird.

js
async function saveFile() {
  try {
    // 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();
  } catch (err) {
    console.error(err.name, err.message);
  }
}

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

js
// 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 });

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

File System API
FileSystemWritableFileStream
Instanzmethoden
Vererbung
1. WritableStream
Verwandte Seiten für File System API
Anleitungen
1. Origin-Privates-Dateisystem