FileSystemWritableFileStream: write()-Methode

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.

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.

// 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