FileSystemFileHandle: метод getFile()

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

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

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

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

Примечание: Эта функция доступна в Web Workers.

Метод getFile() интерфейса FileSystemFileHandle возвращает Promise, который разрешается в объект File, представляющий состояние файла на диске, представленного обработчиком.

Если файл на диске изменяется или удаляется после вызова этого метода, возвращённый объект File скорее всего будет недоступен для чтения.

Синтаксис

getFile()

Параметры

Нет.

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

A Promise, который разрешается в объект File.

Исключения

NotAllowedError DOMException: Выбрасывается, если PermissionStatus.state не granted в режиме read.
NotFoundError DOMException: Выбрасывается, если текущая запись не найдена.

Примеры

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

async function getTheFile() {
  // open file picker
  const [fileHandle] = await window.showOpenFilePicker(pickerOpts);

  // get file contents
  const fileData = await fileHandle.getFile();
}

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

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

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getFile`	86	86	111	72	15.2	109	111	74	15.2	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/FileSystemFileHandle/getFile