webkitEntries はHTMLInputElement インターフェイスの読み取り専用プロパティで、ユーザーが<input> 要素のfile 型を用いて選択したファイルやディレクトリーを表す、ファイルシステムの項目（FileSystemEntry に基づくオブジェクト）の配列を含みます。その選択がドラッグ & ドロップで行われた場合にのみ、ダイアログ内でファイルを選択しても、プロパティは空になります。

webkitdirectory プロパティがtrue である場合のみ、配列が入ることがあります。これは、<input> 要素でユーザーがディレクトリーを選択することができることを意味します。

値

FileSystemEntry に基づいたオブジェクト配列で、それぞれの要素が<input> 要素で選択されたファイルを表します。具体的には、ファイルはFileSystemFileEntry オブジェクトで表現され、許可されていれば、ディレクトリーはFileSystemDirectoryEntry オブジェクトで表されます。

例

この例では、ファイル選択<input> 要素を作成し、選択されたファイルを処理する方法を示しています。

HTML

<input type="file" multiple />

JavaScript

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

change イベントが発生するたびに、このコードは選択されたファイルリストを走査して、FileSystemEntry ベースのオブジェクトを取得し操作をします。

仕様書

ブラウザーの互換性

関連情報

• ファイルとディレクトリー項目 API
• ファイルとディレクトリー項目 API 入門
• HTMLInputElement
• FileSystemEntry
• FileSystem