amIWebInstallListener

Starts all installs. The registered amIWebInstallListener is used to notify about new installs triggered by websites. The default implementation displays a confirmation dialog when add-ons are ready to install and uses the observer service to notify when installations are blocked.
1.0
28
Introduced
Gecko 2.0
Inherits from: nsISupports Last changed in Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5)

Method overview

boolean onWebInstallBlocked(in nsIDOMWindow aWindow, in nsIURI aUri, [array, size_is(aCount)] in nsIVariant aInstalls, [optional] in PRUint32 aCount);
void onWebInstallDisabled(in nsIDOMWindow aWindow, in nsIURI aUri, [array, size_is(aCount)] in nsIVariant aInstalls, [optional] in PRUint32 aCount);
boolean onWebInstallRequested(in nsIDOMWindow aWindow, in nsIURI aUri, [array, size_is(aCount)] in nsIVariant aInstalls, [optional] in PRUint32 aCount);

Note: Prior to Gecko 8.0, all references to nsIDOMWindow used in this interface were nsIDOMWindowInternal.

Methods

onWebInstallBlocked()

Called when the website is not allowed to directly prompt the user to install add-ons.

boolean onWebInstallBlocked(
  in nsIDOMWindow aWindow,
  in nsIURI aUri,
  [array, size_is(aCount)] in nsIVariant aInstalls,
  in PRUint32 aCount Optional
);
Parameters
aWindow
The window that triggered the installs.
aUri
The URI of the site that triggered the installs.
aInstalls
The AddonInstalls that were blocked.
aCount Optional
The number of AddonInstalls.
Return value

true if the caller should start the installs.

onWebInstallDisabled()

Called when installation by websites is currently disabled.

void onWebInstallDisabled(
  in nsIDOMWindow aWindow,
  in nsIURI aUri,
  [array, size_is(aCount)] in nsIVariant aInstalls,
  in PRUint32 aCount Optional
);
Parameters
aWindow
The window that triggered the installs.
aUri
The URI of the site that triggered the installs.
aInstalls
The AddonInstalls that were blocked.
aCount Optional
The number of AddonInstalls.

onWebInstallRequested()

Called when a website wants to ask the user to install add-ons.

boolean onWebInstallRequested(
  in nsIDOMWindow aWindow,
  in nsIURI aUri,
  [array, size_is(aCount)] in nsIVariant aInstalls,
  in PRUint32 aCount Optional
);
Parameters
aWindow
The window that triggered the installs.
aUri
The URI of the site that triggered the installs.
aInstalls
The AddonInstalls that were requested.
aCount Optional
The number of AddonInstalls.
Return value

true if the caller should start the installs.

Document Tags and Contributors

Contributors to this page: Sheppy, trevorh, kscarfone
Last updated by: Sheppy,