| <!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: |
| // https://w3c.github.io/webrtc-pc/archives/20170605/webrtc.html |
| |
| /* |
| 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> |
