NPAPI:ClearSiteData: Difference between revisions

Jump to navigation Jump to search

NPAPI:ClearSiteData (view source)

Revision as of 02:39, 24 December 2010

540 bytes removed ,  24 December 2010
no edit summary
No edit summary
Line 35: Line 35:
/* More flags may be defined later, this spec will be updated. */
/* More flags may be defined later, this spec will be updated. */
</pre>
</pre>
* The <code>site</code> argument is interpreted as follows:  
* The <code>site</code> argument is interpreted as follows:
** The preferred form for this argument is an origin: scheme + "://" + domain + optional port preceded by ":" (e.g. "http://mozilla.org:80").
** If <code>NULL</code>, all site-specific data and more generic data on browsing history (for instance, number of sites visited) should be cleared.
** If a hostname of the form "foo.com", data in the "foo.com" domain and all subdomains should be cleared. In this form domains must be in lowercase normalized ACE-encoded form, they must not contain a trailing dot, must not contain a scheme, port, or other such fields, and must contain at least one embedded dot.
** If <code>!NULL</code>, argument is a domain per the domain portion of the URI specification but with a requirement for NFKC-normalized UTF-8 encoding. No other encoding is allowed. All sub-domains of the specified domain are to be cleared as well. If a sub-domain is specified only it and its sub-domains are to be cleared. For example, if a browser specifies "b.a.com" then data for "b.a.com" and "c.b.a.com" is to be cleared but data for "a.com" is not to be cleared.
** If an IP address (either IPv4 or IPv6), data for that IP should be cleared.
** If <code>NULL</code>, all site-specific data and more generic data on browsing history (for instance, number of sites visited) should be cleared.  
* The <code>maxAge</code> argument is the maximum age in seconds of data to clear, inclusive. If <code>maxAge</code> is <code>0</code>, no data is cleared. If <code>maxAge</code> is the maximum unsigned 64-bit integer, all data is cleared.
* The <code>maxAge</code> argument is the maximum age in seconds of data to clear, inclusive. If <code>maxAge</code> is <code>0</code>, no data is cleared. If <code>maxAge</code> is the maximum unsigned 64-bit integer, all data is cleared.


Line 61: Line 59:
* Make sure the requirements for parsing the origin argument are not too much of a burden for plugin developers.
* Make sure the requirements for parsing the origin argument are not too much of a burden for plugin developers.
* Do we need a method for discovering what site data the plugin has? Mozilla and Apple have expressed a strong desire for this.
* Do we need a method for discovering what site data the plugin has? Mozilla and Apple have expressed a strong desire for this.
* What is the syntax for an IPv6 address in site? As per RFC 3986 "IP-literal" ([http://greenbytes.de/tech/webdav/rfc3986.html#host.ip])?
* Suggested that we document what happens when a particular plug-in is keyed by domain, not origin.  This way for simplicity purposes the API can handle both models, regardless of how it's keyed.  The specific suggestion is that for a plug-in that stores domain-keyed info, that plug-in will just strip the protocol and (optional) port.


= Notes =
= Notes =
Josh
Confirmed users, Bureaucrats and Sysops emeriti
1,680

edits

Retrieved from "https://wiki.mozilla.org/Special:MobileDiff/274905"

Navigation menu