Skip to content

Commit

Permalink
Clarify that some device ids may not be origin-unique
Browse files Browse the repository at this point in the history
  • Loading branch information
youennf committed Jun 21, 2019
1 parent f8e41c9 commit d3eb130
Showing 1 changed file with 16 additions and 12 deletions.
28 changes: 16 additions & 12 deletions getusermedia.html
Original file line number Diff line number Diff line change
Expand Up @@ -3072,15 +3072,18 @@ <h2>Attributes</h2>
<dt id="def-mediadeviceinfo-deviceId"><dfn><code>deviceId</code></dfn>
of type <span class="idlAttrType">DOMString</span>, readonly</dt>
<dd>
<p>A unique identifier for the represented device.</p>
<p>All enumerable devices have an identifier that MUST be unique
to the page's origin. Some sort of UUID is recommended for the
identifier. The same identifier MUST be valid between
browsing sessions of this origin, but MUST also be different for
other origins. In particular, this identifier MUST be un-guessable
by applications of other origins to prevent the identifier from
being used to correlate the same user across different
origins.</p>
<p>The identifier of the represented device. The device MUST be
uniquely identified by its identifier and its <code><a
href="#def-mediadeviceinfo-kind">kind</a></code>.</p>
<p>The same identifier MUST be valid between browsing sessions of
this origin. The identifier SHOULD be origin-unique,
in which case some sort of UUID is recommended.
If the identifier can uniquely identify the user, as is usually
the case with UUID, it MUST be un-guessable by browsing contexts
of other origins to prevent the identifier from being used to
correlate the same user across different origins. An identifier
can be reused across origins as long as it is not tied to the user
and can be guessed by other means, like the User-Agent string.</p>
<p>If any local devices have been attached to a live
MediaStreamTrack in a page from this origin, or <a href=
"#stored-permissions">stored permission</a> to access local
Expand All @@ -3107,10 +3110,11 @@ <h2>Attributes</h2>
user agents MUST reset per-origin device identifiers when other
persistent storage are cleared.</p>
</dd>
<dt><dfn><code>kind</code></dfn> of type <span class=
"idlAttrType"><a>MediaDeviceKind</a></span>, readonly</dt>
<dt id="def-mediadeviceinfo-kind"><dfn><code>kind</code></dfn> of
type <span class= "idlAttrType"><a>MediaDeviceKind</a></span>,
readonly</dt>
<dd>
<p>Describes the kind of the represented device.</p>
<p>The kind of the represented device.</p>
</dd>
<dt><dfn><code>label</code></dfn> of type <span class=
"idlAttrType">DOMString</span>, readonly</dt>
Expand Down

0 comments on commit d3eb130

Please sign in to comment.