[html5] r2405 - [] (0) Remove bufferedBytes and totalBytes.
whatwg at whatwg.org
whatwg at whatwg.org
Sat Nov 15 11:34:34 PST 2008
Author: ianh
Date: 2008-11-15 11:34:34 -0800 (Sat, 15 Nov 2008)
New Revision: 2405
Modified:
index
source
Log:
[] (0) Remove bufferedBytes and totalBytes.
Modified: index
===================================================================
--- index 2008-11-15 19:28:46 UTC (rev 2404)
+++ index 2008-11-15 19:34:34 UTC (rev 2405)
@@ -447,9 +447,8 @@
<li><a href=#seeking><span class=secno>4.8.10.10 </span>Seeking</a></li>
<li><a href=#user-interface><span class=secno>4.8.10.11 </span>User interface</a></li>
<li><a href=#time-ranges><span class=secno>4.8.10.12 </span>Time ranges</a></li>
- <li><a href=#byte-ranges><span class=secno>4.8.10.13 </span>Byte ranges</a></li>
- <li><a href=#mediaevents><span class=secno>4.8.10.14 </span>Event summary</a></li>
- <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.15 </span>Security and privacy considerations</a></ol></li>
+ <li><a href=#mediaevents><span class=secno>4.8.10.13 </span>Event summary</a></li>
+ <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.14 </span>Security and privacy considerations</a></ol></li>
<li><a href=#the-canvas-element><span class=secno>4.8.11 </span>The <code>canvas</code> element</a>
<ol>
<li><a href=#the-2d-context><span class=secno>4.8.11.1 </span>The 2D context</a>
@@ -16853,8 +16852,6 @@
readonly attribute float <a href=#dom-media-bufferingrate title=dom-media-bufferingRate>bufferingRate</a>;
readonly attribute boolean <a href=#dom-media-bufferingthrottled title=dom-media-bufferingThrottled>bufferingThrottled</a>;
readonly attribute <a href=#timeranges>TimeRanges</a> <a href=#dom-media-buffered title=dom-media-buffered>buffered</a>;
- readonly attribute <a href=#byteranges>ByteRanges</a> <a href=#dom-media-bufferedbytes title=dom-media-bufferedBytes>bufferedBytes</a>;
- readonly attribute unsigned long <a href=#dom-media-totalbytes title=dom-media-totalBytes>totalBytes</a>;
void <a href=#dom-media-load title=dom-media-load>load</a>();
DOMString <a href=#dom-navigator-canplaytype title=dom-navigator-canPlayType>canPlayType</a>(in DOMString type);
@@ -17633,30 +17630,20 @@
attribute must return a static <a href=#normalized-timeranges-object>normalized
<code>TimeRanges</code> object</a> that represents the ranges of
the <a href=#media-resource>media resource</a>, if any, that the user agent has
- buffered, at the time the attribute is evaluated.</p>
+ buffered, at the time the attribute is evaluated. Users agents must
+ accurately determine the ranges available, even for media streams
+ where this can only be determined by tedious inspection.</p>
<p class=note>Typically this will be a single range anchored at
the zero point, but if, e.g. the user agent uses HTTP range requests
in response to seeking, then there could be multiple ranges.</p>
- <p>The <dfn id=dom-media-bufferedbytes title=dom-media-bufferedBytes><code>bufferedBytes</code></dfn>
- attribute must return a static <a href=#normalized-byteranges-object>normalized
- <code>ByteRanges</code> object</a> that represents the ranges of
- the <a href=#media-resource>media resource</a>, if any, that the user agent has
- buffered, at the time the attribute is evaluated.</p>
-
- <p>The <dfn id=dom-media-totalbytes title=dom-media-totalBytes><code>totalBytes</code></dfn> attribute
- must return the length of the <a href=#media-resource>media resource</a>, in bytes,
- if it is known and finite. If it is not known, is infinite
- (e.g. streaming radio), or if no <a href=#media-data>media data</a> is
- available, the attribute must return 0.</p>
-
<p>User agents may discard previously buffered data.</p>
- <p class=note>Thus, a time or byte position included within a
- range of the objects return by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code> or <code title=dom-media-bufferedBytes><a href=#dom-media-bufferedbytes>bufferedBytes</a></code> attributes at
- one time can end up being not included in the range(s) of objects
- returned by the same attributes at a later time.</p>
+ <p class=note>Thus, a time position included within a range of the
+ objects return by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code> attribute at one time can
+ end up being not included in the range(s) of objects returned by the
+ same attribute at later times.</p>
@@ -18436,54 +18423,8 @@
- <h5 id=byte-ranges><span class=secno>4.8.10.13 </span>Byte ranges</h5>
+ <h5 id=mediaevents><span class=secno>4.8.10.13 </span>Event summary</h5>
- <p>Objects implementing the <code><a href=#byteranges>ByteRanges</a></code> interface
- represent a list of ranges of bytes.</p>
-
- <pre class=idl>interface <dfn id=byteranges>ByteRanges</dfn> {
- readonly attribute unsigned long <a href=#dom-byteranges-length title=dom-ByteRanges-length>length</a>;
- unsigned long <a href=#dom-byteranges-start title=dom-ByteRanges-start>start</a>(in unsigned long index);
- unsigned long <a href=#dom-byteranges-end title=dom-ByteRanges-end>end</a>(in unsigned long index);
-};</pre>
-
- <p>The <dfn id=dom-byteranges-length title=dom-ByteRanges-length><code>length</code></dfn>
- DOM attribute must return the number of ranges represented by the object.</p>
-
- <p>The <dfn id=dom-byteranges-start title=dom-ByteRanges-start><code>start(<var title="">index</var>)</code></dfn> method must return the position
- of the first byte of the <var title="">index</var>th range
- represented by the object.</p>
-
- <p>The <dfn id=dom-byteranges-end title=dom-ByteRanges-end><code>end(<var title="">index</var>)</code></dfn> method must return the position
- of the byte immediately after the last byte of the <var title="">index</var>th range represented by the object. (The byte
- position returned by this method is not in the range itself. If the
- first byte of the range is the byte at position 0, and the entire
- stream of bytes is in the range, then the value of the position of
- the byte returned by this method for that range will be the same as
- the number of bytes in the stream.)</p>
-
- <p>These methods must raise <code>INDEX_SIZE_ERR</code> exceptions
- if called with an <var title="">index</var> argument greater than or
- equal to the number of ranges represented by the object.</p>
-
- <p>When a <code><a href=#byteranges>ByteRanges</a></code> object is said to be a
- <dfn id=normalized-byteranges-object>normalized <code>ByteRanges</code> object</dfn>, the ranges it
- represents must obey the following criteria:</p>
-
- <ul><li>The start of a range must be greater than the end of all
- earlier ranges.</li>
-
- <li>The start of a range must be less than the end of that same
- range.</li>
-
- </ul><p>In other words, the ranges in such an object are ordered, don't
- overlap, aren't empty, and don't touch (adjacent ranges are folded
- into one bigger range).</p>
-
-
-
- <h5 id=mediaevents><span class=secno>4.8.10.14 </span>Event summary</h5>
-
<p>The following events fire on <a href=#media-element title="media element">media
elements</a> as part of the processing model described above:</p>
@@ -18586,7 +18527,7 @@
<td><code>Event</code>
<td>Either the <code title=dom-media-volume><a href=#dom-media-volume>volume</a></code> attribute or the <code title=dom-media-muted><a href=#dom-media-muted>muted</a></code> attribute has changed. Fired after the relevant attribute's setter has returned.
<td>
- </table><h5 id=security-and-privacy-considerations><span class=secno>4.8.10.15 </span>Security and privacy considerations</h5>
+ </table><h5 id=security-and-privacy-considerations><span class=secno>4.8.10.14 </span>Security and privacy considerations</h5>
<p class=XXX>Talk about making sure interactive media files
(e.g. SVG) don't have access to the container DOM (XSS potential);
Modified: source
===================================================================
--- source 2008-11-15 19:28:46 UTC (rev 2404)
+++ source 2008-11-15 19:34:34 UTC (rev 2405)
@@ -18082,8 +18082,6 @@
readonly attribute float <span title="dom-media-bufferingRate">bufferingRate</span>;
readonly attribute boolean <span title="dom-media-bufferingThrottled">bufferingThrottled</span>;
readonly attribute <span>TimeRanges</span> <span title="dom-media-buffered">buffered</span>;
- readonly attribute <span>ByteRanges</span> <span title="dom-media-bufferedBytes">bufferedBytes</span>;
- readonly attribute unsigned long <span title="dom-media-totalBytes">totalBytes</span>;
void <span title="dom-media-load">load</span>();
DOMString <span title="dom-navigator-canPlayType">canPlayType</span>(in DOMString type);
@@ -19025,34 +19023,21 @@
attribute must return a static <span>normalized
<code>TimeRanges</code> object</span> that represents the ranges of
the <span>media resource</span>, if any, that the user agent has
- buffered, at the time the attribute is evaluated.</p>
+ buffered, at the time the attribute is evaluated. Users agents must
+ accurately determine the ranges available, even for media streams
+ where this can only be determined by tedious inspection.</p>
<p class="note">Typically this will be a single range anchored at
the zero point, but if, e.g. the user agent uses HTTP range requests
in response to seeking, then there could be multiple ranges.</p>
- <p>The <dfn
- title="dom-media-bufferedBytes"><code>bufferedBytes</code></dfn>
- attribute must return a static <span>normalized
- <code>ByteRanges</code> object</span> that represents the ranges of
- the <span>media resource</span>, if any, that the user agent has
- buffered, at the time the attribute is evaluated.</p>
-
- <p>The <dfn
- title="dom-media-totalBytes"><code>totalBytes</code></dfn> attribute
- must return the length of the <span>media resource</span>, in bytes,
- if it is known and finite. If it is not known, is infinite
- (e.g. streaming radio), or if no <span>media data</span> is
- available, the attribute must return 0.</p>
-
<p>User agents may discard previously buffered data.</p>
- <p class="note">Thus, a time or byte position included within a
- range of the objects return by the <code
- title="dom-media-buffered">buffered</code> or <code
- title="dom-media-bufferedBytes">bufferedBytes</code> attributes at
- one time can end up being not included in the range(s) of objects
- returned by the same attributes at a later time.</p>
+ <p class="note">Thus, a time position included within a range of the
+ objects return by the <code
+ title="dom-media-buffered">buffered</code> attribute at one time can
+ end up being not included in the range(s) of objects returned by the
+ same attribute at later times.</p>
@@ -19982,59 +19967,6 @@
- <h5>Byte ranges</h5>
-
- <p>Objects implementing the <code>ByteRanges</code> interface
- represent a list of ranges of bytes.</p>
-
- <pre class="idl">interface <dfn>ByteRanges</dfn> {
- readonly attribute unsigned long <span title="dom-ByteRanges-length">length</span>;
- unsigned long <span title="dom-ByteRanges-start">start</span>(in unsigned long index);
- unsigned long <span title="dom-ByteRanges-end">end</span>(in unsigned long index);
-};</pre>
-
- <p>The <dfn title="dom-ByteRanges-length"><code>length</code></dfn>
- DOM attribute must return the number of ranges represented by the object.</p>
-
- <p>The <dfn title="dom-ByteRanges-start"><code>start(<var
- title="">index</var>)</code></dfn> method must return the position
- of the first byte of the <var title="">index</var>th range
- represented by the object.</p>
-
- <p>The <dfn title="dom-ByteRanges-end"><code>end(<var
- title="">index</var>)</code></dfn> method must return the position
- of the byte immediately after the last byte of the <var
- title="">index</var>th range represented by the object. (The byte
- position returned by this method is not in the range itself. If the
- first byte of the range is the byte at position 0, and the entire
- stream of bytes is in the range, then the value of the position of
- the byte returned by this method for that range will be the same as
- the number of bytes in the stream.)</p>
-
- <p>These methods must raise <code>INDEX_SIZE_ERR</code> exceptions
- if called with an <var title="">index</var> argument greater than or
- equal to the number of ranges represented by the object.</p>
-
- <p>When a <code>ByteRanges</code> object is said to be a
- <dfn>normalized <code>ByteRanges</code> object</dfn>, the ranges it
- represents must obey the following criteria:</p>
-
- <ul>
-
- <li>The start of a range must be greater than the end of all
- earlier ranges.</li>
-
- <li>The start of a range must be less than the end of that same
- range.</li>
-
- </ul>
-
- <p>In other words, the ranges in such an object are ordered, don't
- overlap, aren't empty, and don't touch (adjacent ranges are folded
- into one bigger range).</p>
-
-
-
<h5 id="mediaevents">Event summary</h5>
<p>The following events fire on <span title="media element">media
More information about the Commit-Watchers
mailing list