mdn / content

The content behind MDN Web Docs
https://developer.mozilla.org
Other
9.12k stars 22.46k forks source link

api.RTCDataChannel.send - Wrong or obsolete exception list #30909

Open RealAlphabet opened 1 year ago

RealAlphabet commented 1 year ago

What type of issue is this?

Other

What information was incorrect, unhelpful, or incomplete?

The list of exceptions and their descriptions are partially erroneous and some types of exceptions returned are missing. Here is the latest version of the specification https://www.w3.org/TR/webrtc/

Moreover, the link of the specification in MDN is incorrect and refers to the Editor Draft instead of the final specification.

Specifically, the list of exceptions displayed for the send method omits the OperationError type and has an incorrect description for the following exception.

NetworkError DOMException Thrown when the specified data would need to be buffered, and there isn't room for it in the buffer. In this scenario, the underlying transport is immediately closed.

Wrong, the error returned is an OperationError which does not result in the closure of the underlying connection. In accordance with the specification, here is what is written for the 5th step of the send method.

5. Queue data for transmission on channel's underlying data transport. If queuing data is not possible because not enough buffer space is available, throw an OperationError.

This was validated in 2017 by the following change to the specification: https://github.com/w3c/webrtc-pc/pull/1209 https://github.com/w3c/webrtc-pc/issues/1148

What browsers does this problem apply to, if applicable?

No response

What did you expect to see?

OperationError Thrown when the specified data would need to be buffered, and there isn't room for it in the buffer.

Did you test this? If so, how?

N/A

Can you link to any release notes, bugs, pull requests, or MDN pages related to this?

https://developer.mozilla.org/en-US/docs/Web/API/RTCDataChannel/send https://github.com/w3c/webrtc-pc/pull/1209 https://github.com/w3c/webrtc-pc/issues/1148

Do you have anything more you want to share?

No response

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/RTCDataChannel/send

MDN metadata

MDN page report details * Query: `api.RTCDataChannel.send` * Report started: 2023-05-16T11:19:36.996Z
Nrpk46 commented 9 months ago

wmic bios get serialnumber

On Sun, 10 Dec 2023, 19:30 Alphabet, @.***> wrote:

What type of issue is this?

Other What information was incorrect, unhelpful, or incomplete?

The list of exceptions and their descriptions are partially erroneous and some types of exceptions returned are missing. Here is the latest version of the specification https://www.w3.org/TR/webrtc/

Moreover, the link of the specification in MDN is incorrect and refers to the Editor Draft instead of the final specification.

Specifically, the list of exceptions displayed for the send method omits the OperationError type and has an incorrect description for the following exception.

NetworkError DOMException Thrown when the specified data would need to be buffered, and there isn't room for it in the buffer. In this scenario, the underlying transport is immediately closed.

Wrong, the error returned is an OperationError which does not result in the closure of the underlying connection. In accordance with the specification, here is what is written for the 5th step of the send method.

5. Queue data for transmission on channel's underlying data transport. If queuing data is not possible because not enough buffer space is available, throw an OperationError.

This was validated in 2017 by the following change to the specification: w3c/webrtc-pc#1209 https://github.com/w3c/webrtc-pc/pull/1209 w3c/webrtc-pc#1148 https://github.com/w3c/webrtc-pc/issues/1148 What browsers does this problem apply to, if applicable?

No response What did you expect to see?

OperationError Thrown when the specified data would need to be buffered, and there isn't room for it in the buffer.

Did you test this? If so, how?

N/A Can you link to any release notes, bugs, pull requests, or MDN pages related to this?

https://developer.mozilla.org/en-US/docs/Web/API/RTCDataChannel/send w3c/webrtc-pc#1209 https://github.com/w3c/webrtc-pc/pull/1209 w3c/webrtc-pc#1148 https://github.com/w3c/webrtc-pc/issues/1148 Do you have anything more you want to share?

No response MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/RTCDataChannel/send MDN metadata MDN page report details

  • Query: api.RTCDataChannel.send
  • Report started: 2023-05-16T11:19:36.996Z

— Reply to this email directly, view it on GitHub https://github.com/mdn/content/issues/30909, or unsubscribe https://github.com/notifications/unsubscribe-auth/A34LG4H2C5PJA4RZAGEQYJ3YIYETVAVCNFSM6AAAAABAOY4ZUKVHI2DSMVQWIX3LMV43ASLTON2WKOZSGAZTINJQGI2DCNQ . You are receiving this because you are subscribed to this thread.Message ID: @.***>