Окно: метод showDirectoryPicker()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

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

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

Метод showDirectoryPicker() интерфейса Window отображает диалог выбора директории, позволяющий пользователю выбрать папку.

Синтаксис

showDirectoryPicker()

Параметры

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

Объект, содержащий опции:

id Необязательный: Указание идентификатора позволяет браузеру запоминать различные директории для разных идентификаторов. Если для другого выбора используется тот же идентификатор, диалог откроется в той же директории.
mode Необязательный: Строка, по умолчанию "read" для чтения или "readwrite" для чтения и записи в директории.
startIn Необязательный: FileSystemHandle или известная директория ("desktop", "documents", "downloads", "music", "pictures", или "videos") для открытия диалога в ней.

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

Объект Promise, обработчик выполнения которого получает объект FileSystemDirectoryHandle.

Исключения

AbortError DOMException: Выбрасывается, если пользователь закрывает диалог без выбора, если выбранная директория считается слишком чувствительной или небезопасной, или если PermissionStatus.state для выбранной директории не "granted" в указанном mode.
SecurityError DOMException: Выбрасывается, если вызов заблокирован политикой одного источника или если он не вызван через пользовательское взаимодействие, например, нажатие кнопки.

Безопасность

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

Примеры

Эта асинхронная функция отображает диалог выбора директории и возвращает объект FileSystemDirectoryHandle после выбора.

async function getDir() {
  const dirHandle = await window.showDirectoryPicker();

  // run code for dirHandle
}

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

Спецификация
File System Access # api-showdirectorypicker

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

	Десктоп					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`showDirectoryPicker`	86	86	Нет	72	Нет	132	Нет	Нет	Нет	Нет	132

См. также

© 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/Window/showDirectoryPicker