FileSystemHandle: name property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The name read-only property of the FileSystemHandle interface returns the name of the entry represented by handle.

Value

A string.

Examples

The following function allows the user to choose a file from the file picker and retrieve the name property.

js
// store a reference to our file handle
let fileHandle;

async function getFile() {
  // open file picker
  [fileHandle] = await window.showOpenFilePicker();

  const fileName = fileHandle.name;
}

Specifications

Specification
File System Standard
# ref-for-dom-filesystemhandle-name①

Browser compatibility

BCD tables only load in the browser

See also