[Webkit-unassigned] [Bug 109674] start and stop attributes in AudioBufferSourceNode should include "raises (exception)" in IDL files

[bugzilla-daemon at webkit.org]

https://bugs.webkit.org/show_bug.cgi?id=109674


Joshua Bell <jsbell at chromium.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |jsbell at chromium.org




--- Comment #16 from Joshua Bell <jsbell at chromium.org>  2013-02-20 13:11:15 PST ---
(In reply to comment #15)
> c.f. This is a spec of Indexed DB. It might be helpful to see how exceptions are speced: http://www.w3.org/TR/IndexedDB/#exceptions

FWIW, the IDB spec isn't a perfect example; the WebIDL fragments need updating and it doesn't have consistent prose defining the conditions for which exceptions should be thrown. (There are tracking bugs to update the spec.)

But basically: WebIDL no longer requires that attributes or methods be annotated to indicate that they may throw. But WebKitIDL *does*, so that the ExceptionCode parameter is autogenerated in the binding code.

In the spec, the description of each attribute or method should enumerate (algorithmically, if possible) the conditions which are tested for and which exception should be thrown in each case. The WebIDL may implicitly require other exceptions to be thrown when accessing a method (e.g. if you pass an incorrect type), but the implementation of those should be handled by the code generators, and no WebKitIDL annotations are necessary in general.

-- 
Configure bugmail: https://bugs.webkit.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.