The DataTransferItem object represents one drag data item. During a drag operation, each drag event has a dataTransfer property which contains a list of drag data items. Each item in the list is a DataTransferItem object.
This interface has no constructor.
Properties
DataTransferItem.kindRead only- The kind of drag data item,
stringorfile. DataTransferItem.typeRead only- The drag data item's type, typically a MIME type.
Methods
DataTransferItem.getAsFile()- Returns the
Fileobject associated with the drag data item (or null if the drag item is not a file). DataTransferItem.getAsString()- Invokes the specified callback with the drag data item string as its argument.
DataTransferItem.webkitGetAsEntry()- Returns an object based on
FileSystemEntryrepresenting the selected file's entry in its file system. This will generally be either aFileSystemFileEntryorFileSystemDirectoryEntryobject.
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
| Specification | Status | Comment |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'DataTransferItem' in that specification. |
Living Standard | Initial definition. |
| HTML5.1 The definition of 'DataTransferItem' in that specification. |
Recommendation | W3C snapshot of WHATWG |
| File and Directory Entries API The definition of 'DataTransferItem.webkitGetAsEntry()' in that specification. |
Editor's Draft | Definition of webkitGetAsEntry() as part of the File and Directory Entries API. |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | 4 | (Yes) | 50 (50) | No support | 12 | No support |
| Feature | Android | Android Webview | Chrome for Android | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|---|---|
| Basic support | No support | No support | No support | ? | 50.0 (50) | No support | No support | No support | No support |