The DataTransfer.files property 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.

Syntax

dataTransfer.files;

Return value

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.

Example

There are two live examples of this interface:

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'files' in that specification.
Living Standard  
HTML 5.1
The definition of 'files' in that specification.
Recommendation Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support Yes ? Yes ? ? ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes ? Yes ? ? ?

Document Tags and Contributors

Contributors to this page: fscholz, erikadoyle, rolfedh, Sebastianz, AFBarstow
Last updated by: fscholz,