ep_webrtc 2.5.34 → 2.5.36

package/static/tests/frontend/specs/race_conditions.js

@@ -1,206 +0,0 @@
-'use strict';
-
-const {fakeGetUserMedia} = require('ep_webrtc/static/tests/frontend/utils');
-
-describe('Race conditions that leave audio/video track enabled', function () {
-  // The idea here is to place high value on making sure that the "mute" and "video-off" buttons in
-  // the video interfaces match with the audioTrack.enabled/videoTrack.enabled, so that users don't
-  // get the wrong idea about whether the audio or video feed are on.
-  //
-  // These tests are various ideas for trying to do things in quick succession
-  // or "at the same time". We can add more if we think of them.
-
-  for (const enabledOnStart of [false, true]) {
-    describe(`audio and video ${enabledOnStart ? 'en' : 'dis'}abled on start`, function () {
-      let chrome$;
-
-      const getVideo = () => chrome$('video')[0];
-      const getStream = () => getVideo().srcObject;
-      const assertTracks = (enabled = enabledOnStart) => {
-        if (enabled) {
-          expect(getStream().getTracks().length).to.equal(2);
-          expect(getStream().getTracks().every((t) => t.enabled)).to.be(true);
-        } else {
-          expect(getStream().getTracks().some((t) => t.enabled)).to.be(false);
-        }
-        const [audio] = getStream().getAudioTracks();
-        const [video] = getStream().getVideoTracks();
-        expect(chrome$('.audio-btn').hasClass('muted')).to.equal(audio == null || !audio.enabled);
-        expect(chrome$('.video-btn').hasClass('off')).to.equal(video == null || !video.enabled);
-      };
-
-      beforeEach(async function () {
-        this.timeout(60000);
-        await helper.aNewPad({
-          padPrefs: {
-            audioEnabledOnStart: enabledOnStart,
-            videoEnabledOnStart: enabledOnStart,
-          },
-          // Disable WebRTC so we can install a fake getUserMedia() before it is called.
-          params: {av: false},
-        });
-        chrome$ = helper.padChrome$;
-        chrome$.window.navigator.mediaDevices.getUserMedia = fakeGetUserMedia;
-        chrome$('#options-enablertc').click();
-        await helper.waitForPromise(() => chrome$('#rtcbox').data('initialized'));
-        const ownVideoId = `video_${chrome$.window.ep_webrtc.getUserId().replace(/\./g, '_')}`;
-        await helper.waitForPromise(() => getVideo() != null);
-        const $interface = chrome$(`#interface_${ownVideoId}`);
-        expect($interface.length).to.equal(1);
-        expect(chrome$('.audio-btn').length).to.equal(1);
-        expect(chrome$('.video-btn').length).to.equal(1);
-        await helper.waitForPromise(
-            () => getStream() != null && (!enabledOnStart || getStream().getTracks().length === 2));
-        assertTracks();
-      });
-
-      // See if we can trip up the state by "deactivating" webrtc, clicking mute/video-off, and
-      // "activating" webrtc in quick succession. As of this writing, "deactivating" will make the
-      // buttons disappear pretty quickly, making the "click" ineffectual, regardless, but in case
-      // we ever change things around, perhaps this test will catch something.
-      it('deactivate, click, activate', async function () {
-        for (let i = 0; i < 10; ++i) {
-          const [oldAudioTrack] = getStream().getAudioTracks();
-          const [oldVideoTrack] = getStream().getVideoTracks();
-
-          await chrome$.window.ep_webrtc.deactivate();
-          chrome$('.audio-btn').click();
-          chrome$('.video-btn').click();
-          await chrome$.window.ep_webrtc.activate();
-
-          assertTracks();
-
-          const [newAudioTrack] = getStream().getAudioTracks();
-          const [newVideoTrack] = getStream().getVideoTracks();
-
-          if (enabledOnStart) {
-            expect(newAudioTrack).to.not.equal(oldAudioTrack);
-            expect(oldAudioTrack.readyState).to.equal('ended');
-            expect(newAudioTrack.readyState).to.equal('live');
-
-            expect(newVideoTrack).to.not.equal(oldVideoTrack);
-            expect(oldVideoTrack.readyState).to.equal('ended');
-            expect(newVideoTrack.readyState).to.equal('live');
-          }
-        }
-      });
-
-      // See if we can trip up the state by clicking mute/video-off, "deactivating" webrtc, and
-      // "activating" webrtc in quick succession
-      it('click, deactivate, activate', async function () {
-        for (let i = 0; i < 10; ++i) {
-          const [oldAudioTrack] = getStream().getAudioTracks();
-          const [oldVideoTrack] = getStream().getVideoTracks();
-
-          chrome$('.audio-btn').click();
-          chrome$('.video-btn').click();
-          await chrome$.window.ep_webrtc.deactivate();
-          await chrome$.window.ep_webrtc.activate();
-
-          assertTracks();
-
-          const [newAudioTrack] = getStream().getAudioTracks();
-          const [newVideoTrack] = getStream().getVideoTracks();
-
-          if (enabledOnStart) {
-            expect(newAudioTrack).to.not.equal(oldAudioTrack);
-            expect(oldAudioTrack.readyState).to.equal('ended');
-            expect(newAudioTrack.readyState).to.equal('live');
-
-            expect(newVideoTrack).to.not.equal(oldVideoTrack);
-            expect(oldVideoTrack.readyState).to.equal('ended');
-            expect(newVideoTrack.readyState).to.equal('live');
-          }
-        }
-      });
-
-      // See if we can trip up the state by "deactivating" webrtc, "activating" webrtc, and then
-      // clicking mute/video-off right after the interface returns.
-      it('deactivate, activate, click', async function () {
-        for (let i = 0; i < 10; ++i) {
-          const [oldAudioTrack] = getStream().getAudioTracks();
-          const [oldVideoTrack] = getStream().getVideoTracks();
-
-          await chrome$.window.ep_webrtc.deactivate();
-          const p = chrome$.window.ep_webrtc.activate();
-          await helper.waitForPromise(
-              () => chrome$ && chrome$('.interface-container').length === 1, 2000);
-          chrome$('.audio-btn').click();
-          chrome$('.video-btn').click();
-          await Promise.all([
-            p,
-            chrome$('.audio-btn').data('idle')('click'),
-            chrome$('.video-btn').data('idle')('click'),
-          ]);
-
-          assertTracks(!enabledOnStart);
-
-          const [newAudioTrack] = getStream().getAudioTracks();
-          const [newVideoTrack] = getStream().getVideoTracks();
-
-          expect(newAudioTrack).to.not.equal(oldAudioTrack);
-          if (oldAudioTrack != null) expect(oldAudioTrack.readyState).to.equal('ended');
-          if (newAudioTrack != null) expect(newAudioTrack.readyState).to.equal('live');
-
-          expect(newVideoTrack).to.not.equal(oldVideoTrack);
-          if (oldVideoTrack != null) expect(oldVideoTrack.readyState).to.equal('ended');
-          if (newVideoTrack != null) expect(newVideoTrack.readyState).to.equal('live');
-        }
-      });
-
-      // See if we can trip up the state by clicking mute/video-off, "deactivating"/"activating"
-      // webrtc, as close to at the same time as we can
-      it('click while reactivate', async function () {
-        for (let i = 0; i < 10; i++) {
-          const [oldAudioTrack] = getStream().getAudioTracks();
-          const [oldVideoTrack] = getStream().getVideoTracks();
-
-          await chrome$.window.ep_webrtc.deactivate();
-          const p = chrome$.window.ep_webrtc.activate();
-          chrome$('.audio-btn').click();
-          chrome$('.video-btn').click();
-          await Promise.all([
-            p,
-            chrome$('.audio-btn').data('idle')(),
-            chrome$('.video-btn').data('idle')(),
-          ]);
-
-          assertTracks(!enabledOnStart);
-
-          const [newAudioTrack] = getStream().getAudioTracks();
-          const [newVideoTrack] = getStream().getVideoTracks();
-
-          if (!enabledOnStart) {
-            expect(newAudioTrack).to.not.equal(oldAudioTrack);
-            if (oldAudioTrack != null) expect(oldAudioTrack.readyState).to.equal('ended');
-            if (newAudioTrack != null) expect(newAudioTrack.readyState).to.equal('live');
-
-            expect(newVideoTrack).to.not.equal(oldVideoTrack);
-            if (oldVideoTrack != null) expect(oldVideoTrack.readyState).to.equal('ended');
-            if (newVideoTrack != null) expect(newVideoTrack.readyState).to.equal('live');
-          }
-        }
-      });
-
-      // See if we can trip up the state by clicking mute/video-off many times at once. We click
-      // mute an odd number of times and video-off an even number of times.
-      it('many clicks', async function () {
-        for (let i = 0; i < 10; ++i) {
-          chrome$('.audio-btn').click();
-          chrome$('.audio-btn').click();
-          chrome$('.audio-btn').click();
-          chrome$('.video-btn').click();
-          chrome$('.video-btn').click();
-          await Promise.all([
-            chrome$('.audio-btn').data('idle')(),
-            chrome$('.video-btn').data('idle')(),
-          ]);
-          expect(chrome$('.audio-btn').hasClass('muted'))
-              .to.equal(((i + 1) * 3 + (enabledOnStart ? 1 : 0)) % 2 === 0);
-          expect(chrome$('.video-btn').hasClass('off'))
-              .to.equal(((i + 1) * 2 + (enabledOnStart ? 1 : 0)) % 2 === 0);
-        }
-      });
-    });
-  }
-});

