mozilla
Your Search Results

    nsIHttpChannelInternal

    An internal interface for HTTP channels. Using features exposed by this interface is not recommended, as it will change in unpredictable ways.
    28
    Introduced
    Gecko 1.0
    Inherits from: 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 PR_NetAddrToString(). This may be either an IPv4 or IPv6 address.

    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 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.
    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 PR_NetAddrToString().

    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.
    remotePort PRInt32

    The remote port number to which the channel is bound.

    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.

    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.

    Requires Gecko 6.0 (Firefox 6.0 / Thunderbird 6.0 / SeaMonkey 2.3)

    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.

    Requires Gecko 1.9.1 (Firefox 3.5 / Thunderbird 3.0 / SeaMonkey 2.0)

    setupFallbackChannel()

    Sets up this channel as an application cache fallback channel.

    void setupFallbackChannel(
      in string aFallbackKey
    );
    
    Parameters
    aFallbackKey
    The fallback key.

    See also

    Document Tags and Contributors

    Contributors to this page: Sheppy, trevorh
    Last updated by: Sheppy,