Потоковый файл для записи в файловой системе

Интерфейс FileSystemWritableFileStream API файловой системы — это объект WritableStream с дополнительными удобными методами, который работает с одним файлом на диске. К интерфейсу можно получить доступ через метод FileSystemFileHandle.createWritable().

Наследует свойства от родительского класса WritableStream.

Наследует методы от родительского класса WritableStream.

FileSystemWritableFileStream.write()

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

FileSystemWritableFileStream.seek()

Обновляет текущее смещение курсора файла до указанной позиции (в байтах).

FileSystemWritableFileStream.truncate()

Изменяет размер файла, связанного с потоком, до указанного размера в байтах.

Следующая асинхронная функция открывает диалог выбора файла «Сохранить файл», который возвращает FileSystemFileHandle после выбора файла. Из него создается поток для записи с помощью метода FileSystemFileHandle.createWritable().

Затем в поток записывается строка текста, после чего поток закрывается.

async function saveFile() {
  // 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();
}

В следующих примерах показаны различные варианты, которые можно передать в метод 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 });

• API файловой системы
• API доступа к файловой системе: упрощение доступа к локальным файлам