window.doNotTrack (was: CVS WWW/2011/tracking-protection/drafts)

David and I had concluded that the requestDNTStatus() method was functionally equivalent to a window.doNotTrack property and so I've made that change to the draft. Please let us know if this is incorrect.

(A previous iteration of this was my action-318.)

Thanks,
Nick

Begin forwarded message:

> Resent-From: public-tracking-commit@w3.org
> From: "CVS User npdoty" <cvsmail@w3.org>
> Subject: CVS WWW/2011/tracking-protection/drafts
> Date: January 22, 2013 11:05:46 PM PST
> To: public-tracking-commit@w3.org
> Archived-At: <http://www.w3.org/mid/E1TxuP4-0003G5-Up@gil.w3.org>
> 
> 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>
> 
>