ISSUE-18: (Bugzilla 17323) Use WebIDL enumerations, not numeric constants

NumericConstants

(Bugzilla 17323) Use WebIDL enumerations, not numeric constants

State:
CLOSED
Product:
Web Audio API
Raised by:
Philip Jägenstedt
Opened on:
2012-05-15
Description:
http://dev.w3.org/2006/webapi/WebIDL/#idl-enums

Use of numeric constants in interface definitions is not good practice for new specs. The WebRTC WG has resolved to move away from this:

http://lists.w3.org/Archives/Public/public-script-coord/2012JanMar/0166.html
http://lists.w3.org/Archives/Public/public-script-coord/2012JanMar/0320.html

In HTML, TextTrack.mode was recently changed to enumerations after similar feedback:

http://www.whatwg.org/specs/web-apps/current-work/multipage/the-video-element.html#texttrackmode

These are the members with numeric constants in the Web Audio API spec:

AudioBufferSourceNode.playbackState
AudioPannerNode.panningModel
AudioPannerNode.distanceModel
BiquadFilterNode.type
Oscillator.type
Oscillator.playbackState
Related Actions Items:
No related actions
Related emails:
  1. [web-audio-api] Use WebIDL enumerations, not numeric constants (#235) (from notifications@github.com on 2013-09-11)
  2. Re: Summary of issues (from crogers@google.com on 2012-05-22)
  3. Summary of issues (from mage@opera.com on 2012-05-22)
  4. Audio-ISSUE-18 (NumericConstants): Use WebIDL enumerations, not numeric constants [Web Audio API] (from sysbot+tracker@w3.org on 2012-05-15)

Related notes:

Agreed - looking into the details of the exact WebIDL syntax...

Chris Rogers, 18 May 2012, 22:13:08

http://dev.w3.org/2006/webapi/WebIDL/#idl-enums

Chris Rogers, 18 May 2012, 22:30:18

Solution in the works. Setting as OPEN.

Olivier Thereaux, 30 May 2012, 20:23:43

[MikeSmith]: https://www.w3.org/Bugs/Public/show_bug.cgi?id=17323

5 Jun 2012, 13:58:10

Display change log ATOM feed


Matthew Paradis <matthew.paradis@bbc.co.uk>, Raymond Toy <rtoy@google.com>, Chairs, Chris Lilley <chris@w3.org>, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 18.html,v 1.1 2019/11/12 13:32:12 carcone Exp $