diff -r 000000000000 -r 6474c204b198 netwerk/protocol/about/nsIAboutModule.idl --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/netwerk/protocol/about/nsIAboutModule.idl Wed Dec 31 06:09:35 2014 +0100 @@ -0,0 +1,58 @@ +/* -*- Mode: C++; tab-width: 2; 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 nsIChannel; + +[scriptable, uuid(9575693c-60d9-4332-b6b8-6c29289339cb)] +interface nsIAboutModule : nsISupports +{ + /** + * Constructs a new channel for the about protocol module. + * + * @param aURI the uri of the new channel + */ + nsIChannel newChannel(in nsIURI aURI); + + /** + * A flag that indicates whether a URI is safe for untrusted + * content. If it is, web pages and so forth will be allowed to + * link to this about: URI, and the about: protocol handler will + * enforce that the principal of channels created for it be based + * on their originalURI or URI (depending on the channel flags), + * by setting their "owner" to null. + * Otherwise, only chrome will be able to link to it. + */ + const unsigned long URI_SAFE_FOR_UNTRUSTED_CONTENT = (1 << 0); + + /** + * A flag that indicates whether script should be enabled for the + * given about: URI even if it's disabled in general. + */ + const unsigned long ALLOW_SCRIPT = (1 << 1); + + /** + * A flag that indicates whether this about: URI doesn't want to be listed + * in about:about, especially if it's not useful without a query string. + */ + const unsigned long HIDE_FROM_ABOUTABOUT = (1 << 2); + + /** + * A method to get the flags that apply to a given about: URI. The URI + * passed in is guaranteed to be one of the URIs that this module + * registered to deal with. + */ + unsigned long getURIFlags(in nsIURI aURI); +}; + +%{C++ + +#define NS_ABOUT_MODULE_CONTRACTID "@mozilla.org/network/protocol/about;1" +#define NS_ABOUT_MODULE_CONTRACTID_PREFIX NS_ABOUT_MODULE_CONTRACTID "?what=" +#define NS_ABOUT_MODULE_CONTRACTID_LENGTH 49 // strlen(NS_ABOUT_MODULE_CONTRACTID_PREFIX) + +%}