FileSystemSyncAccessHandle: метод truncate()

Базовая версия 2023

Только что доступно

С марта 2023 года эта функция работает на последних устройствах и версиях браузеров. Возможно, эта функция не будет работать на более старых устройствах или браузерах.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна только в специализированных веб-воркерах.

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

Примечание: В более ранних версиях спецификации close(), flush(), getSize() и truncate() были ошибочно указаны как асинхронные методы, и более старые версии некоторых браузеров реализовывали их таким образом. Однако все современные браузеры, которые поддерживают эти методы, реализуют их как синхронные методы.

Синтаксис

truncate(newSize)

Параметры

newSize: Количество байтов, на которое нужно изменить размер файла.

Возвращаемое значение

Ничего (undefined).

Исключения

InvalidStateError DOMException: Выбрасывается, если связанный дескриптор файла уже закрыт или если изменение бинарных данных файла по какой-либо причине не удалось.
QuotaExceededError DOMException: Выбрасывается, если размер newSize больше первоначального размера файла и превышает квоту хранилища браузера.
TypeError: Выбрасывается, если подлежащая файловая система не поддерживает установку размера файла на новый размер.

Примеры

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

  // Truncate the file to 0 bytes
  accessHandle.truncate(0);

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

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

Спецификации

Спецификация
Файловая система # api-filesystemsyncaccesshandle-truncate

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari в iOS	Samsung Internet	WebView Android
`truncate`	102	102	111	88	15.2	109	111	74	15.2	21.0	109
`sync_version`	108	108	111	94	16.4	109	111	74	16.4	21.0	109

См. также

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileSystemSyncAccessHandle/truncate