2012-05-21 15:12:37 +04:00
|
|
|
/* 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/. */
|
2002-09-02 04:14:20 +04:00
|
|
|
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
|
|
|
|
interface nsIURI;
|
2007-07-09 10:19:27 +04:00
|
|
|
interface nsIDOMNode;
|
|
|
|
interface nsISimpleEnumerator;
|
2002-09-02 04:14:20 +04:00
|
|
|
|
2007-07-09 10:19:27 +04:00
|
|
|
[scriptable, uuid(cba513eb-c457-4b93-832c-1a979e66edd1)]
|
2002-09-02 04:14:20 +04:00
|
|
|
interface nsIPrefetchService : nsISupports
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* Enqueue a request to prefetch the specified URI.
|
2002-10-24 07:17:44 +04:00
|
|
|
*
|
|
|
|
* @param aURI the URI of the document to prefetch
|
|
|
|
* @param aReferrerURI the URI of the referring page
|
2007-07-09 10:19:27 +04:00
|
|
|
* @param aSource the DOM node (such as a <link> tag) that requested this
|
|
|
|
* fetch, or null if the prefetch was not requested by a DOM node.
|
2003-03-07 00:37:09 +03:00
|
|
|
* @param aExplicit the link element has an explicit prefetch link type
|
2002-09-02 04:14:20 +04:00
|
|
|
*/
|
2007-07-09 10:19:27 +04:00
|
|
|
void prefetchURI(in nsIURI aURI,
|
|
|
|
in nsIURI aReferrerURI,
|
|
|
|
in nsIDOMNode aSource,
|
|
|
|
in boolean aExplicit);
|
2002-09-02 04:14:20 +04:00
|
|
|
|
2007-03-14 04:52:07 +03:00
|
|
|
/**
|
2008-08-25 07:37:10 +04:00
|
|
|
* @status DEPRECATED This method is no longer used, and will throw
|
|
|
|
* NS_ERROR_NOT_IMPLEMENTED.
|
2007-03-14 04:52:07 +03:00
|
|
|
*/
|
|
|
|
void prefetchURIForOfflineUse(in nsIURI aURI,
|
|
|
|
in nsIURI aReferrerURI,
|
2007-07-09 10:19:27 +04:00
|
|
|
in nsIDOMNode aSource,
|
2007-03-14 04:52:07 +03:00
|
|
|
in boolean aExplicit);
|
|
|
|
|
2007-07-09 10:19:27 +04:00
|
|
|
/**
|
|
|
|
* Enumerate the items in the prefetch queue. Each element in the
|
|
|
|
* enumeration is an nsIDOMLoadStatus.
|
|
|
|
*
|
2008-08-25 07:37:10 +04:00
|
|
|
* @param aIncludeNormalItems include normal prefetch items in the
|
|
|
|
* list. This parameter is deprecated and must be TRUE,
|
|
|
|
* or NS_ERROR_INT_IMPLEMENTED will be thrown.
|
2007-07-09 10:19:27 +04:00
|
|
|
* @param aIncludeOfflineItems include items being fetched for offline
|
2008-08-25 07:37:10 +04:00
|
|
|
* use. This parameter is deprecated and must be FALSE,
|
|
|
|
* or NS_ERROR_NOT_IMPLEMENTED will be thrown.
|
2007-07-09 10:19:27 +04:00
|
|
|
*/
|
|
|
|
nsISimpleEnumerator enumerateQueue(in boolean aIncludeNormalItems,
|
|
|
|
in boolean aIncludeOfflineItems);
|
|
|
|
|
2002-09-02 04:14:20 +04:00
|
|
|
// XXX do we need a way to cancel prefetch requests?
|
|
|
|
};
|