netwerk/cookie/nsIThirdPartyCookieBlockingExceptionListService.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 /**
   8  * Helper for syncing remote exception lists for third-party cookie blocking.
   9  */
  10 [scriptable, uuid(1ee0cc18-c968-4105-a895-bdea08e187eb)]
  11 interface nsIThirdPartyCookieBlockingExceptionListService : nsISupports {
  12   /**
  13      * Initialize the service and import exceptions.
  14      * Resolves once the initial set of exceptions has been imported.
  15      */
  16     Promise init();
  17
  18     /**
  19      * Shutdown the service.
  20      */
  21     void shutdown();
  22 };
  23
  24 [scriptable, uuid(8200e12c-416c-42eb-8af5-db9745d2e527)]
  25 interface nsIThirdPartyCookieExceptionEntry : nsISupports {
  26   // The first-party site of the exception. This can be a wildcard to match all
  27   // first-party sites.
  28   readonly attribute ACString firstPartySite;
  29
  30   // The third-party site of the exception.
  31   readonly attribute ACString thirdPartySite;
  32
  33   // Serialize the entry to a string in the format
  34   // "firstPartySite,thirdPartySite".
  35   ACString serialize();
  36 };
  37
  38 %{C++
  39 #define NS_NSITHIRDPARTYCOOKIEBLOCKINGEXCEPTIONLISTSERVICE_CONTRACTID "@mozilla.org/third-party-cookie-blocking-exception-list-service;1"
  40 %}