toolkit/mozapps/update/nsIUpdateService.idlScriptable
This interface describes a global application service that handles performing background update checks. It also provides utilities for selecting and downloading update patches.
1.0
66
Introduced
Gecko 1.8
Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

Method overview

void addDownloadListener(in nsIRequestObserver listener);
AString downloadUpdate(in nsIUpdate update, in boolean background);
void pauseDownload();
void removeDownloadListener(in nsIRequestObserver listener);
nsIUpdate selectUpdate([array, size_is(updateCount)] in nsIUpdate updates, in unsigned long updateCount);

Attributes

Attribute Type Description
backgroundChecker nsIUpdateChecker The update checker being used for background update checking. Read only.
canApplyUpdates boolean true if the Update Service can download and install updates. Indicates if the current user has access privileges to the install directory. Read only.
canCheckForUpdates boolean true if the Update Service can check for updates. Application updates might be disabled by the application and the platform the application is running on. Read only.
canUpdate boolean true if the update service is able to download and install updates. This depends on whether or not the current user has the necessary access privileges for the install directory. Read only. Obsolete since Gecko 1.9.1.7pre
isDownloading boolean true if a download is in progress, otherwise false. Read only.

Methods

addDownloadListener()

Adds a listener that receives progress and state information about the update that is currently being downloaded. This information is most commonly used to update a user interface that informs the user as to the status of an update.

void addDownloadListener(
  in nsIRequestObserver listener
);
Parameters
listener
An object implementing nsIRequestObserver and optionally nsIProgressEventSink that will be notified of state and progress information as the update is downloaded.

downloadUpdate()

Starts downloading a software update.

 AString downloadUpdate(
   in nsIUpdate update,
   in boolean background
 );
Parameters
update
An nsIUpdate object indicating the update to download.
background
true to download the update in the background or false to download it in the foreground.
Return value

A string indicating the status of the update upon return:

"downloading"
The update is being downloaded.
"pending"
The update is ready to be applied.
"applying"
The update is in the process of being applied.
"succeeded"
The update has been installed successfully.
"download-failed"
The update failed to be downloaded.
"failed"
Installing the update failed.

pauseDownload()

Pauses the currently active update download.

void pauseDownload();
Parameters

None.

removeDownloadListener()

Removes a listener that is receiving progress and state information about the update that is currently being downloaded.

void removeDownloadListener(
  in nsIRequestObserver listener
);
Parameters
listener
The listener object to remove.

selectUpdate()

Selects the best update to install from a provided list of available updates.

nsIUpdate selectUpdate(
  [array, size_is(updateCount)] in nsIUpdate updates,
  in unsigned long updateCount
);
Parameters
updates
An array of updates that are available to install.
updateCount
The number of updates in the updates array.
Return value

An nsIUpdate object indicating the most appropriate update to install.

See also