Additions to the frozen nsICookieManager
Add a cookie. nsICookieService is the normal way to do this. This
method is something of a backdoor.
| aHost | the host or domain for which the cookie is set. presence of a leading dot indicates a domain cookie; otherwise, the cookie is treated as a non-domain cookie (see RFC2109). The host string will be normalized to ASCII or ACE; any trailing dot will be stripped. To be a domain cookie, the host must have at least two subdomain parts (e.g. '.foo.com', not '.com'), otherwise an exception will be thrown. An empty string is acceptable (e.g. file:// URI's). |
| aPath | path within the domain for which the cookie is valid |
| aName | cookie name |
| aValue | cookie data |
| aIsSecure | true if the cookie should only be sent over a secure connection. |
| aIsHttpOnly | true if the cookie should only be sent to, and can only be modified by, an http connection. |
| aIsSession | true if the cookie should exist for the current session only. see aExpiry. |
| aExpiry | expiration date, in seconds since midnight (00:00:00), January 1, 1970 UTC. note that expiry time will also be honored for session cookies; in this way, the more restrictive of the two will take effect. |
Find whether a given cookie already exists.
| aCookie | the cookie to look for |
| true if a cookie was found which matches the host, path, and name fields of aCookie |
Count how many cookies exist within the base domain of ‘aHost’.
Thus, for a host “weather.yahoo.com”, the base domain would be “yahoo.com”,
and any host or domain cookies for “yahoo.com” and its subdomains would be
counted.
| aHost | the host string to search for, e.g. "google.com". this should consist of only the host portion of a URI. see @add for a description of acceptable host strings. |
| the number of cookies found. |
Returns an enumerator of cookies that exist within the base domain of
‘aHost’. Thus, for a host “weather.yahoo.com”, the base domain would be
“yahoo.com”, and any host or domain cookies for “yahoo.com” and its
subdomains would be returned.
@see countCookiesFromHost
| aHost | the host string to search for, e.g. "google.com". this should consist of only the host portion of a URI. see @add for a description of acceptable host strings. |
| an nsISimpleEnumerator of nsICookie2 objects. |
Import an old-style cookie file. Imported cookies will be added to the
existing database. If the database contains any cookies the same as those
being imported (i.e. domain, name, and path match), they will be replaced.
| aCookieFile | the file to import, usually cookies.txt |
Returns an enumerator of all cookies that are related to a specific app.
If the onlyBrowserELement parameter is set to true, only cookies part of
a browser element inside the app will be returned. If set to false, all
cookies will be returned, regardless of their browserElement flag.
This method assumes that appId is a valid app id. It should not be a
special value like UNKNOWN_APP_ID or NO_APP_ID.
Remove all the cookies associated with the app with the id aAppId.
If onlyBrowserElement is set to true, the method will only remove the
cookies marked as part of a browser element inside the app.
Special app id values are not allowed (NO_APP_ID or UNKNOWN_APP_ID for example).