W3C home > Mailing lists > Public > public-webrtc@w3.org > June 2017

[webrtc-pc] Verbose description for RTCDataChannel default values

From: Soares Chen via GitHub <sysbot+gh@w3.org>
Date: Wed, 07 Jun 2017 08:49:18 +0000
To: public-webrtc@w3.org
Message-ID: <issues.opened-234136251-1496825356-sysbot+gh@w3.org>
soareschen has just created a new issue for https://github.com/w3c/webrtc-pc:

== Verbose description for RTCDataChannel default values ==
In the attribute descriptions for RTCDataChannel, there are many verbose sentences that describe the same action as setting the attributes with the default/provided values in RTCDataChannelInit dictionary.

> The attribute must be initialized to ... by default and must return the value to which it was set when the RTCDataChannel was created.

Is there any reason why the sections require verbose description of default values? They are not really required since the sections that create data channel initialize the attributes with explicit values already.

> 6.1 createDataChannel
>   5. Set channel's ordered, maxPacketLifeTime, maxRetransmits, protocol, negotiated, id and priority attributes to the values of the corresponding members of the dataChannelDict argument, using a value of null if the corresponding dictionary member is missing.

> 6.2 When an underlying data transport is to be announce
>    4. Initialize channel's label, ordered, maxPacketLifeTime, maxRetransmits, protocol, negotiated and id attributes to their corresponding values in configuration.

For the attributes with default null value, the sentence can be omitted by making the respective fields in RTCDataChannelInit nullable with default value null.

Please view or discuss this issue at https://github.com/w3c/webrtc-pc/issues/1353 using your GitHub account
Received on Wednesday, 7 June 2017 08:49:24 UTC

This archive was generated by hypermail 2.3.1 : Monday, 23 October 2017 15:19:51 UTC