DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Mercurial (7fd12a78625c)

VCS Links

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
/* 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"

%{C++
#include "nsStringFwd.h"
#include "nsTArrayForwardDeclare.h"
%}
[ref] native StringArrayRef(nsTArray<nsCString>);
[ref] native ConstStringArrayRef(const nsTArray<nsCString>);

interface nsIChannel;
interface nsIURI;

/**
 * A single URLClassifier feature.
 */
[builtinclass, scriptable, uuid(a6c9b24e-b4f1-426e-af58-2c976c3943a8)]
interface nsIUrlClassifierFeature : nsISupports
{
  cenum listType: 8 {
    blacklist = 0,
    whitelist = 1,
  };

  cenum URIType: 8 {
    blacklistURI = 0,
    whitelistURI = 1,
    pairwiseWhitelistURI = 2,
  };

  /**
   * The feature name
   */
  readonly attribute ACString name;

  /**
   * Returns the tables for one of the possible lists.
   */
  [noscript] StringArrayRef getTables(in nsIUrlClassifierFeature_listType aListType);

  /**
   * Returns true if |aTable| is part of the tables of |aListType| type.
   */
  [noscript] boolean hasTable(in ACString aTable,
                              in nsIUrlClassifierFeature_listType aListType);

  /**
   * Returns true if |aHost| is contained in the preference of |aListType| type.
   * |aPrefTableName| will be set to the table name to use.
   */
  [noscript] boolean hasHostInPreferences(in ACString aHost,
                                          in nsIUrlClassifierFeature_listType aListType,
                                          out ACString aPrefTableName);

  /**
   * Returns a comma-separated list of hosts to be ignored.
   */
  readonly attribute ACString skipHostList;

  /**
   * When this feature matches the channel, this method is executed to do
   * 'something' on the channel. For instance, a tracking-annotation feature
   * would mark the channel as tracker, a tracking-protection feature would
   * cancel the channel.
   * Returns if we should process other feature results or not. For instance,
   * tracking-protection cancel the channel, and after that we should stop
   * processing other features.
   */
  [noscript] boolean processChannel(in nsIChannel aChannel,
                                    in ConstStringArrayRef aList,
                                    in ConstStringArrayRef aHashes);

  /**
   * Features can work with different URLs from a channel (channel url, or
   * top-level, or something else). This method returns what we need to use for
   * the current list.
   * If the returned URI is created by CreatePairwiseWhiteListURI(), the URIType
   * is pairwiseWhitelistURI. Otherwise, it depends on the listType.
   */
  [noscript] nsIURI getURIByListType(in nsIChannel channel,
                                     in nsIUrlClassifierFeature_listType listType,
                                     out nsIUrlClassifierFeature_URIType URIType);
};

/**
 * The result of the classifier operation is this interface.
 * See asyncClassifyLocalWithFeatures() in nsIURIClassifier.idl.
 */
[builtinclass, scriptable, uuid(ccb88140-5d66-4873-9815-a1b98d6cdc92)]
interface nsIUrlClassifierFeatureResult : nsISupports
{
  readonly attribute nsIURI uri;

  readonly attribute nsIUrlClassifierFeature feature;

  // Comma separate tables or preferences.
  readonly attribute ACString list;
};

/**
 * Callback function for nsIURIClassifier lookups.
 * See asyncClassifyLocalWithFeatures() in nsIURIClassifier.idl.
 */
[scriptable, function, uuid(2ea83c26-dfc9-44ed-9cfc-171d4753d78e)]
interface nsIUrlClassifierFeatureCallback : nsISupports
{
  /**
   * Called by the URI classifier service when it is done checking a URI.
   *
   * Clients are responsible for associating callback objects with classify()
   * calls.
   *
   * @param aResults
   *        List of nsIUrlClassifierFeatureResult objects.
   */
  void onClassifyComplete(in Array<nsIUrlClassifierFeatureResult> aResults);
};