W3cubDocs

/Web APIs

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.

Instance 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.

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() Experimental

Returns a FileSystemFileHandle if the dragged item is a file, or 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

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
DataTransferItem 11 12 50 No 12 5.1 4 18 50 ≤14 5 1.0
getAsFile 11 12 50 No 12 5.1 4 18 50 ≤14 5 1.0
getAsFileSystemHandle 86 86 No No 72 No No No No No No No
getAsString 11 12 50 No 12 5.1 4 18 50 ≤14 5 1.0
kind 11 12 50 No 12 5.1 4 18 50 ≤14 5 1.0
type 11 12 50 No 12 5.1 4 18 50 ≤14 5 1.0
webkitGetAsEntry 13 14 50 No 15 11.1 4.4 18 No 14 11.3 1.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DataTransferItem