HTMLInputElement.files

HTMLInputElement.files プロパティを通じて、<input type="file"> 要素で選択された FileList にアクセスできます。

FileList のインスタンスが返ります。HTMLInputElementtype="file" でない場合は、null が返ります。

以下の例は、HTMLInputElement.files プロパティにアクセスしてユーザーが選択したファイルの名前を出力する方法を示します。

HTML

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

JavaScript

HTMLInputElement.files は、ファイルが選択されていなくても FileList を返すことに注意してください。 この性質があるため、ファイルが選択されているかをチェックせずに for...of で走査しても安全です。

const fileInput = document.getElementById("files");

console.log(fileInput.files instanceof FileList); // true

for (const file of fileInput.files) {
  console.log(file.name); // ファイル名を出力します
}

仕様書

Specification
HTML Standard
# dom-input-files-dev

ブラウザーの互換性

BCD tables only load in the browser