michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "nsISupports.idl"
michael@0: 
michael@0: interface nsIURI;
michael@0: interface nsIDOMWindow;
michael@0: 
michael@0: /**
michael@0:  * nsISiteSpecificUserAgent provides you with site/window-specific User Agent strings.
michael@0:  */
michael@0: 
michael@0: [scriptable, uuid(a509469a-ef3d-4ad1-8dba-c92a96b0bc64)]
michael@0: interface nsISiteSpecificUserAgent : nsISupports
michael@0: {
michael@0:   /**
michael@0:    * Get the User Agent string for a given URI.
michael@0:    *
michael@0:    * @param aURI is the URI of the page the UA string is used for.
michael@0:    *
michael@0:    * @param aWindow is the window this UA is being requested for
michael@0:    *
michael@0:    * @returns the User Agent string for the given URI. If no override applies,
michael@0:    * the default User Agent string is used.
michael@0:    */
michael@0:   AString getUserAgentForURIAndWindow(in nsIURI aURI, in nsIDOMWindow aWindow);
michael@0: };