summaryrefslogtreecommitdiffstats
path: root/browser/components/newtab/nsIAboutNewTabService.idl
blob: e8ddd0381f569aceb4a7662824b3907a870b0d66 (plain)
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
/* 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"

/**
 * Allows to override about:newtab to point to a different location
 * than the one specified within AboutRedirector.cpp
 */

interface nsIChannel;
interface nsIURI;
interface nsILoadInfo;

[scriptable, uuid(dfcd2adc-7867-4d3a-ba70-17501f208142)]
interface nsIAboutNewTabService : nsISupports
{
  /**
   * Returns the default URL (local or activity stream depending on pref)
   */
  readonly attribute ACString defaultURL;

  /**
   * In the "privileged about content process", if about:home is being
   * retrieved, the AboutRedirector will call this function to get the
   * nsIChannel for the document. This gives the nsIAboutNewTabService
   * the opportunity to provide a cached document for about:home. If
   * no cache exists, the nsIChannel will be for the normal dynamically
   * generated about:home document.
   */
  nsIChannel aboutHomeChannel(in nsIURI aURI,
                              in nsILoadInfo aLoadInfo);

  /**
   * Returns the about:welcome URL.
   */
  readonly attribute ACString welcomeURL;
};