FileSystemSyncAccessHandle: getSize() 方法

基线 2023

新功能

自 2023 年 3 月起，此功能适用于最新的设备和浏览器版本。此功能可能无法在较旧的设备或浏览器中使用。

安全上下文：此功能仅在安全上下文（HTTPS）中可用，在某些或所有支持的浏览器中可用。

注意：此功能仅在专用 Web 工作线程中可用。

getSize() 方法是 FileSystemSyncAccessHandle 接口的方法，它以字节为单位返回与该句柄关联的文件的大小。

注意：在规范的早期版本中，close()、flush()、getSize() 和 truncate() 错误地指定为异步方法，并且一些浏览器的早期版本以这种方式实现它们。但是，当前所有支持这些方法的浏览器都将它们实现为同步方法。

语法

js
getSize()

参数

无。

返回值

一个以字节为单位表示文件大小的数字。

异常

InvalidStateError DOMException

如果关联的访问句柄已关闭，则抛出此异常。

示例

以下异步事件处理程序函数包含在 Web 工作线程中。在收到来自主线程的消息后，它会

  • 创建同步文件访问句柄。
  • 获取文件的大小并创建一个 ArrayBuffer 来保存它。
  • 将文件内容读入缓冲区。
  • 对消息进行编码并将其写入文件末尾。
  • 将更改持久保存到磁盘并关闭访问句柄。
js
onmessage = async (e) => {
  // Retrieve message sent to work from main script
  const message = e.data;

  // Get handle to draft file
  const root = await navigator.storage.getDirectory();
  const draftHandle = await root.getFileHandle("draft.txt", { create: true });
  // Get sync access handle
  const accessHandle = await draftHandle.createSyncAccessHandle();

  // Get size of the file.
  const fileSize = accessHandle.getSize();
  // Read file content to a buffer.
  const buffer = new DataView(new ArrayBuffer(fileSize));
  const readBuffer = accessHandle.read(buffer, { at: 0 });

  // Write the message to the end of the file.
  const encoder = new TextEncoder();
  const encodedMessage = encoder.encode(message);
  const writeBuffer = accessHandle.write(encodedMessage, { at: readBuffer });

  // Persist changes to disk.
  accessHandle.flush();

  // Always close FileSystemSyncAccessHandle if done.
  accessHandle.close();
};

规范

规范
文件系统标准
# api-filesystemsyncaccesshandle-getsize

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