W3cubDocs

/Web APIs

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.

// 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>
# ref-for-dom-filesystemhandle-name①>

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
name 86 86 111 72 15.2 109 111 74 15.2 21.0 109 15.2

See also

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