Skip to main content

DataTransferItemList

The DataTransferItemList object is a list of DataTransferItem objects representing items being dragged. During a drag operation, each DragEvent has a dataTransfer property and that property is a DataTransferItemList.

MDN Reference

Indexable

[index: number]: DataTransferItem

Methods

[iterator]()

iterator: ArrayIterator<DataTransferItem>;

Returns

ArrayIterator<DataTransferItem>


add()

Call Signature

add(data, type): DataTransferItem | null;

The DataTransferItemList.add() method creates a new DataTransferItem using the specified data and adds it to the drag data list. The item may be a File or a string of a given type. If the item is successfully added to the list, the newly-created DataTransferItem object is returned.

MDN Reference

Parameters
ParameterType
datastring
typestring
Returns

DataTransferItem | null

Call Signature

add(data): DataTransferItem | null;
Parameters
ParameterType
dataFile
Returns

DataTransferItem | null


clear()

clear(): void;

The DataTransferItemList method clear() removes all DataTransferItem objects from the drag data items list, leaving the list empty.

MDN Reference

Returns

void


remove()

remove(index): void;

The DataTransferItemList.remove() method removes the DataTransferItem at the specified index from the list. If the index is less than zero or greater than one less than the length of the list, the list will not be changed.

MDN Reference

Parameters

ParameterType
indexnumber

Returns

void

Properties

length

readonly length: number;

The read-only length property of the DataTransferItemList interface returns the number of items currently in the drag item list.

MDN Reference