| <!doctype html> |
| <meta charset=utf-8> |
| <title>RTCPeerConnection.prototype.setLocalDescription</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: |
| // generateOffer |
| // generateAnswer |
| // assert_session_desc_equals |
| |
| /* |
| 4.3.2. Interface Definition |
| [Constructor(optional RTCConfiguration configuration)] |
| interface RTCPeerConnection : EventTarget { |
| 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 "answer", then this completes an offer answer |
| negotiation. |
| |
| Set connection's currentLocalDescription to description and |
| currentRemoteDescription to the value of pendingRemoteDescription. |
| |
| Set both pendingRemoteDescription and pendingLocalDescription to null. |
| |
| Finally set connection's 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({ offerToReceiveVideo: true }) |
| .then(offer => |
| pc.setRemoteDescription(offer) |
| .then(() => pc.createAnswer()) |
| .then(answer => |
| pc.setLocalDescription(answer) |
| .then(() => { |
| assert_equals(pc.signalingState, 'stable'); |
| assert_session_desc_equals(pc.localDescription, answer); |
| assert_session_desc_equals(pc.remoteDescription, offer); |
| |
| assert_session_desc_equals(pc.currentLocalDescription, answer); |
| assert_session_desc_equals(pc.currentRemoteDescription, offer); |
| |
| assert_equals(pc.pendingLocalDescription, null); |
| assert_equals(pc.pendingRemoteDescription, null); |
| |
| assert_array_equals(states, ['have-remote-offer', 'stable']); |
| }))); |
| }, 'setLocalDescription() with valid answer should succeed'); |
| |
| /* |
| 4.3.2. setLocalDescription |
| 3. Let lastAnswer be the result returned by the last call to createAnswer. |
| 4. If description.sdp is null and description.type is answer, set description.sdp |
| to lastAnswer. |
| */ |
| promise_test(t => { |
| const pc = new RTCPeerConnection(); |
| |
| t.add_cleanup(() => pc.close()); |
| |
| return pc.createOffer({ offerToReceiveVideo: true }) |
| .then(offer => |
| pc.setRemoteDescription(offer) |
| .then(() => pc.createAnswer()) |
| .then(answer => |
| pc.setLocalDescription({ type: 'answer' }) |
| .then(() => { |
| assert_equals(pc.signalingState, 'stable'); |
| assert_session_desc_equals(pc.localDescription, answer); |
| assert_session_desc_equals(pc.remoteDescription, offer); |
| |
| assert_session_desc_equals(pc.currentLocalDescription, answer); |
| assert_session_desc_equals(pc.currentRemoteDescription, offer); |
| |
| assert_equals(pc.pendingLocalDescription, null); |
| assert_equals(pc.pendingRemoteDescription, null); |
| }))); |
| }, 'setLocalDescription() with type answer and null sdp should use lastAnswer generated from createAnswer'); |
| |
| /* |
| 4.3.2. setLocalDescription |
| 3. Let lastAnswer be the result returned by the last call to createAnswer. |
| 7. If description.type is answer and description.sdp does not match lastAnswer, |
| reject the promise with a newly created InvalidModificationError and abort these |
| steps. |
| */ |
| promise_test(t => { |
| const pc = new RTCPeerConnection(); |
| |
| t.add_cleanup(() => pc.close()); |
| |
| return pc.createOffer({ offerToReceiveVideo: true }) |
| .then(offer => |
| pc.setRemoteDescription(offer) |
| .then(() => generateAnswer(offer)) |
| .then(answer => |
| promise_rejects(t, 'InvalidModificationError', |
| pc.setLocalDescription(answer)))); |
| }, 'setLocalDescription() with answer not created by own createAnswer() should reject with InvalidModificationError'); |
| |
| /* |
| 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. |
| |
| [jsep] |
| 5.5. If the type is "pranswer" or "answer", the PeerConnection |
| state MUST be either "have-remote-offer" or "have-local-pranswer". |
| */ |
| promise_test(t => { |
| const pc = new RTCPeerConnection(); |
| |
| t.add_cleanup(() => pc.close()); |
| |
| return pc.createOffer() |
| .then(offer => |
| promise_rejects(t, 'InvalidStateError', |
| pc.setLocalDescription({ type: 'answer', sdp: offer.sdp }))); |
| }, 'Calling setLocalDescription(answer) from stable state 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(() => generateAnswer(offer))) |
| .then(answer => |
| promise_rejects(t, 'InvalidStateError', |
| pc.setLocalDescription(answer))); |
| }, 'Calling setLocalDescription(answer) from have-local-offer state should reject with InvalidStateError'); |
| |
| </script> |
