FileSystemWritableFileStream: метод truncate()

Метод truncate() интерфейса FileSystemWritableFileStream изменяет размер файла, связанного с потоком, до указанного размера в байтах.

Если указанный размер больше текущего размера файла, файл дополняется 0x00 байтами.

Позиция курсора файла также обновляется при вызове truncate(). Если смещение меньше размера, оно остается неизменным. Если смещение больше размера, смещение устанавливается в этот размер. Это гарантирует, что последующие записи не приведут к ошибке.

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

size

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

Обещание Promise, которое возвращает undefined.

NotAllowedError DOMException

Выбрасывается, если PermissionStatus.state не granted.

QuotaExceededError DOMException

Выбрасывается, если новый размер файла больше исходного размера файла и превышает квоту хранилища браузера storage quota.

TypeError

Выбрасывается, если size не является числом или не определено.

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

Далее мы записываем в поток:

1. В поток записывается строка текста.
2. Метод truncate() используется для изменения размера файла на 8 байтов.
3. Вторая строка текста записывается в начало потока, перезаписывая первую запись.

Поток затем закрывается.

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 first file content");
    await writableStream.truncate(8);
    await writableStream.write("my second file content");

    // close the file and write the contents to disk.
    await writableStream.close();
  } catch (err) {
    console.error(err.name, err.message);
  }
}

Если вы запустите эту функцию, а затем откроете созданный на диске файл, вы увидите текст "This is my second file content".

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