nsISupports
Last changed in Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3)Method overview
void getRequestVersion(out unsigned long major, out unsigned long minor); |
void getResponseVersion(out unsigned long major, out unsigned long minor); |
void HTTPUpgrade(in ACString aProtocolName, in nsIHttpUpgradeListener aListener); |
void setCookie(in string aCookieHeader); |
void setupFallbackChannel(in string aFallbackKey); |
Attributes
Attribute | Type | Description |
canceled | boolean | Returns true if and only if the channel has been canceled. Read only. |
channelIsForDownload | boolean | External handlers may set this to true to notify the channel that it is open on behalf of a download. |
documentURI | nsIURI | An HTTP channel can own a reference to the document URI. |
forceAllowThirdPartyCookie | boolean | Force relevant cookies to be sent with this load even if normally they would not be. |
localAddress | AUTF8String | The local IP address to which the channel is bound, in the same format produced by Note: If Network Address Translation (NAT) is in effect, this may not be the same address the remote host thinks it is talking to. This may throw an NS_ERROR_NOT_AVAILABLE exception if accessed when the channel's endpoints haven't been determined yet, or any time the nsIHttpActivityObserver.isActive attribute is false . See bug 534698 and bug 526207. Read only. |
localPort | PRInt32 | The local port number to which the channel is bound. This may throw anNS_ERROR_NOT_AVAILABLE exception if accessed when the channel's endpoints haven't been determined yet, or any time the nsIHttpActivityObserver.isActive attribute is false . See bug 534698 and bug 526207. Read only. |
proxyInfo | nsIProxyInfo | Get the proxy info in use by the channel. Read only. Obsolete since Gecko 1.9 |
remoteAddress | AUTF8String | The IP address of the remote host to which this channel is bound, in the same format produced by NS_ERROR_NOT_AVAILABLE exception if accessed when the channel's endpoints haven't been determined yet, or any time the nsIHttpActivityObserver.isActive attribute is false . See bug 534698 and bug 526207. Read only. |
remotePort | PRInt32 | The remote port number to which the channel is bound. This may throw anNS_ERROR_NOT_AVAILABLE exception if accessed when the channel's endpoints haven't been determined yet, or any time the nsIHttpActivityObserver.isActive attribute is false . See bug 534698 and bug 526207. Read only. |
Methods
getRequestVersion()
Gets the request's major and minor version numbers.
void getRequestVersion( out unsigned long major, out unsigned long minor );
Parameters
major
- On return, contains the request's major version number.
minor
- On return, contains the request's minor version number.
getResponseVersion()
Gets the response's major and minor version numbers.
void getResponseVersion( out unsigned long major, out unsigned long minor );
Parameters
major
- On return, contains the response's major version number.
minor
- On return, contains the response's minor version number.
HTTPUpgrade()
Allows for the use of HTTP to bootstrap another protocol via the RFC 2616 Upgrade request header in conjunction with a 101 level response. The nsIHttpUpgradeListener
will have its nsIHttpUpgradeListener.onTransportAvailable()
method invoked if a matching 101 is processed. The arguments to nsIHttpUpgradeListener.onTransportAvailable()
provide to the new protocol the low level transport streams that are no longer used by HTTP.
The onStartRequest
and onStopRequest
events are still delivered and the listener gets full control over the socket if and when nsIHttpUpgradeListener.onTransportAvailable()
is delivered.
void HTTPUpgrade( in ACString aProtocolName, in nsIHttpUpgradeListener aListener );
Parameters
aProtocolName
- The value of the HTTP Upgrade request header.
aListener
- The callback object used to handle a successful upgrade.
setCookie()
Helper method to set a cookie with a consumer-provided cookie header, but using the channel's other information (URI's, prompters, date headers and so on.).
void setCookie( in string aCookieHeader );
Parameters
aCookieHeader
- The cookie header to be parsed.
setupFallbackChannel()
Sets up this channel as an application cache fallback channel.
void setupFallbackChannel( in string aFallbackKey );
Parameters
aFallbackKey
- The fallback key.