Spec-Zone.ru › Web APIs

DataTransferItem: метод getAsFileSystemHandle()

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

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

Метод getAsFileSystemHandle() интерфейса DataTransferItem возвращает FileSystemFileHandle, если перетаскиваемый элемент — файл, или FileSystemDirectoryHandle, если перетаскиваемый элемент — директория.

Синтаксис

getAsFileSystemHandle()

Параметры

Нет.

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

Объект Promise.

Если свойство kind элемента имеет значение "file", и к этому элементу обращаются в обработчиках событий dragstart или drop, то возвращаемый промис выполняется с FileSystemFileHandle, если перетаскиваемый элемент — файл, или с FileSystemDirectoryHandle, если перетаскиваемый элемент — директория.

В противном случае промис выполняется с null.

Исключения

Нет.

Примеры

В этом примере используется метод getAsFileSystemHandle() для получения дескрипторов файлов для сброшенных элементов.

elem.addEventListener("dragover", (e) => {
  // Prevent navigation.
  e.preventDefault();
});
elem.addEventListener("drop", async (e) => {
  // Prevent navigation.
  e.preventDefault();

  // Process all of the items.
  for (const item of e.dataTransfer.items) {
    // kind will be 'file' for file/directory entries.
    if (item.kind === "file") {
      const entry = await item.getAsFileSystemHandle();
      if (entry.kind === "file") {
        // run code for if entry is a file
      } else if (entry.kind === "directory") {
        // run code for is entry is a directory
      }
    }
  }
});

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

Спецификация
File System Access
# dom-datatransferitem-getasfilesystemhandle

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

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

См. также

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

© 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/DataTransferItem/getAsFileSystemHandle

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API