WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the
XUL hub at the
Mozilla Developer Center.
@mozilla.org/network/urichecker;1
This component implements the following interfaces:
Constants
| No special load flags:
|
| PRUint32 |
nsIRequest.LOAD_NORMAL |
= 0 |
| Don't deliver status notifications to the nsIProgressEventSink, or keep
this load from completing the nsILoadGroup it may belong to.
|
| PRUint32 |
nsIRequest.LOAD_BACKGROUND |
= 1 |
| This flag prevents caching of any kind. It does not, however, prevent
cached content from being used to satisfy this request.
|
| PRUint32 |
nsIRequest.INHIBIT_CACHING |
= 128 |
| This flag prevents caching on disk (or other persistent media), which
may be needed to preserve privacy. For HTTPS, this flag is set auto-
matically.
|
| PRUint32 |
nsIRequest.INHIBIT_PERSISTENT_CACHING |
= 256 |
| Force an end-to-end download of content data from the origin server.
This flag is used for a shift-reload.
|
| PRUint32 |
nsIRequest.LOAD_BYPASS_CACHE |
= 512 |
| Load from the cache, bypassing protocol specific validation logic. This
flag is used when browsing via history. It is not recommended for normal
browsing as it may likely violate reasonable assumptions made by the
server and confuse users.
|
| PRUint32 |
nsIRequest.LOAD_FROM_CACHE |
= 1024 |
| The following flags control the frequency of cached content validation
when neither LOAD_BYPASS_CACHE or LOAD_FROM_CACHE are set. By default,
cached content is automatically validated if necessary before reuse.
VALIDATE_ALWAYS forces validation of any cached content independent of
its expiration time.
VALIDATE_NEVER disables validation of expired content.
VALIDATE_ONCE_PER_SESSION disables validation of expired content,
provided it has already been validated (at least once) since the start
of this session.
NOTE TO IMPLEMENTORS:
These flags are intended for normal browsing, and they should therefore
not apply to content that must be validated before each use. Consider,
for example, a HTTP response with a "Cache-control: no-cache" header.
According to RFC2616, this response must be validated before it can
be taken from a cache. Breaking this requirement could result in
incorrect and potentially undesirable side-effects.
|
| PRUint32 |
nsIRequest.VALIDATE_ALWAYS |
= 2048 |
| PRUint32 |
nsIRequest.VALIDATE_NEVER |
= 4096 |
| PRUint32 |
nsIRequest.VALIDATE_ONCE_PER_SESSION |
= 8192 |
Properties
nsLoadFlags nsIRequest.loadFlags
When added to a load group, this request's load flags are merged with
the load flags of the load group.
readonly AUTF8String nsIRequest.name
readonly nsresult nsIRequest.status
Methods
| Interface | Method |
| nsIURIChecker |
void asyncCheck ( nsIRequestObserver observer , nsISupports context )
|
| nsIRequest |
void cancel ( nsresult status )
|
| nsIInterfaceRequestor |
void getInterface ( nsIIDRef uuid , out nsQIResult* result )
|
| nsIURIChecker |
void init ( nsIURI URI )
|
| nsIRequest |
PRBool isPending ( )
|
| nsIStreamListener |
void onDataAvailable ( nsIRequest request , nsISupports context , nsIInputStream inputStream , PRUint32 offset , PRUint32 count )
|
| nsIHttpEventSink |
void onRedirect ( nsIHttpChannel httpChannel , nsIChannel newChannel )
|
| nsIRequestObserver |
void onStartRequest ( nsIRequest request , nsISupports context )
|
| nsIRequestObserver |
void onStopRequest ( nsIRequest request , nsISupports context , nsresult statusCode )
|
| nsIRequest |
void resume ( )
|
| nsIRequest |
void suspend ( )
|
Reference documentation is generated from Mozilla's source.