web api instance method
Window: showDirectoryPicker() method
Secure contextLimited availability
The showDirectoryPicker() method of the
Window interface displays a directory picker which allows the user to
select a directory.
Syntax
showDirectoryPicker()
showDirectoryPicker(options)
Parameters
optionsOptional- : An object containing options, which are as follows:
idOptional- : By specifying an ID, the browser can remember different directories for different IDs. If the same ID is used for another picker, the picker opens in the same directory.
modeOptional- : A string that defaults to
"read"for read-only access or"readwrite"for read and write access to the directory.
- : A string that defaults to
startInOptional- : A
FileSystemHandleor a well known directory ("desktop","documents","downloads","music","pictures", or"videos") to open the dialog in.
- : A
- : An object containing options, which are as follows:
Return value
A Promise whose fulfillment handler receives a FileSystemDirectoryHandle object.
Exceptions
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 the
statefor the selected directory is not"granted"in the specifiedmode.
- : 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 the
SecurityErrorDOMException- : Thrown if the call was blocked by the same-origin policy or it was not called via a user interaction such as a button press.
Security
Transient user activation is required. The user has to interact with the page or a UI element in order for this feature to work.
Examples
This asynchronous function shows a directory picker and returns a
FileSystemDirectoryHandle once selected.
async function getDir() {
const dirHandle = await window.showDirectoryPicker();
// run code for dirHandle
}
Specifications
SpecificationsStandards references are available on the canonical MDN page.
Browser compatibility
Browser compatibilityCompatibility data is available on the canonical MDN page.