summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 17:32:43 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 17:32:43 +0000
commit6bf0a5cb5034a7e684dcc3500e841785237ce2dd (patch)
treea68f146d7fa01f0134297619fbe7e33db084e0aa /testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html
parentInitial commit. (diff)
downloadthunderbird-upstream.tar.xz
thunderbird-upstream.zip
Adding upstream version 1:115.7.0.upstream/1%115.7.0upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html')
-rw-r--r--testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html167
1 files changed, 167 insertions, 0 deletions
diff --git a/testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html b/testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html
new file mode 100644
index 0000000000..787edc92e7
--- /dev/null
+++ b/testing/web-platform/tests/webrtc/RTCPeerConnection-setLocalDescription-rollback.html
@@ -0,0 +1,167 @@
+<!doctype html>
+<meta charset=utf-8>
+<title>RTCPeerConnection.prototype.setLocalDescription rollback</title>
+<script src="/resources/testharness.js"></script>
+<script src="/resources/testharnessreport.js"></script>
+<script src="RTCPeerConnection-helper.js"></script>
+<script>
+ 'use strict';
+
+ // Test is based on the following editor draft:
+ // https://w3c.github.io/webrtc-pc/archives/20170605/webrtc.html
+
+ // The following helper functions are called from RTCPeerConnection-helper.js:
+ // assert_session_desc_similar
+ // generateAudioReceiveOnlyOffer
+
+ /*
+ 4.3.2. Interface Definition
+ [Constructor(optional RTCConfiguration configuration)]
+ interface RTCPeerConnection : EventTarget {
+ Promise<void> setLocalDescription(
+ RTCSessionDescriptionInit description);
+
+ readonly attribute RTCSessionDescription? localDescription;
+ readonly attribute RTCSessionDescription? currentLocalDescription;
+ readonly attribute RTCSessionDescription? pendingLocalDescription;
+
+ Promise<void> setRemoteDescription(
+ RTCSessionDescriptionInit description);
+
+ readonly attribute RTCSessionDescription? remoteDescription;
+ readonly attribute RTCSessionDescription? currentRemoteDescription;
+ readonly attribute RTCSessionDescription? pendingRemoteDescription;
+ ...
+ };
+
+ 4.6.2. RTCSessionDescription Class
+ dictionary RTCSessionDescriptionInit {
+ required RTCSdpType type;
+ DOMString sdp = "";
+ };
+
+ 4.6.1. RTCSdpType
+ enum RTCSdpType {
+ "offer",
+ "pranswer",
+ "answer",
+ "rollback"
+ };
+ */
+
+ /*
+ 4.3.1.6. Set the RTCSessionSessionDescription
+ 2.2.2. If description is set as a local description, then run one of the
+ following steps:
+ - If description is of type "rollback", then this is a rollback. Set
+ connection.pendingLocalDescription to null and signaling state to stable.
+ */
+ promise_test(t=> {
+ const pc = new RTCPeerConnection();
+ t.add_cleanup(() => pc.close());
+
+ const states = [];
+ pc.addEventListener('signalingstatechange', () => states.push(pc.signalingState));
+
+ return pc.createOffer()
+ .then(offer => pc.setLocalDescription(offer))
+ .then(() => {
+ assert_equals(pc.signalingState, 'have-local-offer');
+ assert_not_equals(pc.localDescription, null);
+ assert_not_equals(pc.pendingLocalDescription, null);
+ assert_equals(pc.currentLocalDescription, null);
+
+ return pc.setLocalDescription({ type: 'rollback' });
+ })
+ .then(() => {
+ assert_equals(pc.signalingState, 'stable');
+ assert_equals(pc.localDescription, null);
+ assert_equals(pc.pendingLocalDescription, null);
+ assert_equals(pc.currentLocalDescription, null);
+
+ assert_array_equals(states, ['have-local-offer', 'stable']);
+ });
+ }, 'setLocalDescription(rollback) from have-local-offer state should reset back to stable state');
+
+ /*
+ 4.3.1.6. Set the RTCSessionSessionDescription
+ 2.3. If the description's type is invalid for the current signaling state of
+ connection, then reject p with a newly created InvalidStateError and abort
+ these steps. Note that this implies that once the answerer has performed
+ setLocalDescription with his answer, this cannot be rolled back.
+
+ [jsep]
+ 4.1.8.2. Rollback
+ - Rollback can only be used to cancel proposed changes;
+ there is no support for rolling back from a stable state to a
+ previous stable state
+ */
+ promise_test(t => {
+ const pc = new RTCPeerConnection();
+ t.add_cleanup(() => pc.close());
+ return promise_rejects_dom(t, 'InvalidStateError',
+ pc.setLocalDescription({ type: 'rollback' }));
+ }, `setLocalDescription(rollback) from stable state should reject with InvalidStateError`);
+
+ promise_test(t => {
+ const pc = new RTCPeerConnection();
+ t.add_cleanup(() => pc.close());
+ return generateAudioReceiveOnlyOffer(pc)
+ .then(offer =>
+ pc.setRemoteDescription(offer)
+ .then(() => pc.createAnswer()))
+ .then(answer => pc.setLocalDescription(answer))
+ .then(() => {
+ return promise_rejects_dom(t, 'InvalidStateError',
+ pc.setLocalDescription({ type: 'rollback' }));
+ });
+ }, `setLocalDescription(rollback) after setting answer description should reject with InvalidStateError`);
+
+ promise_test(async t => {
+ const pc = new RTCPeerConnection();
+ t.add_cleanup(() => pc.close());
+ const offer = await generateAudioReceiveOnlyOffer(pc);
+ await pc.setRemoteDescription(offer);
+ await promise_rejects_dom(t, 'InvalidStateError', pc.setLocalDescription({ type: 'rollback' }));
+ }, `setLocalDescription(rollback) after setting a remote offer should reject with InvalidStateError`);
+
+ promise_test(t => {
+ const pc = new RTCPeerConnection();
+ t.add_cleanup(() => pc.close());
+ return pc.createOffer()
+ .then(offer => pc.setLocalDescription(offer))
+ .then(() => pc.setLocalDescription({
+ type: 'rollback',
+ sdp: '!<Invalid SDP Content>;'
+ }));
+ }, `setLocalDescription(rollback) should ignore invalid sdp content and succeed`);
+
+ promise_test(async t => {
+ const pc = new RTCPeerConnection();
+ t.add_cleanup(() => pc.close());
+
+ pc.addTransceiver('audio', { direction: 'recvonly' });
+ await pc.setLocalDescription(await pc.createOffer());
+ const sldPromise = pc.setLocalDescription({type: "rollback"});
+
+ assert_equals(pc.signalingState, "have-local-offer", "signalingState should not be set synchronously after a call to sLD");
+
+ assert_not_equals(pc.pendingLocalDescription, null, "pendingLocalDescription should not be set synchronously after a call to sLD");
+ assert_equals(pc.pendingLocalDescription.type, "offer");
+ assert_equals(pc.pendingLocalDescription.sdp, pc.localDescription.sdp);
+ assert_equals(pc.pendingRemoteDescription, null, "pendingRemoteDescription should never be set due to sLD(offer)");
+
+ const stablePromise = new Promise(resolve => {
+ pc.onsignalingstatechange = () => {
+ resolve(pc.signalingState);
+ }
+ });
+ const raceValue = await Promise.race([stablePromise, sldPromise]);
+ assert_equals(raceValue, "stable", "signalingstatechange event should fire before sLD resolves");
+ assert_equals(pc.pendingLocalDescription, null, "pendingLocalDescription should be updated before the signalingstatechange event");
+ assert_equals(pc.pendingRemoteDescription, null, "pendingRemoteDescription should never be set due to sLD(offer)");
+
+ await sldPromise;
+ }, "setLocalDescription(rollback) should update internal state with a queued tassk, in the right order");
+
+</script>
generated by cgit v1.2.3 (git 2.39.1) at 2024-07-20 21:03:01 +0000