xpcom/base/nsILoadURIDelegate.idl
author Eugen Sawin <esawin@mozilla.com>
Wed, 28 Feb 2018 00:24:52 +0100
changeset 761271 f248db9bdb5c5fae6bc7f1fcede2eff6dc4808e8
parent 659206 47b2e91b1060844712405ab8566c1cb359cd5958
child 821610 9a8f58cb7315a92f9ebede217e1b8d968c5e5a1b
permissions -rw-r--r--
Bug 1441964 - [1.0] Return URI-load delegation success state instead of throwing. r=snorp

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/* 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"

interface nsIURI;
interface nsIPrincipal;

/**
 * The nsILoadURIDelegate interface.
 * Used for delegating URI loads to GeckoView's application, e.g., Custom Tabs
 * or Progressive Web Apps.
 */
[scriptable, uuid(78e42d37-a34c-4d96-b901-25385669aba4)]
interface nsILoadURIDelegate : nsISupports
{
  /**
   * Delegates the URI load.
   *
   * @param aURI The URI to load.
   * @param aWhere See possible values described in nsIBrowserDOMWindow.
   * @param aFlags Flags which control the behavior of the load.
   * @param aTriggeringPrincipal The principal that triggered the load of aURI.
  */
  boolean
  loadURI(in nsIURI aURI, in short aWhere, in long aFlags,
          in nsIPrincipal aTriggeringPrincipal);
};