W3cubDocs

/Web APIs

FileList: item() method

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

Syntax

js

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

js

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

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
item 2 12 3 10 ≤12.1 4 ≤37 18 4 ≤12.1 3.2 1.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FileList/item