[html5] r6470 - [] (0) Allow UAs to fire 'error' events if they get, e.g., XML errors while read [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2011-08-15 21:20:30 -0700 (Mon, 15 Aug 2011)
New Revision: 6470

Modified:
   complete.html
   index
   source
Log:
[] (0) Allow UAs to fire 'error' events if they get, e.g., XML errors while reading subtitle files. Doesn't affect WebVTT files.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=12283

Modified: complete.html
===================================================================
--- complete.html	2011-08-16 04:05:48 UTC (rev 6469)
+++ complete.html	2011-08-16 04:20:30 UTC (rev 6470)
@@ -31160,13 +31160,33 @@
     <i>monitoring</i>.</p>
 
     <p>If the <a href=#fetch title=fetch>fetching algorithm</a> does not
-    fail, then, when it completes, <a href=#queue-a-task>queue a task</a> to first
-    change the <a href=#text-track-readiness-state>text track readiness state</a> to <a href=#text-track-loaded title="text track loaded">loaded</a> and then <a href=#fire-a-simple-event>fire a
-    simple event</a> named <code title=event-load>load</code> at
-    the <code><a href=#the-track-element>track</a></code> element; and then, once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a
-    task">queued</a>, move on to the step below labeled
-    <i>monitoring</i>.</p>
+    fail, then, when it completes, <a href=#queue-a-task>queue a task</a> to run
+    the following steps:</p>
 
+    <ol><li><p>Change the <a href=#text-track-readiness-state>text track readiness state</a> to
+     <a href=#text-track-loaded title="text track loaded">loaded</a>.</li>
+
+     <li>
+
+      <p>If the file was successfully processed, <a href=#fire-a-simple-event>fire a simple
+      event</a> named <code title=event-load>load</code> at the
+      <code><a href=#the-track-element>track</a></code> element.</p>
+
+      <p>If the file was not successfully processed, e.g. the format
+      in question is an XML format and the file contained a
+      well-formedness error that the XML specification requires be
+      detected and reported to the application, then <a href=#fire-a-simple-event>fire a
+      simple event</a> named <code title=event-error>error</code>
+      at the <code><a href=#the-track-element>track</a></code> element.</p>
+
+      <p class=note>The WebVTT format does not report errors in this
+      fashion.</p>
+
+     </li>
+
+    </ol><p>Once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a task">queued</a>, move on to the step below
+    labeled <i>monitoring</i>.</p>
+
     <p>If, while the <a href=#fetch title=fetch>fetching algorithm</a> is
     active, either:</p>
 

Modified: index
===================================================================
--- index	2011-08-16 04:05:48 UTC (rev 6469)
+++ index	2011-08-16 04:20:30 UTC (rev 6470)
@@ -31027,13 +31027,33 @@
     <i>monitoring</i>.</p>
 
     <p>If the <a href=#fetch title=fetch>fetching algorithm</a> does not
-    fail, then, when it completes, <a href=#queue-a-task>queue a task</a> to first
-    change the <a href=#text-track-readiness-state>text track readiness state</a> to <a href=#text-track-loaded title="text track loaded">loaded</a> and then <a href=#fire-a-simple-event>fire a
-    simple event</a> named <code title=event-load>load</code> at
-    the <code><a href=#the-track-element>track</a></code> element; and then, once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a
-    task">queued</a>, move on to the step below labeled
-    <i>monitoring</i>.</p>
+    fail, then, when it completes, <a href=#queue-a-task>queue a task</a> to run
+    the following steps:</p>
 
+    <ol><li><p>Change the <a href=#text-track-readiness-state>text track readiness state</a> to
+     <a href=#text-track-loaded title="text track loaded">loaded</a>.</li>
+
+     <li>
+
+      <p>If the file was successfully processed, <a href=#fire-a-simple-event>fire a simple
+      event</a> named <code title=event-load>load</code> at the
+      <code><a href=#the-track-element>track</a></code> element.</p>
+
+      <p>If the file was not successfully processed, e.g. the format
+      in question is an XML format and the file contained a
+      well-formedness error that the XML specification requires be
+      detected and reported to the application, then <a href=#fire-a-simple-event>fire a
+      simple event</a> named <code title=event-error>error</code>
+      at the <code><a href=#the-track-element>track</a></code> element.</p>
+
+      <p class=note>The WebVTT format does not report errors in this
+      fashion.</p>
+
+     </li>
+
+    </ol><p>Once that <a href=#concept-task title=concept-task>task</a> is <a href=#queue-a-task title="queue a task">queued</a>, move on to the step below
+    labeled <i>monitoring</i>.</p>
+
     <p>If, while the <a href=#fetch title=fetch>fetching algorithm</a> is
     active, either:</p>
 

Modified: source
===================================================================
--- source	2011-08-16 04:05:48 UTC (rev 6469)
+++ source	2011-08-16 04:20:30 UTC (rev 6470)
@@ -33958,15 +33958,38 @@
     <i>monitoring</i>.</p>
 
     <p>If the <span title="fetch">fetching algorithm</span> does not
-    fail, then, when it completes, <span>queue a task</span> to first
-    change the <span>text track readiness state</span> to <span
-    title="text track loaded">loaded</span> and then <span>fire a
-    simple event</span> named <code title="event-load">load</code> at
-    the <code>track</code> element; and then, once that <span
-    title="concept-task">task</span> is <span title="queue a
-    task">queued</span>, move on to the step below labeled
-    <i>monitoring</i>.</p>
+    fail, then, when it completes, <span>queue a task</span> to run
+    the following steps:</p>
 
+    <ol>
+
+     <li><p>Change the <span>text track readiness state</span> to
+     <span title="text track loaded">loaded</span>.</p></li>
+
+     <li>
+
+      <p>If the file was successfully processed, <span>fire a simple
+      event</span> named <code title="event-load">load</code> at the
+      <code>track</code> element.</p>
+
+      <p>If the file was not successfully processed, e.g. the format
+      in question is an XML format and the file contained a
+      well-formedness error that the XML specification requires be
+      detected and reported to the application, then <span>fire a
+      simple event</span> named <code title="event-error">error</code>
+      at the <code>track</code> element.</p>
+
+      <p class="note">The WebVTT format does not report errors in this
+      fashion.</p>
+
+     </li>
+
+    </ol>
+
+    <p>Once that <span title="concept-task">task</span> is <span
+    title="queue a task">queued</span>, move on to the step below
+    labeled <i>monitoring</i>.</p>
+
     <p>If, while the <span title="fetch">fetching algorithm</span> is
     active, either:</p>