HTMLInputElement: webkitEntries property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("File and Directory Entries API")}}
The read-only **webkitEntries** property of the {{domxref("HTMLInputElement")}} interface contains an array of file system entries (as objects based on {{domxref("FileSystemEntry")}}) representing files and/or directories selected by the user using an {{HTMLElement("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 {{domxref("HTMLInputElement.webkitdirectory", "webkitdirectory")}} property is true. This means the <input> element was configured to let the user choose directories.
توجه: 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 {{domxref("FileSystemEntry")}}, each representing one file which is selected in the {{HTMLElement("input")}} element. More specifically, files are represented by {{domxref("FileSystemFileEntry")}} objects, and, if they're allowed, directories are represented by {{domxref("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 {{domxref("HTMLElement/change_event", "change")}} event occurs, this code iterates over the selected files, obtaining their {{domxref("FileSystemEntry")}}-based objects and acting on them.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- File and Directory Entries API
- {{domxref("HTMLInputElement")}}
- {{domxref("FileSystemEntry")}}
- {{domxref("FileSystem")}}