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 |