Creates an nsIDownload and adds it to be managed by the download manager.
@note This does not actually start a download. If you want to add and
start a download, you need to create an nsIWebBrowserPersist, pass it
as the aCancelable object, call this method, set the progressListener
as the returned download object, then call saveURI.
| aSource | The source URI of the transfer. Must not be null. |
| aTarget | The target URI of the transfer. Must not be null. |
| aDisplayName | The user-readable description of the transfer. Can be empty. |
| aMIMEInfo | The MIME info associated with the target, including MIME type and helper app when appropriate. This parameter is optional. |
| startTime | Time when the download started |
| aTempFile | The location of a temporary file; i.e. a file in which the received data will be stored, but which is not equal to the target file. (will be moved to the real target by the DownloadManager, when the download is finished). This will be null for all callers except for nsExternalHelperAppHandler. Addons should generally pass null for aTempFile. This will be moved to the real target by the download manager when the download is finished, and the action indicated by aMIMEInfo will be executed. |
| aCancelable | An object that can be used to abort the download. Must not be null. |
| aIsPrivate | Used to determine the privacy status of the new download. If true, the download is stored in a manner that leaves no permanent trace outside of the current private session. |
| The newly created download item with the passed-in properties. |
Retrieves a download managed by the download manager. This can be one that
is in progress, or one that has completed in the past and is stored in the
database.
| aID | The unique ID of the download. |
| The download with the specified ID. @throws NS_ERROR_NOT_AVAILABLE if the download is not in the database. |
Retrieves a download managed by the download manager. This can be one that
is in progress, or one that has completed in the past and is stored in the
database. The result of this method is returned via an asynchronous callback,
the parameter of which will be an nsIDownload object, or null if none exists
with the provided GUID.
| aGUID | The unique GUID of the download. |
| aCallback | The callback to invoke with the result of the search. |
Cancels the download with the specified ID if it’s currently in-progress.
This calls cancel(NS_BINDING_ABORTED) on the nsICancelable provided by the
download.
| aID | The unique ID of the download. @throws NS_ERROR_FAILURE if the download is not in-progress. |
Removes the download with the specified id if it’s not currently
in-progress. Whereas cancelDownload simply cancels the transfer, but
retains information about it, removeDownload removes all knowledge of it.
Also notifies observers of the “download-manager-remove-download-guid”
topic with the download guid as the subject to allow any DM consumers to
react to the removal.
Also may notify observers of the “download-manager-remove-download” topic
with the download id as the subject, if the download removed is public
or if global private browsing mode is in use. This notification is deprecated;
the guid notification should be relied upon instead.
| aID | The unique ID of the download. @throws NS_ERROR_FAILURE if the download is active. |
Removes all inactive downloads that were started inclusively within the
specified time frame.
| aBeginTime | The start time to remove downloads by in microseconds. |
| aEndTime | The end time to remove downloads by in microseconds. |
Pause the specified download.
| aID | The unique ID of the download. @throws NS_ERROR_FAILURE if the download is not in-progress. |
Resume the specified download.
| aID | The unique ID of the download. @throws NS_ERROR_FAILURE if the download is not in-progress. |
Retries a failed download.
| aID | The unique ID of the download. @throws NS_ERROR_NOT_AVAILALE if the download id is not known. @throws NS_ERROR_FAILURE if the download is not in the following states: nsIDownloadManager::DOWNLOAD_CANCELED nsIDownloadManager::DOWNLOAD_FAILED |
Removes completed, failed, and canceled downloads from the list.
In global private browsing mode, this operates on the relevant
private or public downloads. In per-window mode, it only operates
on public ones.
Also notifies observers of the “download-manager-remove-download-gui”
and “download-manager-remove-download” topics with a null subject to
allow any DM consumers to react to the removals.
Removes completed, failed, and canceled downloads from the list
of private downloads.
Also notifies observers of the “download-manager-remove-download-gui”
and “download-manager-remove-download” topics with a null subject to
allow any DM consumers to react to the removals.
Adds a listener to the download manager. It is expected that this
listener will only access downloads via their deprecated integer id attribute,
and when global private browsing compatibility mode is disabled, this listener
will receive no notifications for downloads marked private.
Adds a listener to the download manager. This listener must be able to
understand and use the guid attribute of downloads for all interactions
with the download manager.
Removes a listener from the download manager.
The database connection to the downloads database.
Whether or not there are downloads that can be cleaned up (removed)
i.e. downloads that have completed, have failed or have been canceled.
In global private browsing mode, this reports the status of the relevant
private or public downloads. In per-window mode, it only reports for
public ones.
Whether or not there are private downloads that can be cleaned up (removed)
i.e. downloads that have completed, have failed or have been canceled.
The number of files currently being downloaded.
In global private browsing mode, this reports the status of the relevant
private or public downloads. In per-window mode, it only reports public
ones.
The number of private files currently being downloaded.
An enumeration of active nsIDownloads
In global private browsing mode, this reports the status of the relevant
private or public downloads. In per-window mode, it only reports public
ones.
An enumeration of active private nsIDownloads
Returns the platform default downloads directory.
Returns the user configured downloads directory.
The path is dependent on two user configurable prefs
set in preferences:
browser.download.folderList
Indicates the location users wish to save downloaded
files too.
Values:
0 - The desktop is the default download location.
1 - The system’s downloads folder is the default download location.
2 - The default download location is elsewhere as specified in
browser.download.dir. If invalid, userDownloadsDirectory
will fallback on defaultDownloadsDirectory.
browser.download.dir -
A local path the user may have selected at some point
where downloaded files are saved. The use of which is
enabled when folderList equals 2.
Download type for generic file download.
Download state for uninitialized download object.
Download is currently transferring data.
Download completed including any processing of the target
file. (completed)
Transfer failed due to error. (completed)
Download was canceled by the user. (completed)
Transfer was paused by the user.
Download is active but data has not yet been received.
Transfer request was blocked by parental controls proxies. (completed)
Transferred download is being scanned by virus scanners.
A virus was detected in the download. The target will most likely
no longer exist. (completed)
Win specific: Request was blocked by zone policy settings.
(see bug #416683) (completed)