W3C home > Mailing lists > Public > public-html-commits@w3.org > December 2008

html5/workers Overview.html,1.73,1.74

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 23 Dec 2008 21:07:22 +0000
To: public-html-commits@w3.org
Message-Id: <E1LFETK-0000gI-3i@lionel-hutz.w3.org>

Update of /sources/public/html5/workers
In directory hutz:/tmp/cvs-serv2604

Modified Files:
	Overview.html 
Log Message:
Reporting script errors. (credit: js) (whatwg r81)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/workers/Overview.html,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -d -r1.73 -r1.74
--- Overview.html	16 Dec 2008 20:15:43 -0000	1.73
+++ Overview.html	23 Dec 2008 21:07:20 -0000	1.74
@@ -16,7 +16,7 @@
    <h1>Web Workers</h1>
 
    <h2 class="no-num no-toc" id=editors><!-- "W3C Working Draft" --> Editor's
-    Draft <!--ZZZ-->16 December 2008</h2>
+    Draft <!--ZZZ-->23 December 2008</h2>
 
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
@@ -142,7 +142,7 @@
   <p>The W3C <a href="http://www.w3.org/2008/webapps/">Web Apps Working
    Group</a> is the W3C working group responsible for this specification's
    progress along the W3C Recommendation track. <!--ZZZ:--> This
-   specification is the 16 December 2008 <!--ZZZ "Working Draft"-->Editor's
+   specification is the 23 December 2008 <!--ZZZ "Working Draft"-->Editor's
    Draft. <!--:ZZZ--></p>
   <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
   <!-- relationship to other work (required) -->
@@ -240,6 +240,10 @@
 
      <li><a href="#processing"><span class=secno>2.5 </span>Processing
       model</a>
+      <ul class=toc>
+       <li><a href="#runtime"><span class=secno>2.5.1 </span>Runtime script
+        errors</a>
+      </ul>
 
      <li><a href="#creating"><span class=secno>2.6 </span>Creating
       workers</a>
@@ -1235,6 +1239,7 @@
 
   void <a href="#close" title=dom-WorkerGlobalScope-close>close</a>();
            attribute <span>EventListener</span> <a href="#onclose" title=handler-WorkerGlobalScope-onclose>onclose</a>;
+           attribute <span>EventListener</span> <a href="#onerror" title=handler-WorkerGlobalScope-onerror>onerror</a>;
 };</pre>
 
   <p>Objects implementing the <code><a
@@ -1293,6 +1298,16 @@
     <p>Must be invoked whenever a <code title=event-close>close</code> event
      is targeted at or bubbles through the <code><a
      href="#workerglobalscope">WorkerGlobalScope</a></code> object.
+
+   <dt><dfn id=onerror
+    title=handler-WorkerGlobalScope-onerror><code>onerror</code></dfn>
+
+   <dd>
+    <p>Must be invoked whenever an <code title=event-error>error</code> event
+     is targeted at or bubbles through the element.</p>
+
+    <p>The initial value of <code title=handler-WorkerGlobalScope-onerror><a
+     href="#onerror">onerror</a></code> must be <code>undefined</code>.
   </dl>
 
   <h4 id=dedicated><span class=secno>2.1.2 </span>Dedicated workers and the
@@ -1747,6 +1762,70 @@
      port is entangled with.
   </ol>
 
