Skip to main content

DataTransferItem

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.

MDN Reference

Methods

getAsFile()

getAsFile(): File | null;

If the item is a file, the DataTransferItem.getAsFile() method returns the drag data item's File object. If the item is not a file, this method returns null.

MDN Reference

Returns

File | null


getAsString()

getAsString(callback): void;

The DataTransferItem.getAsString() method invokes the given callback with the drag data item's string data as the argument if the item's kind is a Plain unicode string (i.e., kind is string).

MDN Reference

Parameters

ParameterType
callbackFunctionStringCallback | null

Returns

void


webkitGetAsEntry()

webkitGetAsEntry(): FileSystemEntry | null;

If the item described by the DataTransferItem is a file, webkitGetAsEntry() returns a FileSystemFileEntry or FileSystemDirectoryEntry representing it. If the item isn't a file, null is returned.

MDN Reference

Returns

FileSystemEntry | null

Properties

kind

readonly kind: string;

The read-only DataTransferItem.kind property returns the kind–a string or a file–of the DataTransferItem object representing the drag data item.

MDN Reference


type

readonly type: string;

The read-only DataTransferItem.type property returns the type (format) of the DataTransferItem object representing the drag data item. The type is a Unicode string generally given by a MIME type, although a MIME type is not required.

MDN Reference