||Tells the content handler to take over handling the content. If this
function succeeds, the URI Loader will leave this request alone, ignoring
progress notifications. Failure of this method will cause the request to be
cancelled, unless the error code is NS_ERROR_WONT_HANDLE_CONTENT (see
Window context, used to get things like the current nsIDOMWindow
for this request. May be null.
The content type of aRequest
A request whose content type is already known.
@throw NS_ERROR_WONT_HANDLE_CONTENT Indicates that this handler does not
want to handle this content. A different way for handling this
content should be tried.
||An nsIDocumentLoader is an interface responsible for tracking groups of
loads that belong together (images, external scripts, etc) and subdocuments
(<iframe>, <frame>, etc). It is also responsible for sending
XXXbz this interface should go away, we think...
||Initializes the transfer with certain properties. This function must
be called prior to accessing any properties on this interface.
@param aSource The source URI of the transfer. Must not be null.
@param aTarget The target URI of the transfer. Must not be null.
@param aDisplayName The user-readable description of the transfer.
Can be empty.
@param aMIMEInfo The MIME info associated with the target,
including MIME type and helper app when appropriate.
This parameter is optional.
@param startTime Time when the download started (ie, when the first
response from the server was received)
XXX presumably wbp and exthandler do this differently
@param aTempFile The location of a temporary file; i.e. a file in which
the received data will be stored, but which is not
equal to the target file. (will be moved to the real
target by the caller, when the download is finished)
May be null.
@param aCancelable An object that can be used to abort the download.
Must not be null.
Implementations are expected to hold a strong
reference to this object until the download is
finished, at which point they should release the
@param aIsPrivate Used to determine the privacy status of the new transfer.
If true, indicates that the transfer was initiated from
a source that desires privacy.
@param aDownloadClassification Indicates wheter the download is unwanted,
should be considered dangerous or insecure.
@param aReferrerInfo The Referrer this download is started with
||nsIURIContentListener is an interface used by components which
want to know (and have a chance to handle) a particular content type.
Typical usage scenarios will include running applications which register
a nsIURIContentListener for each of its content windows with the uri
||The uri dispatcher is responsible for taking uri's, determining
the content and routing the opened url to the correct content
When you encounter a url you want to open, you typically call
openURI, passing it the content listener for the window the uri is
originating from. The uri dispatcher opens the url to discover the
content type. It then gives the content listener first crack at
handling the content. If it doesn't want it, the dispatcher tries
to hand it off one of the registered content listeners. This allows
running applications the chance to jump in and handle the content.
If that also fails, then the uri dispatcher goes to the registry
looking for the preferred content handler for the content type
of the uri. The content handler may create an app instance
or it may hand the contents off to a platform specific plugin
or helper app. Or it may hand the url off to an OS registered
||The nsIWebProgress interface is used to add or remove nsIWebProgressListener
instances to observe the loading of asynchronous requests (usually in the
context of a DOM window).
nsIWebProgress instances may be arranged in a parent-child configuration,
corresponding to the parent-child configuration of their respective DOM
windows. However, in some cases a nsIWebProgress instance may not have an
associated DOM window. The parent-child relationship of nsIWebProgress
instances is not made explicit by this interface, but the relationship may
exist in some implementations.
A nsIWebProgressListener instance receives notifications for the
nsIWebProgress instance to which it added itself, and it may also receive
notifications from any nsIWebProgress instances that are children of that
||The nsIWebProgressListener interface is implemented by clients wishing to
listen in on the progress associated with the loading of asynchronous
requests in the context of a nsIWebProgress instance as well as any child
nsIWebProgress instances. nsIWebProgress.idl describes the parent-child
relationship of nsIWebProgress instances.
||An extended version of nsIWebProgressListener.
||Equivalent to nsIURILoader::openChannel, but allows specifying whether the
channel is opened already.