HTMLInputElement: webkitEntries property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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) => {
/* do stuff with the entry */
});
});
Each time a change event occurs, this code iterates over the selected
files, obtaining their FileSystemEntry-based objects and acting on them.
Specifications
| Specification |
|---|
| File and Directory Entries API # dom-htmlinputelement-webkitentries |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
webkitEntries
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support