Firefox Tomorrow

web api instance method

FileList: item() method

View on MDN ↗

Available in workers

The item() method of the FileList interface returns a File object representing the file at the specified index in the file list.

Syntax

item(index)

Parameters

  • index
    • : The zero-based index of the file to retrieve from the list.

Return value

A File object representing the requested file.

Examples

Printing the name of a file

In this example, we use item() to select the first item in the FileList.

HTML

<input type="file" />
<div class="output"></div>

JavaScript

const fileInput = document.querySelector("input[type=file]");
const output = document.querySelector(".output");

fileInput.addEventListener("change", () => {
  const fileList = fileInput.files;
  if (fileList.length > 0) {
    const file = fileList.item(0);
    output.textContent = `You selected: ${file.name}`;
  }
});

Result

Interactive exampleOpen the canonical MDN source to run this embedded demo.

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.