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 totrue
means that option is not available. suggestedName
: AString
. The suggested file name.-
types
: AnArray
of 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