Window.showSaveFilePicker()
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The showSaveFilePicker() method of the
Window interface shows a file picker that allows a user to save a file.
Either by selecting an existing file, or entering a name for a new file.
Syntax
window.showSaveFilePicker();
Parameters
- options Optional
-
An optional object containing options, which are as follows:
-
excludeAcceptAllOption: ABoolean. Defaultfalse. By default the picker should include an option to not apply any file type filters (instigated with the type option below). Setting this option totruemeans that option is not available. suggestedName: AString. The suggested file name.-
types: AnArrayof allowed file types to save. Each item is an object with the following options:
-
Return value
Exceptions
AbortError-
Thrown if the user dismisses the file picker without selecting or inputting a file, or if the user agent deems any selected files too sensitive or dangerous.
Examples
The following function shows a file picker, with text files highlighted for selection.
function getNewFileHandle() {
const opts = {
types: [{
description: 'Text file',
accept: {'text/plain': ['.txt']},
}],
};
return window.showSaveFilePicker(opts);
}
Specifications
| Specification |
|---|
| File System Access # api-showsavefilepicker |
Browser compatibility
BCD tables only load in the browser