+  <h4 id=runtime><span class=secno>2.5.1 </span>Runtime script errors</h4>
+
+  <p>Whenever a runtime script error occurs in one of the worker's scripts,
+   the user agent must <span>report the error</span> using the <code
+   title=handler-WorkerGlobalScope-onerror><a
+   href="#onerror">onerror</a></code> <span title="event handler DOM
+   attributes">event handler DOM attribute</span> of the <code><a
+   href="#workerglobalscope">WorkerGlobalScope</a></code> object.
+
+  <p>For shared workers, if the error is still <i title="">not handled</i>
+   afterwards, the error should be reported to the user.
+
+  <p>For dedicated workers, if the error is still <i title="">not handled</i>
+   afterwards, <span>queue a task</span> to <a href="#fire-an">fire an error
+   event</a> at the <code><a href="#worker1">Worker</a></code> object
+   associated with the worker.
+
+  <p>When the user agent is to <dfn id=fire-an>fire an error event</dfn> at a
+   <code><a href="#worker1">Worker</a></code> object, it must dispatch an
+   event that uses the <code><a href="#errorevent">ErrorEvent</a></code>
+   interface, with the name <code title=event-error>error</code>, that
+   doesn't bubble and is cancelable, with its <code
+   title=dom-ErrorEvent-message><a href="#message">message</a></code>, <code
+   title=dom-ErrorEvent-filename><a href="#filename">filename</a></code>, and
+   <code title=dom-ErrorEvent-lineno>lineno</code> attributes set
+   appropriately. The default action of this event depends on whether the
+   <code><a href="#worker1">Worker</a></code> object is itself in a worker.
+   If it is, and that worker is also a dedicated worker, then the user agent
+   must again span>queue a task to <a href="#fire-an">fire an error event</a>
+   at the <code><a href="#worker1">Worker</a></code> object associated with
+   <em>that</em> worker. Otherwise, then the error should be reported to the
+   user.
+
+  <hr>
+
+  <pre class=idl>interface <dfn id=errorevent>ErrorEvent</dfn> : Event {
+  readonly attribute DOMObject <a href="#message" title=dom-ErrorEvent-message>message</a>;
+  readonly attribute DOMObject <a href="#filename" title=dom-ErrorEvent-filename>filename</a>;
+  readonly attribute unsigned long <a href="#fileno" title=dom-ErrorEvent-fileno>fileno</a>;
+  void <a href="#initerrorevent" title=dom-ErrorEvent-initErrorEvent>initErrorEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMObject messageArg, in DOMObject filenameArg, in unsigned long filenoArg);
+  void <a href="#initerroreventns" title=dom-ErrorEvent-initErrorEventNS>initErrorEventNS</a>(in DOMString namespaceURIArg, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in DOMObject messageArg, in DOMObject filenameArg, in unsigned long filenoArg);
+};</pre>
+
+  <p>The <dfn id=initerrorevent
+   title=dom-ErrorEvent-initErrorEvent><code>initErrorEvent()</code></dfn>
+   and <dfn id=initerroreventns
+   title=dom-ErrorEvent-initErrorEventNS><code>initErrorEventNS()</code></dfn>
+   methods must initialize the event in a manner analogous to the
+   similarly-named methods in the DOM3 Events interfaces. <a
+   href="#refsDOM3EVENTS">[DOM3EVENTS]</a>
+
+  <p>The <dfn id=message
+   title=dom-ErrorEvent-message><code>message</code></dfn> attribute
+   represents the error message.
+
+  <p>The <dfn id=filename
+   title=dom-ErrorEvent-filename><code>filename</code></dfn> attribute
+   represents the <span>absolute URL</span> of the script in which the error
+   originally occured.
+
+  <p>The <dfn id=fileno title=dom-ErrorEvent-fileno><code>fileno</code></dfn>
+   attribute represents the line number where the error occured in the
+   script.
+
   <h3 id=creating><span class=secno>2.6 </span>Creating workers</h3>
 
   <h4 id=the-abstractworker><span class=secno>2.6.1 </span>The <code><a
@@ -1754,7 +1833,7 @@
 
   <pre
    class=idl>[NoInterfaceObject] interface <dfn id=abstractworker>AbstractWorker</dfn> {
-           attribute <span>EventListener</span> <a href="#onerror" title=handler-AbstractWorker-onerror>onerror</a>;
+           attribute <span>EventListener</span> <a href="#onerror0" title=handler-AbstractWorker-onerror>onerror</a>;
            attribute <span>EventListener</span> <a href="#onclose0" title=handler-AbstractWorker-onclose>onclose</a>;
 };</pre>
 
@@ -1767,7 +1846,7 @@
    href="#abstractworker">AbstractWorker</a></code> interface:
 
   <dl>
-   <dt><dfn id=onerror
+   <dt><dfn id=onerror0
     title=handler-AbstractWorker-onerror><code>onerror</code></dfn>
 
    <dd>
Received on Tuesday, 23 December 2008 21:07:32 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 23 December 2008 21:07:32 GMT