Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

RTCTransportStats - updates #37158

Draft
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

hamishwillee
Copy link
Collaborator

This updates RTCTransportStats to match BCD as part of mdn/mdn#384

The properties match the set in BCD, but are not individually documented. This primarily creates those missing documents.

@github-actions github-actions bot added the Content:WebAPI Web API docs label Dec 10, 2024
@github-actions github-actions bot added the size/m [PR only] 51-500 LoC changed label Dec 10, 2024
Copy link
Contributor

github-actions bot commented Dec 10, 2024

Preview URLs (7 pages)
Flaws (10)

Note! 6 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/API/RTCTransportStats
Title: RTCTransportStats
Flaw count: 10

  • macros:
    • /en-US/docs/Web/API/RTCTransportStats/iceRole does not exist
    • /en-US/docs/Web/API/RTCTransportStats/iceState does not exist
    • /en-US/docs/Web/API/RTCTransportStats/localCertificateId does not exist
    • /en-US/docs/Web/API/RTCTransportStats/packetsReceived does not exist
    • /en-US/docs/Web/API/RTCTransportStats/packetsSent does not exist
    • and 5 more flaws omitted
External URLs (1)

URL: /en-US/docs/Web/API/RTCTransportStats/dtlsCipher
Title: RTCTransportStats: dtlsCipher property

(comment last updated: 2024-12-13 05:46:05)

Comment on lines +33 to 35
- {{domxref("RTCTransportStats.iceLocalUsernameFragment", "iceLocalUsernameFragment")}} {{optional_inline}} {{experimental_inline}}
- : A string indicating the local username fragment that uniquely identifies the ICE interaction session managed by this transport.
This is the same value as the local {{domxref("RTCIceCandidate.usernameFragment")}}, and will change if the connection is renegotiated.
Copy link
Collaborator Author

@hamishwillee hamishwillee Dec 13, 2024

Choose a reason for hiding this comment

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

Note, the spec says

Set to the current value of the local username fragment used in message validation procedures [RFC5245] for this RTCIceTransport. It may be updated on setLocalDescription() and on ICE restart.

it is not clear if that validation is something the browser does or the developer does (to me). I THINK that the fragment is used to associate the transport to the messages on it, so at this point the validation has already happened. i.e. that is of interest to browser developers, not end users.

I am not sure what a developer would do with this stat, though presumably they can map it to other stats that are part of the same session.

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.

1 participant