Skip to content

WebTransportDatagramsWritable and friends#44383

Merged
hamishwillee merged 5 commits into
mdn:mainfrom
hamishwillee:webtransportdatagramswritable_and_friends
Jun 16, 2026
Merged

WebTransportDatagramsWritable and friends#44383
hamishwillee merged 5 commits into
mdn:mainfrom
hamishwillee:webtransportdatagramswritable_and_friends

Conversation

@hamishwillee

@hamishwillee hamishwillee commented Jun 8, 2026

Copy link
Copy Markdown
Collaborator

This documents most of the new WebTransport support for prioritizing streams/datagrams within a sendGroup based on sendOrder for the respective stream objects - such as WebTransportDatagramsWritable. This is recently implemented in Safari.

I started on this when reviewing #44317 because that wants to refer to an undocumented method I needed to understand. Talking about pulling a thread...

Anyway, I believe this is correct and useful. The only thing missing is the stream equivalent of WebTransportDatagramsWritable - WebTransportSendStream.

Fixes #44273

@hamishwillee hamishwillee requested review from a team as code owners June 8, 2026 08:55
@hamishwillee hamishwillee requested review from chrisdavidmills and pepelsbey and removed request for a team June 8, 2026 08:55
@github-actions github-actions Bot added Content:WebAPI Web API docs size/l [PR only] 501-1000 LoC changed labels Jun 8, 2026
@github-actions

github-actions Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor
Preview URLs (9 pages)
External URLs (7)

URL: /en-US/docs/Web/API/WebTransport/createSendGroup
Title: WebTransport: createSendGroup() method


URL: /en-US/docs/Web/API/WebTransportDatagramDuplexStream/createWritable
Title: WebTransportDatagramDuplexStream: createWritable() method


URL: /en-US/docs/Web/API/WebTransportDatagramsWritable
Title: WebTransportDatagramsWritable


URL: /en-US/docs/Web/API/WebTransportDatagramsWritable/sendGroup
Title: WebTransportDatagramsWritable: sendGroup property


URL: /en-US/docs/Web/API/WebTransportDatagramsWritable/sendOrder
Title: WebTransportDatagramsWritable: sendOrder property


URL: /en-US/docs/Web/API/WebTransportSendGroup
Title: WebTransportSendGroup


URL: /en-US/docs/Web/API/WebTransportSendGroup/getStats
Title: WebTransportSendGroup: getStats() method

(comment last updated: 2026-06-16 00:01:19)

@chrisdavidmills chrisdavidmills left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @hamishwillee! I've read through all of these and provided some commentary. Looking mostly pretty good and makes sense.

Comment thread files/en-us/web/api/webtransport/createsendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransport/createsendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransport/datagrams/index.md Outdated
Comment thread files/en-us/web/api/webtransport/datagrams/index.md
Comment thread files/en-us/web/api/webtransportsendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramduplexstream/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramswritable/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramswritable/sendorder/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramswritable/sendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramswritable/sendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransport/datagrams/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramduplexstream/createwritable/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramduplexstream/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramswritable/sendorder/index.md Outdated
Comment thread files/en-us/web/api/webtransportsendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransportsendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransportsendgroup/index.md Outdated
Comment thread files/en-us/web/api/webtransport/datagrams/index.md Outdated
Comment thread files/en-us/web/api/webtransportdatagramduplexstream/createwritable/index.md Outdated
@hamishwillee

Copy link
Copy Markdown
Collaborator Author

Thanks @chrisdavidmills - Accepted almost all of them. Should be good for another look.

@hamishwillee hamishwillee force-pushed the webtransportdatagramswritable_and_friends branch from aacf0d8 to b775180 Compare June 9, 2026 06:10
@github-actions github-actions Bot added size/m [PR only] 51-500 LoC changed and removed size/l [PR only] 501-1000 LoC changed labels Jun 9, 2026
@hamishwillee hamishwillee force-pushed the webtransportdatagramswritable_and_friends branch from b775180 to b7dcb88 Compare June 11, 2026 23:55
Comment thread files/en-us/web/api/webtransportsendgroup/index.md Outdated
@hamishwillee

Copy link
Copy Markdown
Collaborator Author

@chrisdavidmills I have reapplied all your suggestions. Should be ready for another look now.

@chrisdavidmills chrisdavidmills left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hamishwillee, OK, this seems good to go, except for the weird issue I slacked you about concerning the code listing that seems broken in https://pr44383.review.mdn.allizom.net/en-US/docs/Web/API/WebTransport/datagrams#examples (the page no longer seems listed in the list of changed files.)

hamishwillee and others added 4 commits June 16, 2026 09:59
Co-Authored-By: Hamish Willee <hamishwillee@gmail.com>
Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>
Co-authored-by: Hamish Willee <hamishwillee@gmail.com>
@hamishwillee hamishwillee force-pushed the webtransportdatagramswritable_and_friends branch from f208a59 to bb3408b Compare June 15, 2026 23:59
@hamishwillee

hamishwillee commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator Author

@hamishwillee, OK, this seems good to go, except for the weird issue I slacked you about concerning the code listing that seems broken in https://pr44383.review.mdn.allizom.net/en-US/docs/Web/API/WebTransport/datagrams#examples (the page no longer seems listed in the list of changed files.)

@chrisdavidmills Thanks for the review!

Looking at the odd PR output it appears to have been caused by a missing end to a code block - I can't explain why this isn't being generated, but I can confirm the source markup is fine and the local rendering does not have this flaw.

@hamishwillee hamishwillee merged commit aa03822 into mdn:main Jun 16, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/m [PR only] 51-500 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

WebTransport docs still uses examples with deprecated/non-standard writable property

3 participants