docshell/base/nsILoadURIDelegate.idl

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this
   4  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   5
   6 /*
   7  */
   8
   9 #include "nsISupports.idl"
  10
  11 interface nsIURI;
  12 interface nsIPrincipal;
  13
  14 /**
  15  * The nsILoadURIDelegate interface.
  16  * Used for delegating URI loads to GeckoView's application, e.g., Custom Tabs
  17  * or Progressive Web Apps.
  18  */
  19 [scriptable, uuid(78e42d37-a34c-4d96-b901-25385669aba4)]
  20 interface nsILoadURIDelegate : nsISupports
  21 {
  22   /**
  23    * Delegates page load error handling. This may be called for either top-level
  24    * loads or subframes.
  25    *
  26    * @param aURI The URI that failed to load.
  27    * @param aError The error code.
  28    * @param aErrorModule The error module code.
  29
  30    * Returns an error page URL to load, or null to show the default error page.
  31    * No error page is shown at all if an error is thrown.
  32    */
  33   nsIURI
  34   handleLoadError(in nsIURI aURI, in nsresult aError, in short aErrorModule);
  35 };