toolkit/mozapps/extensions/amIWebInstallPrompt.idl

   1 /* This Source Code Form is subject to the terms of the Mozilla Public
   2  * License, v. 2.0. If a copy of the MPL was not distributed with this
   3  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   4
   5 #include "nsISupports.idl"
   6
   7 interface nsIURI;
   8 interface nsIVariant;
   9
  10 webidl Element;
  11
  12 /**
  13  * amIWebInstallPrompt is used, if available, by the default implementation of
  14  * amIWebInstallInfo to display a confirmation UI to the user before running
  15  * installs.
  16  */
  17 [scriptable, uuid(386906f1-4d18-45bf-bc81-5dcd68e42c3b)]
  18 interface amIWebInstallPrompt : nsISupports
  19 {
  20   /**
  21    * Get a confirmation that the user wants to start the installs.
  22    *
  23    * @param  aBrowser
  24    *         The browser that triggered the installs
  25    * @param  aUri
  26    *         The URI of the site that triggered the installs
  27    * @param  aInstalls
  28    *         The AddonInstalls that were requested
  29    */
  30   void confirm(in Element aBrowser, in nsIURI aUri,
  31                in Array<nsIVariant> aInstalls);
  32 };