HTMLInputElement: webkitEntries-Eigenschaft

Die schreibgeschützte webkitEntries-Eigenschaft der HTMLInputElement-Schnittstelle enthält ein Array von Dateisystemeinträgen (als Objekte basierend auf FileSystemEntry), die Dateien und/oder Verzeichnisse darstellen, die vom Benutzer mit einem <input>-Element vom Typ file ausgewählt wurden, allerdings nur, wenn diese Auswahl per Drag-and-Drop erfolgt ist: Die Auswahl einer Datei im Dialogfenster lässt die Eigenschaft leer.

Das Array kann nur Verzeichnisse enthalten, wenn die webkitdirectory-Eigenschaft true ist. Dies bedeutet, dass das <input>-Element so konfiguriert wurde, dass es dem Benutzer erlaubt, Verzeichnisse auszuwählen.

Hinweis: Diese Eigenschaft wird in der Spezifikation webkitEntries genannt aufgrund ihrer Ursprünge als API spezifisch für Google Chrome. Es ist wahrscheinlich, dass sie eines Tages umbenannt wird.

Wert

Ein Array von Objekten basierend auf FileSystemEntry, von denen jedes eine Datei darstellt, die im <input>-Element ausgewählt wurde. Genauer gesagt, werden Dateien durch FileSystemFileEntry-Objekte dargestellt und, wenn erlaubt, Verzeichnisse durch FileSystemDirectoryEntry-Objekte.

Beispiele

Dieses Beispiel zeigt, wie man ein Datei-Auswahl-<input>-Element erstellt und die ausgewählten Dateien verarbeitet.

HTML

html
<input id="files" type="file" multiple />

JavaScript

js
document.getElementById("files").addEventListener("change", (event) => {
  event.target.webkitEntries.forEach((entry) => {
    /* do stuff with the entry */
  });
});

Jedes Mal, wenn ein change-Ereignis eintritt, iteriert dieser Code über die ausgewählten Dateien, erhält ihre FileSystemEntry-basierten Objekte und agiert auf diese.

Spezifikationen

Specification
File and Directory Entries API
# dom-htmlinputelement-webkitentries

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
webkitEntries

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch