optionsOptional

An object containing options, which are as follows:

idOptional

By specifying an ID, the browser can remember different directories for differentIDs. If the same ID is used for another picker, the picker opens in the samedirectory.

modeOptional

A string that defaults to"read" for read-only access or"readwrite" for readand write access to the directory.

startInOptional

AFileSystemHandle or a well known directory ("desktop","documents","downloads","music","pictures", or"videos") to open the dialog in.

APromise whose fulfillment handler receives aFileSystemDirectoryHandle object.

AbortErrorDOMException

Thrown if the user dismisses the prompt without making a selection,or if the user agent deems the selected directory to be too sensitive or dangerous,or if thePermissionStatus.state for the selected directory is not"granted" in the specifiedmode.

SecurityErrorDOMException

Thrown if the call was blocked by thesame-origin policy or it was not called via a user interaction such as a button press.

Transient user activation is required. The user has to interact with the page or a UI element in order for this feature to work.

This asynchronous function shows a directory picker and returns aFileSystemDirectoryHandle once selected.

async function getDir() {  const dirHandle = await window.showDirectoryPicker();  // run code for dirHandle}

• File System API
• The File System Access API: simplifying access to local files