FileSystemWritableFileStream: write() method

Cú pháp

write(data)

Tham số

data

Có thể là một trong các loại sau:

• Dữ liệu tệp cần ghi, dưới dạng ArrayBuffer, TypedArray, DataView, Blob, hoặc chuỗi.
• Một đối tượng chứa các thuộc tính sau:

  type

  Một chuỗi là một trong "write", "seek", hoặc "truncate".

  data

  Dữ liệu tệp cần ghi. Có thể là ArrayBuffer, TypedArray, DataView, Blob, hoặc chuỗi. Thuộc tính này bắt buộc nếu type được đặt là "write".

  position

  Vị trí byte mà con trỏ tệp hiện tại nên di chuyển đến nếu sử dụng "seek". Cũng có thể được đặt nếu type là "write", trong trường hợp đó việc ghi sẽ bắt đầu tại vị trí được chỉ định.

  size

  Một số đại diện cho số byte mà luồng nên chứa. Thuộc tính này bắt buộc nếu type được đặt là "truncate".

Giá trị trả về

Một Promise trả về undefined.

Ngoại lệ

NotAllowedError DOMException

Được ném ra nếu PermissionStatus.state không phải là granted.

QuotaExceededError

Được ném ra nếu kích thước mới của tệp lớn hơn kích thước gốc của tệp và vượt quá hạn ngạch lưu trữ của trình duyệt.

TypeError

Được ném ra nếu data không được xác định, hoặc nếu position hoặc size không hợp lệ.

Ví dụ

Hàm bất đồng bộ sau đây mở hộp thoại 'Save File', trả về FileSystemFileHandle khi một tệp được chọn. Từ đó, một luồng ghi được tạo bằng phương thức FileSystemFileHandle.createWritable().

Sau đó, một chuỗi văn bản được ghi vào luồng, và luồng được đóng lại.

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

Các ví dụ sau đây cho thấy các tùy chọn khác nhau có thể được truyền vào phương thức write().

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

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

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