FileSystemDirectoryHandle: метод getDirectoryHandle()

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

name

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

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

Необязательный объект, содержащий параметры для полученного подкаталога. Параметры следующие:

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

Булево значение, которое по умолчанию равно false. Если установлено в значение true, если каталог не найден, будет создан и возвращён каталог с указанным именем.

A Promise, который разрешается с FileSystemDirectoryHandle.

NotAllowedError DOMException

Выбрасывается, если PermissionStatus.state для обработчика не 'granted' в режиме readwrite , если опция create установлена в true, или в режиме read , если опция create установлена в false.

TypeError

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

TypeMismatchError DOMException

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

NotFoundError DOMException

Выбрасывается, если текущая запись не найдена или если целевой каталог не существует, и опция create установлена в false.

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

const dirName = "directoryToGetName";

// assuming we have a directory handle: 'currentDirHandle'
const subDir = currentDirHandle.getDirectoryHandle(dirName, { create: true });

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