DataTransferItem

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.kind Read only
The kind of drag data item, string or file.
DataTransferItem.type Read only
The drag data item's type, typically a MIME type.

Methods

DataTransferItem.getAsFile()
Returns the File object 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 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

Specification Status Comment
HTML Living Standard
The definition of 'DataTransferItem' in that specification.
Living Standard Initial definition.
HTML 5.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.
Draft Definition of webkitGetAsEntry() as part of the File and Directory Entries API.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 4Edge Full support YesFirefox Full support 50IE No support NoOpera Full support 12Safari No support NoWebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android Full support 50Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?
getAsFileChrome Full support 4Edge Full support YesFirefox Full support 50IE No support NoOpera Full support 12Safari No support NoWebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android Full support 50Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?
getAsStringChrome Full support 4Edge Full support YesFirefox Full support 50IE No support NoOpera Full support 12Safari No support NoWebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android Full support 50Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?
kindChrome Full support 4Edge Full support YesFirefox Full support 50IE No support NoOpera Full support 12Safari No support NoWebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android Full support 50Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?
typeChrome Full support 4Edge Full support YesFirefox Full support 50IE No support NoOpera Full support 12Safari No support NoWebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android Full support 50Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?
webkitGetAsEntry
Non-standard
Chrome Full support 13Edge Full support YesFirefox Full support 50IE No support NoOpera No support NoSafari No support NoWebView Android No support NoChrome Android Full support YesEdge Mobile No support NoFirefox Android Full support 50Opera Android No support NoSafari iOS No support NoSamsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.

Document Tags and Contributors

Contributors to this page: fscholz, erikadoyle, Sheppy, teoli, rolfedh, AFBarstow
Last updated by: fscholz,