FileSystemHandle: name property

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or 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