1. Mozilla
  2. Add-ons
  3. Browser extensions
  4. JavaScript APIs
  5. downloads
  6. downloads.FilenameConflictAction

downloads.FilenameConflictAction

The FilenameConflictAction type of the downloads API specifies what to do if the name of a downloaded file conflicts with an existing file.

This type defines the values that can be used for the conflictAction property of the downloads.download function's options parameter.

Type

Values of this type are strings. Possible values are:

"uniquify"

The browser will modify the filename to make it unique.

"overwrite"

The browser will overwrite the old file with the newly-downloaded file.

"prompt"

The browser will prompt the user, asking them to choose whether to uniquify or overwrite.

Browser compatibility

Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
FilenameConflictAction
Chrome – Full support
Chrome 28 (Release date: 2013-07-09)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 47 (Release date: 2016-06-07)
footnote Full support
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – No support
Firefox for Android 48 – 68 (Release date: 2016-08-02)
footnote Removed in 79 and later
Safari on iOS – No support
Safari on iOS
footnote No support
prompt
Chrome – Full support
Chrome 28 (Release date: 2013-07-09)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – No support
Firefox
footnote No support
Opera – Full support
Opera 15 (Release date: 2013-07-02)
footnote Full support
Safari – No support
Safari
footnote No support
Firefox for Android – No support
Firefox for Android
footnote No support
Safari on iOS – No support
Safari on iOS
footnote No support

Tip: you can click/tap on a cell for more information.

Full support
No support

Note: This API is based on Chromium's chrome.downloads API.

This page was last modified on by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.