FileSystemSyncAccessHandle: метод read()

Метод read() интерфейса FileSystemSyncAccessHandle считывает содержимое файла, связанного с хэндлом, в указанный буфер, по желанию, с заданным смещением.

buffer

Объект ArrayBuffer или ArrayBufferView (например, DataView), представляющий буфер, в который должно быть считано содержимое файла. Обратите внимание, что вы не можете напрямую манипулировать содержимым ArrayBuffer. Вместо этого вы создаёте один из объектов массивов с типом, например, Int8Array или DataView, который представляет буфер в определённом формате, и используете его для чтения и записи содержимого буфера.

options Необязательный

Объект параметров, содержащий следующие свойства:

at

Число, представляющее смещение в байтах, с которого должен быть прочитан файл.

Число, представляющее количество считанных из файла байтов.

InvalidStateError DOMException

Выбрасывается, если связанный хэндл доступа уже закрыт.

TypeError

Выбрасывается, если файловая система не поддерживает чтение файла с указанного смещения.

Следующая асинхронная функция-обработчик событий находится внутри веб-воркера. При получении сообщения с основного потока она:

• Создаёт синхронный хэндл доступа к файлу.
• Получает размер файла и создаёт ArrayBuffer для его хранения.
• Считывает содержимое файла в буфер.
• Кодирует сообщение и записывает его в конец файла.
• Сохраняет изменения на диске и закрывает хэндл доступа.

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 файловой системы
• API доступа к файловой системе: упрощение доступа к локальным файлам