The read-only webkitEntries
property of the HTMLInputElement
interface contains an array of file system entries (as objects based on FileSystemEntry
) representing files and/or directories selected by the user using an <input>
element of type file
, but only if that selection was made using drag-and-drop: selecting a file in the dialog will leave the property empty.
The array can only contain directories if the webkitdirectory
property is true
. This means the <input>
element was configured to let the user choose directories.
Note: This property is called webkitEntries
in the specification due to its origins as a Google Chrome-specific API. It's likely to be renamed someday.
Value
An array of objects based on FileSystemEntry
, each representing one file which is selected in the <input>
element. More specifically, files are represented by FileSystemFileEntry
objects, and, if they're allowed, directories are represented by FileSystemDirectoryEntry
objects.
Examples
This example shows how to create a file selection <input>
element and process the selected files.
HTML
<input id="files" type="file" multiple />
JavaScript
document.getElementById("files").addEventListener("change", (event) => {
event.target.webkitEntries.forEach((entry) => {
});
});
Each time a change
event occurs, this code iterates over the selected files, obtaining their FileSystemEntry
-based objects and acting on them.
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 |
webkitEntries |
22 |
79 |
50 |
No |
15 |
11.1 |
No |
25 |
No |
14 |
11.3 |
1.5 |
See also