The Tor Browser / file revision

 /* This Source Code Form is subject to the terms of the Mozilla Public

  * License, v. 2.0. If a copy of the MPL was not distributed with this

  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

 #include "nsISupports.idl"

 /**

  * An interface to open a dialog to ask to permission to accept the cookie.

  */

 interface nsIDOMWindow;

 interface nsICookie;

 [scriptable, uuid(72f8bb14-2810-4f38-8d0d-290c5401f54e)]

 interface nsICookiePromptService : nsISupports

 {

   const uint32_t DENY_COOKIE = 0;

   const uint32_t ACCEPT_COOKIE = 1;

   const uint32_t ACCEPT_SESSION_COOKIE = 2;

   /* Open a dialog that asks for permission to accept a cookie

    * 

    * @param parent

    * @param cookie

    * @param hostname          the host that wants to set the cookie, 

    *                           not the domain: part of the cookie

    * @param cookiesFromHost   the number of cookies there are already for this host

    * @param changingCookie    are we changing this cookie?

    * @param rememberDecision  should we set the matching permission for this host?

    * @returns                 0 == deny cookie

    *                          1 == accept cookie

    *                          2 == accept cookie for current session

    */

   long cookieDialog(in nsIDOMWindow parent,

                     in nsICookie cookie,

                     in ACString hostname,

                     in long cookiesFromHost,

                     in boolean changingCookie,

                     out boolean rememberDecision);

 };

 %{C++

 #define NS_COOKIEPROMPTSERVICE_CONTRACTID "@mozilla.org/embedcomp/cookieprompt-service;1"

 %}