FileList: item() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Note: This feature is available in Web 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

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

Specifications

Specification
File API # dfn-item

Browser compatibility

BCD tables only load in the browser