大网数据广告活动
Web 标准与前端开发

FileSystemWritableFileStream:write() 方法

· 52CE 我爱测

FileSystemWritableFileStream 接口的 **`write()`** 方法用于在调用此方法的文件上的当前指针偏移处写入内容。

File System API

FileSystemWritableFileStream 接口的 write() 方法用于在调用此方法的文件上的当前指针偏移处写入内容。

在流被关闭前,更改不会写入到磁盘上实际的文件。通常更改会被先写入到临时文件。这个方法也能被用于定位到流中的字节点位还有进行裁剪以改变文件内容的总字节数。

语法

write(data)

参数

  • data
    • : 可以是以下之一:
      • 用于写入的文件数据,可以是 ArrayBuffer、TypedArray、DataView、Blob 或字符串。
      • 一个包含以下属性的对象:
        • type
          • : 一个字符串,值为 "write"、"seek" 或 "truncate" 之一。
        • data
          • : 用于写入的文件数据,可以是 ArrayBuffer、TypedArray、DataView、Blob 或字符串。这个属性在 type 被设为 "write" 时是必需的。
        • position
          • : 当 type 为 "seek" 时,表示文件当前指针应该移动到的位置。当 type 被设为 "write" 时也可以使用,这种情况下将会在指定的位置开始写入。
        • size
          • : 一个数字,表示流应当包含的字节数。这个属性在 type 被设为 "truncate" 时是必需的。

返回值

一个 Promise,会兑现 undefined。

异常

  • NotAllowedError DOMException
    • : 如果 PermissionStatus.state 不为 granted,抛出此异常。
  • QuotaExceededError DOMException
    • : 如果文件新的大小大于文件原来的大小并且超出了浏览器的存储配额,抛出此异常。
  • TypeError
    • : 如果未定义 data 或者 position 或 size 选项的值无效,抛出此异常。

示例

下面的异步函数会打开“保存文件”选择器,选择器在有文件被选择后会返回一个 FileSystemFileHandle。由此,使用 FileSystemFileHandle.createWritable() 方法创建一个写入流。

然后向流中写入一个文本字符串,随后关闭该流。

async function saveFile() {
  try {
    // 创建一个新句柄
    const newHandle = await window.showSaveFilePicker();

    // 创建一个 FileSystemWritableFileStream 用于写入
    const writableStream = await newHandle.createWritable();

    // 写入我们的文件
    await writableStream.write("This is my file content");

    // 关闭文件并将内容写入磁盘
    await writableStream.close();
  } catch (err) {
    console.error(err.name, err.message);
  }
}

下面的例子展示能够向 write() 方法传递的不同选项。

// 只传递数据(没有选项)
writableStream.write(data);

// 向流中指定位置写入数据
writableStream.write({ type: "write", position, data });

// 将文件当前的指针更新到指定的偏移位置
writableStream.write({ type: "seek", position });

// 调整文件至指定字节长度
writableStream.write({ type: "truncate", size });

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。