MDN self-hosted library · e01.org

DataTransferItem

HTML Drag and Drop API

no runnable cells web-api-interface upstream source

HTML Drag and Drop API

The DataTransferItem object represents one drag data item. During a drag operation, each DragEvent has a dataTransfer property which contains a list of drag data items. Each item in the list is a DataTransferItem object.

DataTransferItem was primarily designed for the HTML Drag and Drop API, and is still specified in the HTML drag-and-drop section, but it is now also used by other APIs, such as ClipboardEvent.clipboardData and InputEvent.dataTransfer. Documentation of DataTransferItem will primarily discuss its usage in drag-and-drop operations, and you should refer to the other APIs' documentation for usage of DataTransferItem in those contexts.

This interface has no constructor.

Instance properties

  • DataTransferItem.kind
  • : The kind of drag data item, string or file.
  • DataTransferItem.type
  • : The drag data item's type, typically a MIME type.

Instance methods

  • DataTransferItem.getAsFile()
  • : Returns the File object associated with the drag data item (or null if the drag item is not a file).
  • DataTransferItem.getAsFileSystemHandle()
  • : Returns a Promise that fulfills with a FileSystemFileHandle if the dragged item is a file, or fulfills with a FileSystemDirectoryHandle if the dragged item is a directory.
  • DataTransferItem.getAsString()
  • : Invokes the specified callback with the drag data item string as its argument.
  • DataTransferItem.webkitGetAsEntry()
  • : Returns an object based on FileSystemEntry representing the selected file's entry in its file system. This will generally be either a FileSystemFileEntry or FileSystemDirectoryEntry object.

Example

All of this interface's methods and properties have their own reference page, and each reference page has an example of its usage.

Specifications

Browser compatibility