FileSystemDirectoryHandle: метод getFileHandle()

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

Новая возможность

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

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

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

Метод getFileHandle() интерфейса FileSystemDirectoryHandle возвращает FileSystemFileHandle для файла с указанным именем в каталоге, в котором был вызван метод.

Синтаксис

getFileHandle(name)
getFileHandle(name, options)

Параметры

name

Строка, представляющая FileSystemHandle.name файла, который требуется получить.

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

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

create Необязательно: Boolean. Значение по умолчанию false. При значении true , если файл не найден, будет создан файл с указанным именем и возвращён.

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

А Promise, который разрешается FileSystemFileHandle.

Исключения

NotAllowedError DOMException: Выбрасывается, если PermissionStatus.state для объекта handle не 'granted' в режиме readwrite , если опция create установлена в true или в режиме read , если опция create установлена в false.
TypeError: Выбрасывается, если указанное имя не является допустимой строкой или содержит символы, которые могут конфликтовать с файловой системой.
TypeMismatchError DOMException: Выбрасывается, если указанная запись является каталогом, а не файлом.
NotFoundError DOMException: Выбрасывается, если текущая запись не найдена или если файл не существует, и опция create установлена в false.

Примеры

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

const fileName = "fileToGetName";

// assuming we have a directory handle: 'currentDirHandle'
const fileHandle = currentDirHandle.getFileHandle(fileName, { create: true });

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

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

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

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