DataTransfer: files property

The files read-only property of DataTransfer objects is a list of the files in the drag operation. If the operation includes no files, the list is empty.

This feature can be used to drag files from a user's desktop to the browser.

Note: The files property of DataTransfer objects can only be accessed from within the drop event. For all other events, the files property will be empty — because its underlying data store will be in a protected mode.


A list of the files in a drag operation, one list item for each file in the operation. If the drag operation had no files, the list is empty.


There are two live examples of this interface:


HTML Standard
# dom-datatransfer-files-dev

Browser compatibility

BCD tables only load in the browser