This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The RTCPeerConnection.getConfiguration()
method returns an RTCConfiguration
object which indicates the current configuration of the RTCPeerConnection
on which the method is called.
The returned configuration is the last configuration applied via setConfiguration()
, or if setConfiguration()
hasn't been called, the configuration the RTCPeerConnection
was constructed with. The configuration includes a list of the ICE servers used by the connection, information about transport policies, and identity information.
Syntax
var configuration = RTCPeerConnection.getConfiguration();
Parameters
This method takes no input parameters.
Return value
An RTCConfiguration
object describing the RTCPeerConnection
's current configuration.
Example
This example adds a new certificate to an active connection if it doesn't already have one in use.
let configuration = myPeerConnection.getConfiguration(); if ((configuration.certificates != undefined) && (!configuration.certificates.length)) { RTCPeerConnection.generateCertificate({ name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256', modulusLength: 2048, publicExponent: new Uint8Array([1, 0, 1]) }).then(function(cert) { configuration.certificates = [cert]; myPeerConnection.setConfiguration(configuration); }); }
This example fetches the current configuration of the RTCPeerConnection
, then looks to see if it has any certificates set by examining whether or not (a) the configuration has a value for certificates
, and (b) whether its length is zero.
If it's determined that there are no certificates in place, RTCPeerConnection.generateCertificate()
is called to create a new certificate; we provide a fulfillment handler which adds a new array containing the one newly-created certificate to the current configuration and passes it to setConfiguration()
to add the certificate to the connection.
Specifications
Specification | Status | Comment |
---|---|---|
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'getConfiguration()' in that specification. |
Candidate Recommendation | Initial definition. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getConfiguration | Chrome Full support 70 | Edge Full support 15 | Firefox Full support 22 | IE No support No | Opera
Full support
43
| Safari Full support 11 | WebView Android Full support 70 | Chrome Android Full support 70 | Firefox Android Full support 44 | Opera Android
Full support
43
| Safari iOS Full support Yes | Samsung Internet Android Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
- See implementation notes.