[webkit-dev] Custom exception messages for IDL defined methods that raise DOMException.

Mon Nov 14 18:45:16 PST 2011

I sure hope specific exception messages are not getting codified in specs.

I don't see where the discussion of other browsers is relevant becaus it's
pretty clear other impls of this component aren't going to happen, yet this
remains a useful feature of webkit/chrome for the time being. It has issues
and i'd like to make it more useful.

>From a practical point of view, without being able to observe what error
conditions are actually arising makes improvements is more difficult. My
thought was to expose information about that to developers which would also
make its way back to us. There are a number of APIs that accept
'errorCallbacks', the messages delivered to those callbacks already contain
more detailed messages. At this point I'm looking at improving the
reporting for methods that directly throw exceptions. Most notable is the
openDatabase() method. A more detailed message is being logged to the
console, but i'd like that to be more directed into the hands of the
callers of that method.

Afaict, the "platform" does define a means of expressing exceptional
conditions including a means of conveying a message that ideally provides
useful information. I'd like to fill in that useful information part,
"INVALID_STATE_ERR: DOM Exception 11" isn't particularly useful to anyone.
Its fair to say INVALID_STATE for many distinct low level error conditions,
there's nothing wrong with the API. My intent in starting this thread was
to determine the best way of providing a more detailed message.  I don't
agree that "error messages are evil"? In the case of websql or indexedDB,
where there is a complex backing store of some kind that's likely different
across browsers, i think it is helpful to surface useful implementation
specific details for diagnostic and debugging purposes.

On Mon, Nov 14, 2011 at 5:56 PM, Adam Barth <abarth at webkit.org> wrote:

> On Mon, Nov 14, 2011 at 5:41 PM, Michael Nordman <michaeln at google.com>
> wrote:
> > On Mon, Nov 14, 2011 at 5:17 PM, Adam Barth <abarth at webkit.org> wrote:
> >>
> >> For SQLException, there are a hundred exception codes reserved,
> >>
> >>     static const int SQLExceptionOffset = 1000;
> >>     static const int SQLExceptionMax = 1099;
> >>
> >> of which, we appear to only be using eight.  It sounds like you're
> >> considering exposing more than a finite enumerated number of error
> >> codes, however.  Do we really want to make SQLite error messages part
> >> of the web platform?  What if we want to upgrade to a newer version of
> >> SQLite in the future (which might have different error codes)?
> >>
> >> IMHO, we shouldn't be investing much more effort into WebSQLDatabase.
> >> It's something of a dead-end for the platform.  If you're set on
> >> investing more effort, one path forward is to figure out which are the
> >> most important kinds of errors to distinguish and to give them error
> >> codes.  You can then give them descriptions as usual without needing
> >> any custom bindings.
> >
> > I don't want to change the set of exception 'codes' really.
> > There are significant clients of WebSQL. They can't transition to IDB
> until
> > it's up to the task and they've made that transition. For the time being,
> > I'm willing to better support websql. There are a errors in the wild and
> > figuring out what errors are "important" isn't as easy as it sounds.
> > See http://code.google.com/p/chromium/issues/detail?id=98939 about
> > "INVALID_STATE_ERR: DOM Exception 11".
> >
> > I'd like to be able to determine two things given the exception...
> callsite
> > in webcore that failed and the sqlite error code seen at that callsite.
> That
> > would make for a large number of new codes.
>
> The cost of exposing detailed error information is that all browsers
> that implement WebSQLDatabase will need to generate the exact same
> errors in the exact same situations.  Part of the reason why other
> browser vendors shot down WebSQLDatabase was that it was too reliant
> on implementation details of SQLite.  Exposing these ad-hoc error
> states as part of the platform just makes that problem worse,
> especially if you're talking about a large number of error conditions,
> as you seem to be.
>
> > If there's no general case for
> > returning a custom message, a reasonable option for me may be to use
> > [custom] bindings for these methods and to have that custom binding set
> the
> > exception message attribute accordingly.
>
> The issue isn't the best way of implementing this feature, the issue
> is whether we should be exposing this level of implementation detail
> to the platform.  If we can't abstract the error conditions into a
> small, finite list, there's very unlikely we'll be able to maintain
> precisely the same error behavior over time, let alone specify the
> behavior in sufficient detail and correctness that someone else could
> implement it precisely the same way.
>
> Adam
>
>
> >> On Mon, Nov 14, 2011 at 4:58 PM, Michael Nordman <michaeln at google.com>
> >> wrote:
> >> > I guess the exception of interest is  SQLException.
> >> > Take a look at Database.cpp line 103. The ' errorMessage' string on
> that
> >> > line contains more detailed information about what went wrong in the
> act
> >> > of
> >> > opening the database, including things like an sqlite error code and
> >> > sqlite
> >> > error message. These strings are formed in the bowls of
> >> > AbstractDatabase::performOpenAndVerify().
> >> >
> >> > On Mon, Nov 14, 2011 at 4:48 PM, Adam Barth <abarth at webkit.org>
> wrote:
> >> >>
> >> >> I'm not sure exactly what you're trying to do, but one option is to
> >> >> add a new type of DOMException:
> >> >>
> >> >>
> >> >>
> http://trac.webkit.org/browser/trunk/Source/WebCore/dom/DOMExceptions.in
> >> >>
> >> >> Another option is to customize the message from an existing exception
> >> >> (here are the DOMCore exceptions):
> >> >>
> >> >>
> >> >>
> >> >>
> http://trac.webkit.org/browser/trunk/Source/WebCore/dom/DOMCoreException.cpp
> >> >>
> >> >> If you show me the spec you're trying to implement, I might have a
> >> >> more concept suggestion of the best way to implement it.
> >> >>
> >> >> Adam
> >> >>
> >> >>
> >> >> On Mon, Nov 14, 2011 at 4:44 PM, Michael Nordman <
> michaeln at google.com>
> >> >> wrote:
> >> >> > I have a case where given an IDL defined method thats defined to
> >> >> > raise a
> >> >> > DOMException, I'd like to set a custom exception message from
> within
> >> >> > the
> >> >> > webcore implementation and have that message percolate up into
> script
> >> >> > via
> >> >> > the bindings layer(s) and be accessible as the exception.message
> >> >> > attribute.
> >> >> > I don't see a non-custom way of doing that and am wondering if
> there
> >> >> > should
> >> >> > be support for something like this w/o having to resort to custom
> >> >> > bindings?
> >> >> > The particular methods I'm looking at are the openDatabase(...)
> >> >> > method
> >> >> > of
> >> >> > DOMWindow and WorkerContext, but this seems like it might be useful
> >> >> > in
> >> >> > other
> >> >> > cases as well.
> >> >> >
> >> >> > _______________________________________________
> >> >> > webkit-dev mailing list
> >> >> > webkit-dev at lists.webkit.org
> >> >> > http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev
> >> >> >
> >> >> >
> >> >
> >> >
> >
> >
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.webkit.org/pipermail/webkit-dev/attachments/20111114/b65c9170/attachment.html>