RTCPeerConnection-setRemoteDescription-tracks.https.html
<!doctype html>
<meta charset=utf-8>
<title>RTCPeerConnection.prototype.setRemoteDescription - add/remove remote tracks</title>
<script src="/resources/testharness.js"></script>
<script src="/resources/testharnessreport.js"></script>
<script src="RTCPeerConnection-helper.js"></script>
<script>
'use strict';
// The following helper functions are called from RTCPeerConnection-helper.js:
// addEventListenerPromise
// exchangeOffer
// exchangeOfferAnswer
// Resolver
// These tests are concerned with the observable consequences of processing
// the addition or removal of remote tracks, including events firing and the
// states of RTCPeerConnection, MediaStream and MediaStreamTrack.
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
caller.addTrack(localStream.getTracks()[0]);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.track.id, localStream.getTracks()[0].id,
'Local and remote track IDs match.');
assert_equals(e.streams.length, 0, 'No remote stream created.');
});
await exchangeOffer(caller, callee);
await ontrackPromise;
}, 'addTrack() with a track and no stream makes ontrack fire with a track and no stream.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
caller.addTrack(localStream.getTracks()[0], localStream);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.track.id, localStream.getTracks()[0].id,
'Local and remote track IDs match.');
assert_equals(e.streams.length, 1, 'Created a single remote stream.');
assert_equals(e.streams[0].id, localStream.id,
'Local and remote stream IDs match.');
assert_array_equals(e.streams[0].getTracks(), [e.track],
'The remote stream contains the remote track.');
});
await exchangeOffer(caller, callee);
await ontrackPromise;
}, 'addTrack() with a track and a stream makes ontrack fire with a track and a stream.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
let eventSequence = '';
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
caller.addTrack(localStream.getTracks()[0], localStream);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
eventSequence += 'ontrack;';
});
await exchangeOffer(caller, callee);
eventSequence += 'setRemoteDescription;';
await ontrackPromise;
assert_equals(eventSequence, 'ontrack;setRemoteDescription;');
}, 'ontrack fires before setRemoteDescription resolves.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStreams = await Promise.all([
getNoiseStream({audio: true}),
getNoiseStream({audio: true}),
]);
t.add_cleanup(() => localStreams.forEach((stream) =>
stream.getTracks().forEach((track) => track.stop())));
caller.addTrack(localStreams[0].getTracks()[0], localStreams[0]);
caller.addTrack(localStreams[1].getTracks()[0], localStreams[0]);
let ontrackEventsFired = 0;
const ontrackEventResolvers = [ new Resolver(), new Resolver() ];
callee.ontrack = t.step_func(e => {
ontrackEventResolvers[ontrackEventsFired++].resolve(e);
});
await exchangeOffer(caller, callee);
let firstTrackEvent = await ontrackEventResolvers[0].promise;
assert_equals(firstTrackEvent.track.id,
localStreams[0].getTracks()[0].id,
'First ontrack\'s track ID matches first local track.');
assert_equals(firstTrackEvent.streams.length, 1,
'First ontrack fires with a single stream.');
assert_equals(firstTrackEvent.streams[0].id,
localStreams[0].id,
'First ontrack\'s stream ID matches local stream.');
let secondTrackEvent = await ontrackEventResolvers[1].promise;
assert_equals(secondTrackEvent.track.id,
localStreams[1].getTracks()[0].id,
'Second ontrack\'s track ID matches second local track.');
assert_equals(secondTrackEvent.streams.length, 1,
'Second ontrack fires with a single stream.');
assert_equals(secondTrackEvent.streams[0].id,
localStreams[0].id,
'Second ontrack\'s stream ID matches local stream.');
assert_array_equals(firstTrackEvent.streams, secondTrackEvent.streams,
'ontrack was fired with the same streams both times.');
assert_equals(firstTrackEvent.streams[0].getTracks().length, 2, "stream should have two tracks");
assert_true(firstTrackEvent.streams[0].getTracks().includes(firstTrackEvent.track), "remoteStream should have the first track");
assert_true(firstTrackEvent.streams[0].getTracks().includes(secondTrackEvent.track), "remoteStream should have the second track");
assert_equals(ontrackEventsFired, 2, 'Unexpected number of track events.');
assert_equals(ontrackEventsFired, 2, 'Unexpected number of track events.');
}, 'addTrack() with two tracks and one stream makes ontrack fire twice with the tracks and shared stream.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
let eventSequence = '';
const localStreams = await Promise.all([
getNoiseStream({audio: true}),
getNoiseStream({audio: true}),
]);
t.add_cleanup(() => localStreams.forEach((stream) =>
stream.getTracks().forEach((track) => track.stop())));
caller.addTrack(localStreams[0].getTracks()[0], localStreams[0]);
const remoteStreams = [];
callee.ontrack = e => {
if (!remoteStreams.includes(e.streams[0]))
remoteStreams.push(e.streams[0]);
};
await exchangeOfferAnswer(caller, callee);
assert_equals(remoteStreams.length, 1, 'One remote stream created.');
assert_equals(remoteStreams[0].getTracks()[0].id,
localStreams[0].getTracks()[0].id,
'First local and remote tracks have the same ID.');
const onaddtrackPromise =
addEventListenerPromise(t, remoteStreams[0], 'addtrack', e => {
assert_equals(e.track.id, localStreams[1].getTracks()[0].id,
'Second local and remote tracks have the same ID.');
});
caller.addTrack(localStreams[1].getTracks()[0], localStreams[0]);
await exchangeOffer(caller, callee);
await onaddtrackPromise;
assert_equals(remoteStreams.length, 1, 'Still a single remote stream.');
}, 'addTrack() for an existing stream makes stream.onaddtrack fire.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
let eventSequence = '';
const localStreams = await Promise.all([
getNoiseStream({audio: true}),
getNoiseStream({audio: true}),
]);
t.add_cleanup(() => localStreams.forEach((stream) =>
stream.getTracks().forEach((track) => track.stop())));
caller.addTrack(localStreams[0].getTracks()[0], localStreams[0]);
const remoteStreams = [];
callee.ontrack = e => {
if (!remoteStreams.includes(e.streams[0]))
remoteStreams.push(e.streams[0]);
};
await exchangeOfferAnswer(caller, callee);
assert_equals(remoteStreams.length, 1, 'One remote stream created.');
const onaddtrackPromise =
addEventListenerPromise(t, remoteStreams[0], 'addtrack', e => {
eventSequence += 'stream.onaddtrack;';
});
caller.addTrack(localStreams[1].getTracks()[0], localStreams[0]);
await exchangeOffer(caller, callee);
eventSequence += 'setRemoteDescription;';
await onaddtrackPromise;
assert_equals(remoteStreams.length, 1, 'Still a single remote stream.');
assert_equals(eventSequence, 'stream.onaddtrack;setRemoteDescription;');
}, 'stream.onaddtrack fires before setRemoteDescription resolves.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStreams = await Promise.all([
getNoiseStream({audio: true}),
getNoiseStream({audio: true}),
]);
t.add_cleanup(() => localStreams.forEach((stream) =>
stream.getTracks().forEach((track) => track.stop())));
caller.addTrack(localStreams[0].getTracks()[0],
localStreams[0], localStreams[1]);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.track.id, localStreams[0].getTracks()[0].id,
'Local and remote track IDs match.');
assert_equals(e.streams.length, 2, 'Two remote stream created.');
assert_array_equals(e.streams[0].getTracks(), [e.track],
'First remote stream == [remote track].');
assert_array_equals(e.streams[1].getTracks(), [e.track],
'Second remote stream == [remote track].');
assert_equals(e.streams[0].id, localStreams[0].id,
'First local and remote stream IDs match.');
assert_equals(e.streams[1].id, localStreams[1].id,
'Second local and remote stream IDs match.');
});
await exchangeOffer(caller, callee);
await ontrackPromise;
}, 'addTrack() with a track and two streams makes ontrack fire with a track and two streams.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
caller.addTrack(localStream.getTracks()[0]);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_array_equals(callee.getReceivers(), [e.receiver],
'getReceivers() == [e.receiver].');
});
await exchangeOffer(caller, callee);
await ontrackPromise;
}, 'ontrack\'s receiver matches getReceivers().');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
const sender = caller.addTrack(localStream.getTracks()[0]);
const ontrackPromise = addEventListenerPromise(t, callee, 'track');
await exchangeOfferAnswer(caller, callee);
await ontrackPromise;
assert_equals(callee.getReceivers().length, 1, 'One receiver created.');
caller.removeTrack(sender);
await exchangeOffer(caller, callee);
assert_equals(callee.getReceivers().length, 1, 'Receiver not removed.');
}, 'removeTrack() does not remove the receiver.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
const [track] = localStream.getTracks();
const sender = caller.addTrack(track, localStream);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.streams.length, 1);
return e.streams[0];
});
await exchangeOfferAnswer(caller, callee);
const remoteStream = await ontrackPromise;
const remoteTrack = remoteStream.getTracks()[0];
const onremovetrackPromise =
addEventListenerPromise(t, remoteStream, 'removetrack', e => {
assert_equals(e.track, remoteTrack);
assert_equals(remoteStream.getTracks().length, 0,
'Remote stream emptied of tracks.');
});
caller.removeTrack(sender);
await exchangeOffer(caller, callee);
await onremovetrackPromise;
}, 'removeTrack() makes stream.onremovetrack fire and the track to be removed from the stream.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
let eventSequence = '';
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
const sender = caller.addTrack(localStream.getTracks()[0], localStream);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.streams.length, 1);
return e.streams[0];
});
await exchangeOfferAnswer(caller, callee);
const remoteStream = await ontrackPromise;
const remoteTrack = remoteStream.getTracks()[0];
const onremovetrackPromise =
addEventListenerPromise(t, remoteStream, 'removetrack', e => {
eventSequence += 'stream.onremovetrack;';
});
caller.removeTrack(sender);
await exchangeOffer(caller, callee);
eventSequence += 'setRemoteDescription;';
await onremovetrackPromise;
assert_equals(eventSequence, 'stream.onremovetrack;setRemoteDescription;');
}, 'stream.onremovetrack fires before setRemoteDescription resolves.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
const sender = caller.addTrack(localStream.getTracks()[0], localStream);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.streams.length, 1);
return e.streams[0];
});
await exchangeOfferAnswer(caller, callee);
const remoteStream = await ontrackPromise;
const remoteTrack = remoteStream.getTracks()[0];
const onmutePromise =
addEventListenerPromise(t, remoteTrack, 'mute', () => {
assert_true(remoteTrack.muted);
});
caller.removeTrack(sender);
await exchangeOffer(caller, callee);
await onmutePromise;
}, 'removeTrack() makes track.onmute fire and the track to be muted.');
promise_test(async t => {
const caller = new RTCPeerConnection();
t.add_cleanup(() => caller.close());
const callee = new RTCPeerConnection();
t.add_cleanup(() => callee.close());
let eventSequence = '';
const localStream =
await getNoiseStream({audio: true});
t.add_cleanup(() => localStream.getTracks().forEach(track => track.stop()));
const sender = caller.addTrack(localStream.getTracks()[0], localStream);
const ontrackPromise = addEventListenerPromise(t, callee, 'track', e => {
assert_equals(e.streams.length, 1);
return e.streams[0];
});
await exchangeOfferAnswer(caller, callee);
const remoteStream = await ontrackPromise;
const remoteTrack = remoteStream.getTracks()[0];
const onmutePromise =
addEventListenerPromise(t, remoteTrack, 'mute', () => {
eventSequence += 'track.onmute;';
});
caller.removeTrack(sender);
await exchangeOffer(caller, callee);
eventSequence += 'setRemoteDescription;';
await onmutePromise;
assert_equals(eventSequence, 'track.onmute;setRemoteDescription;');
}, 'track.onmute fires before setRemoteDescription resolves.');
promise_test(async t => {
const pc = new RTCPeerConnection();
t.add_cleanup(() => pc.close());
const stream = await getNoiseStream({audio: true});
t.add_cleanup(() => stream.getTracks().forEach(track => track.stop()));
const sender = pc.addTrack(stream.getTracks()[0]);
pc.removeTrack(sender);
pc.removeTrack(sender);
}, 'removeTrack() twice is safe.');
</script>