[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