FileSystemDirectoryHandle: метод entries()

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

Новое

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

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

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

Метод entries() интерфейса FileSystemDirectoryHandle возвращает новый асинхронный итератор для итерации по парам ключ-значение элементов внутри FileSystemDirectoryHandle, на котором вызывается этот метод. Пари ключ-значение имеют вид массива, подобный [key, value].

Синтаксис

entries()

Параметры

Нет.

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

Новый асинхронный итератор, содержащий пары ключ-значение каждого элемента внутри FileSystemDirectoryHandle.

Исключения

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

Примеры

Использование цикла for await...of может упростить процесс итерации.

const dirHandle = await window.showDirectoryPicker();

for await (const [key, value] of dirHandle.entries()) {
  console.log({ key, value });
}

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

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

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

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