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
js
toJSON()
Parameters
None.
Return value
A JSON object with the following properties, which have been set to the corresponding values in the RTCIceCandidate
object:
candidate
Optional-
A string describing the network connectivity information for the candidate. Additional information can be found in
RTCIceCandidate.candidate
. sdpMid
Optional-
A string containing the identification tag of the media stream with which the candidate is associated, or
null
if there is no associated media stream. Additional information can be found inRTCIceCandidate.sdpMid
. sdpMLineIndex
Optional-
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
null
if no such associated exists. Additional information can be found inRTCIceCandidate.sdpMLineIndex
. usernameFragment
Optional-
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
.
js
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