Source code
Revision control
Copy as Markdown
Other Tools
Test Info:
- This WPT test may be referenced by the following Test IDs:
- /webrtc/RTCConfiguration-bundlePolicy.html - WPT Dashboard Interop Dashboard
<!doctype html>
<meta charset=utf-8>
<title>RTCConfiguration bundlePolicy</title>
<script src="/resources/testharness.js"></script>
<script src="/resources/testharnessreport.js"></script>
<script src="RTCPeerConnection-helper.js"></script>
<script src="./third_party/sdp/sdp.js"></script>
<script>
'use strict';
// Test is based on the following editor draft:
/*
4.3.2. Interface Definition
[Constructor(optional RTCConfiguration configuration)]
interface RTCPeerConnection : EventTarget {
...
RTCConfiguration getConfiguration();
void setConfiguration(RTCConfiguration configuration);
};
4.2.1. RTCConfiguration Dictionary
dictionary RTCConfiguration {
RTCBundlePolicy bundlePolicy = "balanced";
...
};
4.2.6. RTCBundlePolicy Enum
enum RTCBundlePolicy {
"balanced",
"max-compat",
"max-bundle"
};
*/
test(() => {
const pc = new RTCPeerConnection();
assert_equals(pc.getConfiguration().bundlePolicy, 'balanced');
}, 'Default bundlePolicy should be balanced');
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: undefined });
assert_equals(pc.getConfiguration().bundlePolicy, 'balanced');
}, `new RTCPeerConnection({ bundlePolicy: undefined }) should have bundlePolicy balanced`);
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'balanced' });
assert_equals(pc.getConfiguration().bundlePolicy, 'balanced');
}, `new RTCPeerConnection({ bundlePolicy: 'balanced' }) should succeed`);
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'max-compat' });
assert_equals(pc.getConfiguration().bundlePolicy, 'max-compat');
}, `new RTCPeerConnection({ bundlePolicy: 'max-compat' }) should succeed`);
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'max-bundle' });
assert_equals(pc.getConfiguration().bundlePolicy, 'max-bundle');
}, `new RTCPeerConnection({ bundlePolicy: 'max-bundle' }) should succeed`);
test(() => {
const pc = new RTCPeerConnection();
pc.setConfiguration({});
}, 'setConfiguration({}) with initial default bundlePolicy balanced should succeed');
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'balanced' });
pc.setConfiguration({});
}, 'setConfiguration({}) with initial bundlePolicy balanced should succeed');
test(() => {
const pc = new RTCPeerConnection();
pc.setConfiguration({ bundlePolicy: 'balanced' });
}, 'setConfiguration({ bundlePolicy: balanced }) with initial default bundlePolicy balanced should succeed');
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'balanced' });
pc.setConfiguration({ bundlePolicy: 'balanced' });
}, `setConfiguration({ bundlePolicy: 'balanced' }) with initial bundlePolicy balanced should succeed`);
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'max-compat' });
pc.setConfiguration({ bundlePolicy: 'max-compat' });
}, `setConfiguration({ bundlePolicy: 'max-compat' }) with initial bundlePolicy max-compat should succeed`);
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'max-bundle' });
pc.setConfiguration({ bundlePolicy: 'max-bundle' });
}, `setConfiguration({ bundlePolicy: 'max-bundle' }) with initial bundlePolicy max-bundle should succeed`);
test(() => {
assert_throws_js(TypeError, () =>
new RTCPeerConnection({ bundlePolicy: null }));
}, `new RTCPeerConnection({ bundlePolicy: null }) should throw TypeError`);
test(() => {
assert_throws_js(TypeError, () =>
new RTCPeerConnection({ bundlePolicy: 'invalid' }));
}, `new RTCPeerConnection({ bundlePolicy: 'invalid' }) should throw TypeError`);
/*
4.3.2. Interface Definition
To set a configuration
5. If configuration.bundlePolicy is set and its value differs from the
connection's bundle policy, throw an InvalidModificationError.
*/
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'max-bundle' });
assert_idl_attribute(pc, 'setConfiguration');
assert_throws_dom('InvalidModificationError', () =>
pc.setConfiguration({ bundlePolicy: 'max-compat' }));
}, `setConfiguration({ bundlePolicy: 'max-compat' }) with initial bundlePolicy max-bundle should throw InvalidModificationError`);
test(() => {
const pc = new RTCPeerConnection({ bundlePolicy: 'max-bundle' });
assert_idl_attribute(pc, 'setConfiguration');
// the default value for bundlePolicy is balanced
assert_throws_dom('InvalidModificationError', () =>
pc.setConfiguration({}));
}, `setConfiguration({}) with initial bundlePolicy max-bundle should throw InvalidModificationError`);
/*
Coverage Report
Tested 2
Total 2
*/
promise_test(async t => {
// balanced: Gather ICE candidates for each media type in use (audio, video, and data).
const pc = new RTCPeerConnection({bundlePolicy: 'balanced'});
t.add_cleanup(() => pc.close());
pc.addTransceiver('audio');
pc.addTransceiver('audio'); // This should not gather candidates.
pc.addTransceiver('video');
pc.createDataChannel('channel');
await pc.setLocalDescription();
await waitForIceGatheringState(pc, ['complete']);
const sections = SDPUtils.splitSections(pc.localDescription.sdp);
sections.shift();
assert_equals(sections.length, 4);
const candidatesA1 = SDPUtils.matchPrefix(sections[0], 'a=candidate:');
assert_greater_than(candidatesA1.length, 0, 'First audio m-line should have candidates');
const candidatesA2 = SDPUtils.matchPrefix(sections[1], 'a=candidate:');
assert_equals(candidatesA2.length, 0, 'Second audio m-line should have no candidates');
const candidatesV = SDPUtils.matchPrefix(sections[2], 'a=candidate:');
assert_greater_than(candidatesV.length, 0, 'First video m-line should have candidates');
const candidatesD = SDPUtils.matchPrefix(sections[3], 'a=candidate:');
assert_greater_than(candidatesD.length, 0, 'First data m-line should have candidates');
}, '"balanced" bundle policy should gather ICE candidates for each media type in use');
promise_test(async t => {
// max-compat: Gather ICE candidates for each track.
const pc = new RTCPeerConnection({bundlePolicy: 'max-compat'});
t.add_cleanup(() => pc.close());
pc.addTransceiver('audio');
pc.addTransceiver('audio'); // This should gather candidates.
pc.addTransceiver('video');
pc.createDataChannel('channel');
await pc.setLocalDescription();
await waitForIceGatheringState(pc, ['complete']);
const sections = SDPUtils.splitSections(pc.localDescription.sdp);
sections.shift();
assert_equals(sections.length, 4);
const candidatesA1 = SDPUtils.matchPrefix(sections[0], 'a=candidate:');
assert_greater_than(candidatesA1.length, 0, 'First audio m-line should have candidates');
const candidatesA2 = SDPUtils.matchPrefix(sections[1], 'a=candidate:');
assert_greater_than(candidatesA2.length, 0, 'Second audio m-line should have candidates');
const candidatesV = SDPUtils.matchPrefix(sections[2], 'a=candidate:');
assert_greater_than(candidatesV.length, 0, 'First video m-lne should have candidates');
const candidatesD = SDPUtils.matchPrefix(sections[3], 'a=candidate:');
assert_greater_than(candidatesD.length, 0, 'First data m-line should have candiates');
}, '"max-compat" bundle policy should gather ICE candidates for each track');
promise_test(async t => {
// max-bundle: Gather ICE candidates for only one track.
const pc = new RTCPeerConnection({bundlePolicy: 'max-bundle'});
t.add_cleanup(() => pc.close());
pc.addTransceiver('audio'); // Only first m-line gathers candidates.
pc.addTransceiver('audio');
pc.addTransceiver('video');
pc.createDataChannel('channel');
await pc.setLocalDescription();
await waitForIceGatheringState(pc, ['complete']);
const sections = SDPUtils.splitSections(pc.localDescription.sdp);
sections.shift();
assert_equals(sections.length, 4);
const candidatesA1 = SDPUtils.matchPrefix(sections[0], 'a=candidate:');
assert_greater_than(candidatesA1.length, 0, 'First audio m-line should have candidates');
const candidatesA2 = SDPUtils.matchPrefix(sections[1], 'a=candidate:');
assert_equals(candidatesA2.length, 0, 'Second audio m-line shoud have no candidates');
const candidatesV = SDPUtils.matchPrefix(sections[2], 'a=candidate:');
assert_equals(candidatesV.length, 0, 'Firt video m-line should have no candidates');
const candidatesD = SDPUtils.matchPrefix(sections[3], 'a=candidate:');
assert_equals(candidatesD.length, 0, 'First data m-line should have no candidates');
}, '"max-bundle" bundle policy should gather ICE candidates for one track');
</script>