dom/base/nsISiteSpecificUserAgent.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 interface nsIURI;
   8 interface nsIDOMWindow;
   9
  10 /**
  11  * nsISiteSpecificUserAgent provides you with site/window-specific User Agent strings.
  12  */
  13
  14 [scriptable, uuid(a509469a-ef3d-4ad1-8dba-c92a96b0bc64)]
  15 interface nsISiteSpecificUserAgent : nsISupports
  16 {
  17   /**
  18    * Get the User Agent string for a given URI.
  19    *
  20    * @param aURI is the URI of the page the UA string is used for.
  21    *
  22    * @param aWindow is the window this UA is being requested for
  23    *
  24    * @returns the User Agent string for the given URI. If no override applies,
  25    * the default User Agent string is used.
  26    */
  27   AString getUserAgentForURIAndWindow(in nsIURI aURI, in nsIDOMWindow aWindow);
  28 };