DataTransferItem

Объект DataTransferItem представляет собой один элемент данных перетаскивания. Во время операции перетаскивания каждый DragEvent имеет свойство dataTransfer, которое содержит список list элементов данных перетаскивания. Каждый элемент в списке является объектом DataTransferItem.

DataTransferItem был разработан в первую очередь для API перетаскивания и сбрасывания HTML, и по-прежнему специфицируется в разделе HTML перетаскивания и сбрасывания, но теперь он также используется другими API, такими как ClipboardEvent.clipboardData и InputEvent.dataTransfer. Документация DataTransferItem в основном будет обсуждать её использование в операциях перетаскивания, и вы должны обратиться к документации других API для использования DataTransferItem в этих контекстах.

У этого интерфейса нет конструктора.

DataTransferItem.kind Только для чтения

Тип элемента данных перетаскивания, string или file.

DataTransferItem.type Только для чтения

Тип элемента данных перетаскивания, обычно тип MIME.

DataTransferItem.getAsFile()

Возвращает объект File, связанный с элементом данных перетаскивания (или null, если элемент перетаскивания не является файлом).

DataTransferItem.getAsFileSystemHandle() Экспериментально

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

DataTransferItem.getAsString()

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

DataTransferItem.webkitGetAsEntry()

Возвращает объект на основе FileSystemEntry, представляющий запись выбранного файла в его файловой системе. Обычно это будет объект FileSystemFileEntry или FileSystemDirectoryEntry.

У всех методов и свойств этого интерфейса есть своя справочная страница, и на каждой справочной странице есть пример её использования.