package/static/tests/frontend/specs/setStream.js

@@ -1,138 +0,0 @@
-'use strict';
-
-const {cartesian, fakeGetUserMedia} = require('ep_webrtc/static/tests/frontend/utils');
-
-describe('setStream()', function () {
-  let chrome$;
-  const otherUserId = 'other_user_id';
-  const otherVideoId = `video_${otherUserId.replace(/\./g, '_')}`;
-  const otherInterfaceId = `interface_${otherVideoId}`;
-  let ownUserId, ownVideoId, ownInterfaceId;
-
-  describe('Audio and video enabled', function () {
-    const testCases = [...cartesian(...Array(4).fill([false, true]))].map(
-        ([webrtcaudioenabled, webrtcvideoenabled, peerAudio, peerVideo]) => ({
-          params: {webrtcaudioenabled, webrtcvideoenabled},
-          peer: {audio: peerAudio, video: peerVideo},
-        }));
-
-    for (const tc of testCases) {
-      describe(JSON.stringify(tc), function () {
-        before(async function () {
-          this.timeout(60000);
-          await helper.aNewPad({
-            // Disable WebRTC so we can install a mock getUserMedia() before it is called.
-            params: Object.assign({av: false}, tc.params),
-          });
-          chrome$ = helper.padChrome$;
-          chrome$.window.navigator.mediaDevices.getUserMedia = fakeGetUserMedia;
-          // Clicking $(#options-enablertc) also activates, but calling activate() directly blocks
-          // until activation is complete.
-          await chrome$.window.ep_webrtc.activate();
-          ownUserId = chrome$.window.ep_webrtc.getUserId();
-          ownVideoId = `video_${ownUserId.replace(/\./g, '_')}`;
-          ownInterfaceId = `interface_${ownVideoId}`;
-          const peerStream =
-              tc.peer.audio || tc.peer.video ? await fakeGetUserMedia(tc.peer) : new MediaStream();
-          await chrome$.window.ep_webrtc.setStream(otherUserId, peerStream);
-        });
-
-        it('self and peer elements exist', async function () {
-          expect(chrome$('.interface-container').length).to.equal(2);
-        });
-
-        it('self interface', async function () {
-          // Self view is always muted because users shouldn't hear themselves (otherwise there
-          // would be audio feedback).
-          expect(chrome$(`#${ownVideoId}`).prop('muted')).to.equal(true);
-          const $audioBtn = chrome$(`#${ownInterfaceId} .audio-btn`);
-          expect($audioBtn.length).to.equal(1);
-          expect($audioBtn.hasClass('muted')).to.equal(!tc.params.webrtcaudioenabled);
-          expect($audioBtn.hasClass('disallowed')).to.equal(false);
-          const $videoBtn = chrome$(`#${ownInterfaceId} .video-btn`);
-          expect($videoBtn.length).to.equal(1);
-          expect($videoBtn.hasClass('off')).to.equal(!tc.params.webrtcvideoenabled);
-          expect($videoBtn.hasClass('disallowed')).to.equal(false);
-          const $enlargeBtn = chrome$(`#${ownInterfaceId} .enlarge-btn`);
-          expect($enlargeBtn.length).to.equal(1);
-          expect($enlargeBtn.hasClass('large')).to.equal(false);
-        });
-
-        it('peer interface', async function () {
-          const $audioBtn = chrome$(`#${otherInterfaceId} .audio-btn`);
-          expect($audioBtn.length).to.equal(1);
-          // Only initially muted if the browser doesn't give permission to autoplay unless muted.
-          // (A peer without an audio track might later add an audio track; if so, the audio should
-          // start playing locally without the local user clicking anything.)
-          expect($audioBtn.hasClass('muted')).to.equal(chrome$(`#${otherVideoId}`).prop('muted'));
-          const $videoBtn = chrome$(`#${otherInterfaceId} .video-btn`);
-          expect($videoBtn.length).to.equal(0);
-          const $enlargeBtn = chrome$(`#${otherInterfaceId} .enlarge-btn`);
-          expect($enlargeBtn.length).to.equal(1);
-          expect($enlargeBtn.hasClass('large')).to.equal(false);
-        });
-      });
-    }
-  });
-
-  describe('Audio and video hard disabled', function () {
-    before(async function () {
-      this.timeout(60000);
-      await helper.aNewPad({
-        params: {
-          // Disable WebRTC so we can modify settings and install a fake getUserMedia() before
-          // WebRTC stuff is initialized.
-          av: false,
-          webrtcaudioenabled: true,
-          webrtcvideoenabled: true,
-        },
-      });
-      chrome$ = helper.padChrome$;
-      chrome$.window.navigator.mediaDevices.getUserMedia = fakeGetUserMedia;
-      await helper.waitForPromise(() => chrome$('#rtcbox').data('initialized'));
-      chrome$.window.ep_webrtc._settings.audio.disabled = 'hard';
-      chrome$.window.ep_webrtc._settings.video.disabled = 'hard';
-      // Clicking $(#options-enablertc) also activates, but calling activate() directly blocks until
-      // activation is complete.
-      await chrome$.window.ep_webrtc.activate();
-      ownUserId = chrome$.window.ep_webrtc.getUserId();
-      ownVideoId = `video_${ownUserId.replace(/\./g, '_')}`;
-      ownInterfaceId = `interface_${ownVideoId}`;
-      await chrome$.window.ep_webrtc.setStream(otherUserId, new MediaStream());
-    });
-
-    it('self and peer elements exist', async function () {
-      expect(chrome$('.interface-container').length).to.equal(2);
-    });
-
-    it('self interface', async function () {
-      expect(chrome$(`#${ownVideoId}`).prop('muted')).to.equal(true);
-      const $audioBtn = chrome$(`#${ownInterfaceId} .audio-btn`);
-      expect($audioBtn.length).to.equal(1);
-      expect($audioBtn.hasClass('muted')).to.equal(true);
-      expect($audioBtn.hasClass('disallowed')).to.equal(true);
-      const $videoBtn = chrome$(`#${ownInterfaceId} .video-btn`);
-      expect($videoBtn.length).to.equal(1);
-      expect($videoBtn.hasClass('off')).to.equal(true);
-      expect($videoBtn.hasClass('disallowed')).to.equal(true);
-      const $enlargeBtn = chrome$(`#${ownInterfaceId} .enlarge-btn`);
-      expect($enlargeBtn.length).to.equal(1);
-      expect($enlargeBtn.hasClass('large')).to.equal(false);
-    });
-
-    it('peer interface', async function () {
-      const $audioBtn = chrome$(`#${otherInterfaceId} .audio-btn`);
-      expect($audioBtn.length).to.equal(1);
-      // Mute state only depends on whether the browser gives permission to autoplay when unmuted.
-      // Hard disabling only affects what the local client sends; it doesn't affect what the remote
-      // peer sends. (Both the local client and the remote peer should see the same settings,
-      // however.)
-      expect($audioBtn.hasClass('muted')).to.equal(chrome$(`#${otherVideoId}`).prop('muted'));
-      const $videoBtn = chrome$(`#${otherInterfaceId} .video-btn`);
-      expect($videoBtn.length).to.equal(0);
-      const $enlargeBtn = chrome$(`#${otherInterfaceId} .enlarge-btn`);
-      expect($enlargeBtn.length).to.equal(1);
-      expect($enlargeBtn.hasClass('large')).to.equal(false);
-    });
-  });
-});

