- 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