- From: Roy Fielding via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 14 Aug 2012 08:54:27 +0000
- To: public-tracking-commit@w3.org
Update of /w3ccvs/WWW/2011/tracking-protection/drafts In directory hutz:/tmp/cvs-serv11481 Modified Files: tracking-dnt.html Log Message: ISSUE-84 and ISSUE-116: Update the text describing the DOM attribute to clarify that it only describes the general, non-exceptioned preference. (editorial) Remove WebIDL section headers. (editorial) Transition to simpler/modern form of WebIDL partial interfaces. Index: tracking-dnt.html =================================================================== RCS file: /w3ccvs/WWW/2011/tracking-protection/drafts/tracking-dnt.html,v retrieving revision 1.152 retrieving revision 1.153 diff -u -d -r1.152 -r1.153 --- tracking-dnt.html 14 Aug 2012 03:52:06 -0000 1.152 +++ tracking-dnt.html 14 Aug 2012 08:54:25 -0000 1.153 @@ -24,6 +24,7 @@ wgPublicList: "public-tracking", wgPatentURI: "http://www.w3.org/2004/01/pp-impl/49311/status", issueBase: "http://www.w3.org/2011/tracking-protection/track/issues/", + noIDLSectionTitle: true, }; </script> <link rel="stylesheet" href="additional.css" type="text/css" media="screen" title="custom formatting for TPWG editors" charset="utf-8"> @@ -409,53 +410,47 @@ <section id='js-dom'> <h3>JavaScript API to Detect Preference</h3> - <section id='js-interface'> - <h4>Interface</h4> - <p> - The <a>NavigatorDoNotTrack</a> interface provides a means for - the user's tracking preference to be expressed to - web applications running within a page rendered by the user agent. - </p> - </section> - - <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'> + <p> + A <a>doNotTrack</a> attribute on the <code>Navigator</code> + interface [[!NAVIGATOR]] (e.g., the <code>window.navigator</code> + object) is hereby defined as the means for expressing the user's + general tracking preference to scripts running within a top-level + page. A user agent MUST provide a <code>doNotTrack</code> attribute + on the <code>Navigator</code> interface for each top-level page. + </p> + <dl class="idl" title='partial interface Navigator { + readonly attribute DOMString doNotTrack; + };'> <dt>readonly attribute DOMString doNotTrack</dt> <dd> - When a tracking preference is <a>enabled</a>, the doNotTrack - attribute MUST have a string value that is the same as the - <a>DNT-field-value</a> defined in <a href="#dnt-header-field" - class="sectionRef"></a> sent to the origin of the corresponding - top-level document. If a tracking preference is <a>not - enabled</a>, the value is <code>null</code>. + When a tracking preference is <a>enabled</a>, the + <code>doNotTrack</code> attribute for each top-level page MUST + have the same string value that would be sent in a + <a>DNT-field-value</a> (<a href="#dnt-header-field" + class="sectionRef"></a>) to an origin server that does not have + any corresponding user-granted exceptions. + When a tracking preference is <a>not enabled</a>, the + <code>doNotTrack</code> attribute for each top-level page MUST + have a value of <code>null</code>. </dd> </dl> - - <section id='js-implements'> - <h4>Implements</h4> - <div class="idl" title='Navigator implements NavigatorDoNotTrack'> - <p> - Objects implementing the <code>Navigator</code> interface - [[!NAVIGATOR]] (e.g., the <code>window.navigator</code> object) - MUST also implement the <code>NavigatorDoNotTrack</code></a> - interface. An instance of <code>NavigatorDoNotTrack</code> is - obtained by using binding-specific casting methods on an - instance of <code>Navigator</code>. - </p> - <p> - The value of the <code>doNotTrack</code> attribute SHOULD be - considered guidance and MUST NOT be interpreted as a guarantee - of the value of the DNT header sent on future requests. A - user's tracking preference may change and may differ for - different origins. Servers MUST rely on the DNT header received - in a request even if it differs from what a script previously - observed in the <code>doNotTrack</code> attribute. Trackers - that commonly expect to receive a user-granted exception (as - described in <a href="#exceptions" class="sectionRef"></a>) - SHOULD assess the user's preference in the HTTP request loading - that script. - </p> - </div> - </section> + <p> + The <code>doNotTrack</code> attribute only provides the user's + general tracking preference, independent of any user-granted + exceptions or out-of-band consent. A script wishing to determine + the specific tracking preference for a given document origin is + expected to use the API in <a href="#exceptions-enquiry" + class="sectionRef"></a>. + </p> + <p> + A user agent MUST provide a <code>doNotTrack</code> attribute + value that is consistent with the user's current tracking + preference that would be expressed via the DNT header field. + However, changes to the user's preference might occur between + the time when the APIs are checked and an actual request is made. + A server MUST treat the user's most recently received preference as + authoritative. + </p> <p class="issue" data-number="84" title="Make DNT status available to JavaScript"> <strong>[PENDING REVIEW]</strong> Updated text in this section.
Received on Tuesday, 14 August 2012 08:54:30 UTC