RTCIceCandidate: toJSON() method
The RTCIceCandidate method toJSON() converts the RTCIceCandidate on which it's called into JSON.
A stringified version of the object can then be obtained by calling stringify() on the returned object.
Syntax
toJSON()
Parameters
None.
Return value
A JSON object with the following properties, which have been set to the corresponding values in the RTCIceCandidate object:
candidateOptional-
A string describing the network connectivity information for the candidate. Additional information can be found in
RTCIceCandidate.candidate. sdpMidOptional-
A string containing the identification tag of the media stream with which the candidate is associated, or
nullif there is no associated media stream. Additional information can be found inRTCIceCandidate.sdpMid. sdpMLineIndexOptional-
A number property containing the zero-based index of the m-line with which the candidate is associated, within the SDP of the media description, or
nullif no such associated exists. Additional information can be found inRTCIceCandidate.sdpMLineIndex. usernameFragmentOptional-
A string containing the username fragment (usually referred to in shorthand as "ufrag" or "ice-ufrag"). This fragment, along with the ICE password ("ice-pwd"), uniquely identifies a single ongoing ICE interaction (including for any communication with the STUN server). Additional information can be found in
RTCIceCandidate.usernameFragment.
Note: The returned JSON object has the same form/properties as the candidateInfo object that can optionally be passed to the RTCIceCandidate() constructor to configure the candidate.
Examples
This simple example obtains a JSON string representing an RTCIceCandidate found in the variable candidate.
let jsonString = candidate.toJSON().stringify();
Specifications
| Specification |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcicecandidate-tojson |
Browser compatibility
BCD tables only load in the browser