package/static/tests/frontend/utils.js

@@ -1,44 +0,0 @@
-'use strict';
-
-// Generator function that yields the Cartesian product of the given iterables.
-exports.cartesian = function* (head, ...tail) {
-  const remainder = tail.length > 0 ? exports.cartesian(...tail) : [[]];
-  for (const r of remainder) for (const h of head) yield [h, ...r];
-};
-
-const makeSilentAudioTrack = () => {
-  const ctx = new AudioContext();
-  const gain = ctx.createGain();
-  const dst = gain.connect(ctx.createMediaStreamDestination());
-  return dst.stream.getAudioTracks()[0];
-};
-
-const makeVideoTrack = (constraints) => {
-  const canvas = helper.padChrome$.window.document.createElement('canvas');
-  const {
-    width: {max: widthMax = 160, ideal: widthIdeal} = {},
-    height: {max: heightMax = 120, ideal: heightIdeal} = {},
-  } = constraints;
-  canvas.width = widthIdeal || widthMax;
-  canvas.height = heightIdeal || heightMax;
-  const ctx = canvas.getContext('2d');
-  // Some animation is needed because in some browsers HTMLVideoElement.play() will hang until the
-  // canvas is updated. The pad's window.setInterval is called in the hopes that the interval will
-  // be automatically stopped once the pad is unloaded.
-  helper.padChrome$.window.setInterval(() => {
-    ctx.fillStyle = `#${Math.floor(Math.random() * 2 ** 24).toString(16).padStart(6, '0')}`;
-    ctx.fillRect(0, 0, canvas.width, canvas.height);
-  }, 100); // Use a relatively high frame rate to speed up tests.
-  return canvas.captureStream().getVideoTracks()[0];
-};
-
-// Creates dummy audio and/or video tracks. Limitations:
-//   - Most browsers prohibit audio until there has been some user interaction with the page or
-//     the real getUserMedia() has been called.
-exports.fakeGetUserMedia = async ({audio, video}) => {
-  if (!audio && !video) throw new DOMException('either audio or video is required', 'TypeError');
-  return new MediaStream([
-    ...(audio ? [makeSilentAudioTrack()] : []),
-    ...(video ? [makeVideoTrack(video)] : []),
-  ]);
-};