mozilla

Revision 71350 of Download Manager preferences

  • Revision slug: Download_Manager_preferences
  • Revision title: Download Manager preferences
  • Revision id: 71350
  • Created:
  • Creator: Sheppy
  • Is current revision? No
  • Comment new page

Revision Content

There are several preferences used by the Download Manager. This article provides a list of them.

Preference Description
browser.download.manager.showAlertOnComplete A boolean value that indicates whether or not an alert should be shown when downloads complete. Default value is true.
browser.download.manager.showAlertInterval The minimum number of milliseconds that must elapse between download complete alerts; if two downloads complete within this amount of time, only one alert is displayed. Default value is 2000 (2 seconds).
browser.download.manager.retention Indicates how long downloads are retained in the Download Manager's queue after the download is completed successfully. 0 indicates that the download should be removed upon completion; 1 indicates that completed and canceled downloads should be removed on quit; 2 indicates that downloads should never be removed automatically. Default value is 2; however, if the preference is missing, 0 is assumed.
browser.download.manager.quitBehavior Indicates what should happen to in-progress downloads if the application is quit while they're ongoing. 0 indicates that the downloads should be paused and resumed automatically the next time Firefox is run; 1 indicates that the downloads should be paused but will not automatically resume when the application is restarted; and 2 indicates that the downloads will be canceled on quit. Default value is 0 (resume on next launch).
browser.download.manager.closeWhenDone A boolean value indicating whether or not the Downloads window should close automatically when downloads are completed. Default value is false.
browser.download.manager.addToRecentDocs A boolean value that indicates whether or not new downloads should be added to the recent documents list. Default value is true.
browser.download.manager.scanWhenDone A boolean value that indicates whether or not to perform virus scans after downloads are complete. Default value is true.
browser.helperApps.deleteTempFileOnExit A boolean value that indicates whether or not to delete the temporary file used by the Download Manager after the download is complete. Default value is true.
browser.download.manager.flashCount Indicates the number of times the appropriate user interface element should be "flashed" to get the user's attention when a download completes. Default value is 2.
browser.download.manager.focusWhenStarting A boolean value that indicates whether or not to focus the Download Manager window when a download begins. The default value is false.
browser.download.manager.showWhenStarting A boolean value that indicates whether or not to show the Downloads window when a download begins. The default value is true.
browser.download.manager.useWindow A boolean value indicating whether or not to use the Downloads window or display download status in the status bar in the browser window. Default value is true, meaning to display the Downloads window.
browser.download.useDownloadDir A boolean value that indicates whether or not the user's preference is to automatically save files into the download directory. If this value is false, the user is asked what to do. Default is true.

If a preference is not set when the Download Manager looks it up, the Download Manager assumes the default value but doesn't necessarily add the missing preference.

See also

  • {{template.Interface("nsIDownloadManager")}}
  • {{template.Interface("nsIDownload")}}
  • {{template.Interface("nsIDownloadManagerUI")}}

Revision Source

<p>There are several preferences used by the Download Manager.  This article provides a list of them.
</p>
<table class="standard-table">

<tbody><tr>
<th>Preference
</th><th>Description
</th></tr>
<tr>
<td><code>browser.download.manager.showAlertOnComplete</code>
</td><td>A boolean value that indicates whether or not an alert should be shown when downloads complete.  Default value is <code>true</code>.
</td></tr>
<tr>
<td><code>browser.download.manager.showAlertInterval</code>
</td><td>The minimum number of milliseconds that must elapse between download complete alerts; if two downloads complete within this amount of time, only one alert is displayed.  Default value is 2000 (2 seconds).
</td></tr>
<tr>
<td><code>browser.download.manager.retention</code>
</td><td>Indicates how long downloads are retained in the Download Manager's queue after the download is completed successfully.  0 indicates that the download should be removed upon completion; 1 indicates that completed and canceled downloads should be removed on quit; 2 indicates that downloads should never be removed automatically.  Default value is 2; however, if the preference is missing, 0 is assumed.
</td></tr>
<tr>
<td><code>browser.download.manager.quitBehavior</code>
</td><td>Indicates what should happen to in-progress downloads if the application is quit while they're ongoing.  0 indicates that the downloads should be paused and resumed automatically the next time Firefox is run; 1 indicates that the downloads should be paused but will not automatically resume when the application is restarted; and 2 indicates that the downloads will be canceled on quit. Default value is 0 (resume on next launch).
</td></tr>
<tr>
<td><code>browser.download.manager.closeWhenDone</code>
</td><td>A boolean value indicating whether or not the Downloads window should close automatically when downloads are completed. Default value is <code>false</code>.
</td></tr>
<tr>
<td><code>browser.download.manager.addToRecentDocs</code>
</td><td>A boolean value that indicates whether or not new downloads should be added to the recent documents list.  Default value is <code>true</code>.
</td></tr>
<tr>
<td><code>browser.download.manager.scanWhenDone</code>
</td><td>A boolean value that indicates whether or not to perform virus scans after downloads are complete.  Default value is <code>true</code>.
</td></tr>
<tr>
<td><code>browser.helperApps.deleteTempFileOnExit</code>
</td><td>A boolean value that indicates whether or not to delete the temporary file used by the Download Manager after the download is complete.  Default value is <code>true</code>.
</td></tr>
<tr>
<td><code>browser.download.manager.flashCount</code>
</td><td>Indicates the number of times the appropriate user interface element should be "flashed" to get the user's attention when a download completes.  Default value is 2.
</td></tr>
<tr>
<td><code>browser.download.manager.focusWhenStarting</code>
</td><td>A boolean value that indicates whether or not to focus the Download Manager window when a download begins.  The default value is <code>false</code>.
</td></tr>
<tr>
<td><code>browser.download.manager.showWhenStarting</code>
</td><td>A boolean value that indicates whether or not to show the Downloads window when a download begins.  The default value is <code>true</code>.
</td></tr>
<tr>
<td><code>browser.download.manager.useWindow</code>
</td><td>A boolean value indicating whether or not to use the Downloads window or display download status in the status bar in the browser window. Default value is <code>true</code>, meaning to display the Downloads window.
</td></tr>
<tr>
<td><code>browser.download.useDownloadDir</code>
</td><td>A boolean value that indicates whether or not the user's preference is to automatically save files into the download directory.  If this value is <code>false</code>, the user is asked what to do.  Default is <code>true</code>.
</td></tr>
</tbody></table>
<p>If a preference is not set when the Download Manager looks it up, the Download Manager assumes the default value but doesn't necessarily add the missing preference.
</p>
<h3 name="See_also">See also</h3>
<ul><li> {{template.Interface("nsIDownloadManager")}}
</li><li> {{template.Interface("nsIDownload")}}
</li><li> {{template.Interface("nsIDownloadManagerUI")}}
</li></ul>
Revert to this revision