Update of /w3ccvs/WWW/2011/tracking-protection/drafts
In directory gil:/tmp/cvs-serv12525
Modified Files:
tracking-dnt.html
Log Message:
window.doNotTrack property equivalent to dsinger's query status method
--- /w3ccvs/WWW/2011/tracking-protection/drafts/tracking-dnt.html 2013/01/22 08:23:15 1.179
+++ /w3ccvs/WWW/2011/tracking-protection/drafts/tracking-dnt.html 2013/01/23 07:05:46 1.180
@@ -420,24 +420,26 @@
</section>
<section id='js-dom'>
- <h3>JavaScript API to Detect Preference</h3>
+ <h3>JavaScript Property to Detect Preference</h3>
<p class="issue" data-number="160" title="Do we need an exception-query API?"><b>[PENDING REVIEW]</b>
It might be useful, and 'complete the model', if we had a JS API that told a host what its current exception status is in a given context. See proposal here.<br />
- <b>Proposal</b>: Specifically, an API QueryExceptionStatus() which examines the <b>document origin</b> of the script, the current <b>top-level origin</b> and returns an empty string if no DNT header would be sent to that document origin, or the exact DNT header (DNT:1 or DNT:0) that would be sent otherwise.
+ <b>Proposal</b>: Specifically, a doNotTrack property which examines the <b>document origin</b> of the window, the current <b>top-level origin</b> and returns null if no DNT header would be sent to that document origin, or the exact DNT header (DNT:1 or DNT:0) that would be sent otherwise.
</p>
- <p>This call enables a site to determine what DNT header would be sent to it
- in the current context, taking into account the user's general preference
- (if any) and any exceptions.</p>
- <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
- <dt>DOMString requestDNTStatus( )</dt>
+ <p>
+ This property enables a site executing code in its own origin
+ to determine what DNT header would be sent to it in the current
+ context, taking into account the user's general preference (if
+ any) and any user-granted exceptions.</p>
+ <dl class="idl" title='[NoInterfaceObject] interface WindowDoNotTrack'>
+ <dt>attribute DOMString doNotTrack</dt>
<dd>
Returns the same string value that would be sent in a
<a>DNT-field-value</a> (<a href="#dnt-header-field"
class="sectionRef"></a>) to a <strong>target</strong> that is the
- document-origin of the request, in the
+ document-origin of the <code>window</code>, in the
context of the current <strong>top-level origin</strong>. If no DNT
header would be sent (e.g. because a tracking preference is
- <a>not enabled</a>) the return value is <code>null</code>.
+ <a>not enabled</a>) the value is <code>null</code>.
</dd>
</dl>
</section>