nsINetUtil provides various network-related utility methods.
Parse a content-type header and return the content type and
charset (if any).
| aTypeHeader | the header string to parse |
| [out] | aCharset the charset parameter specified in the header, if any. |
| [out] | aHadCharset whether a charset was explicitly specified. |
| the MIME type specified in the header, in lower-case. |
Test whether the given URI’s handler has the given protocol flags.
| aURI | the URI in question |
| aFlags | the flags we're testing for. |
| whether the protocol handler for aURI has all the flags in aFlags. |
Test whether the protocol handler for this URI or that for any of
its inner URIs has the given protocol flags. This will QI aURI to
nsINestedURI and walk the nested URI chain.
| aURI | the URI in question |
| aFlags | the flags we're testing for. |
| whether any of the protocol handlers involved have all the flags in aFlags. |
Take aURI and produce an immutable version of it for the caller. If aURI
is immutable this will be aURI itself; otherwise this will be a clone,
marked immutable if possible. Passing null to this method is allowed; in
that case it will return null.
Create a simple nested URI using the result of
toImmutableURI on the passed-in aURI which may not be null.
Note: The return URI will not have had its spec set yet.
escape a string with %00-style escaping
%XX-Escape invalid chars in a URL segment.
| aStr | the URL to be escaped |
| aFlags | the URL segment type flags |
| the escaped string (the string itself if escaping did not happen) |
Expands URL escape sequences
| aStr | the URL to be unescaped |
| aFlags | only ESCAPE_URL_ONLY_NONASCII and ESCAPE_URL_SKIP_CONTROL are recognized. If |aFlags| is 0 all escape sequences are unescaped |
| unescaped string |
Extract the charset parameter location and value from a content-type
header.
| aTypeHeader | the header string to parse |
| [out] | aCharset the charset parameter specified in the header, if any. |
| [out] | aCharsetStart index of the start of the charset parameter (the ';' separating it from what came before) in aTypeHeader. If this function returns false, this argument will still be set, to the index of the location where a new charset should be inserted. |
| [out] | aCharsetEnd index of the end of the charset parameter (the ';' separating it from what comes after, or the end of the string) in aTypeHeader. If this function returns false, this argument will still be set, to the index of the location where a new charset should be inserted. |
| whether a charset parameter was found. This can be false even in cases when parseContentType would claim to have a charset, if the type that won out does not have a charset parameter specified. |
Escape every character with its %XX-escaped equivalent */
Leave alphanumeric characters intact and %XX-escape all others */
Leave alphanumeric characters intact, convert spaces to ‘+’,
%XX-escape all others */
Leave alphanumeric characters and forward slashes intact,
%XX-escape all others */
%XX-escape URL scheme */
%XX-escape username in the URL */
%XX-escape password in the URL */
%XX-escape URL host */
%XX-escape URL directory */
%XX-escape file basename in the URL */
%XX-escape file extension in the URL */
%XX-escape URL parameters */
%XX-escape URL query */
%XX-escape URL ref */
%XX-escape URL path - same as escaping directory, basename and extension */
%XX-escape scheme, username, password, host, path, params, query and ref */
Force %XX-escaping of already escaped sequences */
Skip non-ascii octets, %XX-escape all others */
Skip graphic octets (0x20-0x7E) when escaping
Skips all ASCII octets (0x00-0x7F) when unescaping
Force %XX-escape of colon */
Skip C0 and DEL from unescaping */