W3C home > Mailing lists > Public > public-html-media@w3.org > November 2015

[encrypted-media] Use streamlined wording for creating and throwing exceptions

From: None via GitHub <sysbot+gh@w3.org>
Date: Mon, 02 Nov 2015 21:36:51 +0000
To: public-html-media@w3.org
Message-ID: <issues.opened-114689458-1446500210-sysbot+gh@w3.org>
ddorwin has just created a new issue for 
https://github.com/w3c/encrypted-media:

== Use streamlined wording for creating and throwing exceptions ==
The spec currently uses wording like the following:
>... with a new `DOMException` whose name is `TypeError`.

https://heycam.github.io/webidl/#idl-exceptions gives several 
"examples of wording to use to create and throw exceptions." I believe
 following these will simplify the EME spec text. This includes both 
the one place where we throw an exception and I believe where we 
create a new `DOMException` with which to reject a promise.

In the example above, the new wording would be:
>... with a newly 
[created](https://heycam.github.io/webidl/#dfn-exception-create) 
TypeError.

<br/>
I believe the existing wording is based on the example at 
https://www.w3.org/2001/tag/doc/promises-guide#example-add-bookmark.

@domenic, should that example be updated or is the wording above not 
appropriate for promises?

Related questions:
* Should "return a promise rejected with..." be "return a _newly 
created_ promise rejected with..."?
* Should there be even further simplified language for rejecting 
promises? For example, "reject the promise with TypeError", possibly 
with a reference tow Web IDL somewhere in there, would imply creation 
of the new DOMException.
* Perhaps you can provide some suggested language for the missing 
examples in https://heycam.github.io/webidl/#es-promise.

See https://github.com/w3c/encrypted-media/issues/122
Received on Monday, 2 November 2015 21:36:53 UTC

This archive was generated by hypermail 2.3.1 : Monday, 2 November 2015 21:36:53 UTC