You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

RTCUtils.spec.js 8.4KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252
  1. import browser from '../browser';
  2. import RTCUtils from './RTCUtils';
  3. import screenObtainer from './ScreenObtainer';
  4. // TODO move webrtc mocks/polyfills into a easily accessible file when needed
  5. /**
  6. * A constructor to create a mock for the native MediaStreamTrack.
  7. */
  8. function MediaStreamTrackMock(kind, options = {}) {
  9. this.kind = kind;
  10. this._settings = {};
  11. if (options.resolution) {
  12. this._settings.height = options.resolution;
  13. }
  14. }
  15. MediaStreamTrackMock.prototype.getSettings = function() {
  16. return this._settings;
  17. };
  18. MediaStreamTrackMock.prototype.stop
  19. = function() { /** intentionally blank **/ };
  20. /**
  21. * A constructor to create a mock for the native MediaStream.
  22. */
  23. function MediaStreamMock() {
  24. this.id = Date.now();
  25. this._audioTracks = [];
  26. this._videoTracks = [];
  27. }
  28. MediaStreamMock.prototype.addTrack = function(track) {
  29. if (track.kind === 'audio') {
  30. this._audioTracks.push(track);
  31. } else if (track.kind === 'video') {
  32. this._videoTracks.push(track);
  33. }
  34. };
  35. MediaStreamMock.prototype.getAudioTracks = function() {
  36. return this._audioTracks;
  37. };
  38. MediaStreamMock.prototype.getTracks = function() {
  39. return [
  40. ...this._audioTracks,
  41. ...this._videoTracks
  42. ];
  43. };
  44. MediaStreamMock.prototype.getVideoTracks = function() {
  45. return this._videoTracks;
  46. };
  47. /* eslint-disable max-params */
  48. /**
  49. * A mock function to be used for stubbing out the wrapper around getUserMedia.
  50. *
  51. * @param {String[]} devices - The media devices to obtain. Valid devices are
  52. * 'audio', 'video', and 'desktop'.
  53. * @param {Function} onSuccess - An optional success callback to trigger.
  54. * @param {Function} onError - An optional error callback to trigger. This is
  55. * not used in this function.
  56. * @param {Object} options - An object describing the constraints to pass to
  57. * gum.
  58. * @private
  59. * @returns {Promise} A resolved promise with a MediaStreamMock.
  60. */
  61. function successfulGum(devices, options) {
  62. /* eslint-enable max-params */
  63. const mediaStreamMock = new MediaStreamMock();
  64. if (devices.includes('audio')) {
  65. mediaStreamMock.addTrack(new MediaStreamTrackMock('audio', options));
  66. }
  67. if (devices.includes('video')) {
  68. mediaStreamMock.addTrack(new MediaStreamTrackMock('video', options));
  69. }
  70. if (devices.includes('desktop')) {
  71. mediaStreamMock.addTrack(new MediaStreamTrackMock('video', options));
  72. }
  73. return Promise.resolve(mediaStreamMock);
  74. }
  75. /**
  76. * General error handling for a promise chain that threw an unexpected error.
  77. *
  78. * @param {Error} error - The error object describing what error occurred.
  79. * @param {function} done - Jasmine's done function to trigger a failed test.
  80. * @private
  81. * @returns {void}
  82. */
  83. function unexpectedErrorHandler(error = {}, done) {
  84. done.fail(`unexpected error occurred: ${error.message}`);
  85. }
  86. describe('RTCUtils', () => {
  87. describe('obtainAudioAndVideoPermissions', () => {
  88. let getUserMediaSpy, isScreenSupportedSpy, oldMediaStream,
  89. oldMediaStreamTrack, oldWebkitMediaStream;
  90. beforeEach(() => {
  91. // FIXME: To get some kind of initial testing working assume a
  92. // chrome environment so RTCUtils can actually initialize properly.
  93. spyOn(browser, 'isChrome').and.returnValue(true);
  94. spyOn(screenObtainer, '_createObtainStreamMethod')
  95. .and.returnValue(() => { /** intentional no op */ });
  96. isScreenSupportedSpy = spyOn(screenObtainer, 'isSupported')
  97. .and.returnValue(true);
  98. oldMediaStreamTrack = window.MediaStreamTrack;
  99. window.MediaStreamTrack = MediaStreamTrackMock;
  100. oldMediaStream = window.MediaStream;
  101. window.MediaStream = MediaStreamMock;
  102. oldWebkitMediaStream = window.webkitMediaStream;
  103. window.webkitMediaStream = MediaStreamMock;
  104. RTCUtils.init();
  105. getUserMediaSpy = spyOn(RTCUtils, 'getUserMediaWithConstraints');
  106. });
  107. afterEach(() => {
  108. window.MediaStreamTrack = oldMediaStreamTrack;
  109. window.MediaStream = oldMediaStream;
  110. window.webkitMediaStream = oldWebkitMediaStream;
  111. });
  112. it('gets audio and video by default', done => {
  113. getUserMediaSpy.and.callFake(successfulGum);
  114. RTCUtils.obtainAudioAndVideoPermissions()
  115. .then(streams => {
  116. expect(streams.length).toBe(2);
  117. const audioStream = streams.find(stream =>
  118. stream.mediaType === 'audio');
  119. expect(audioStream).toBeTruthy();
  120. expect(audioStream.stream instanceof MediaStreamMock)
  121. .toBe(true);
  122. expect(audioStream.stream.getAudioTracks().length).toBe(1);
  123. const videoStream = streams.find(stream =>
  124. stream.mediaType === 'video');
  125. expect(videoStream).toBeTruthy();
  126. expect(videoStream.stream instanceof MediaStreamMock)
  127. .toBe(true);
  128. expect(videoStream.stream.getVideoTracks().length).toBe(1);
  129. done();
  130. })
  131. .catch(error => unexpectedErrorHandler(error, done));
  132. });
  133. it('can get an audio track', done => {
  134. getUserMediaSpy.and.callFake(successfulGum);
  135. RTCUtils.obtainAudioAndVideoPermissions({ devices: [ 'audio' ] })
  136. .then(streams => {
  137. expect(streams.length).toBe(1);
  138. expect(streams[0].stream instanceof MediaStreamMock)
  139. .toBe(true);
  140. expect(streams[0].stream.getAudioTracks().length).toBe(1);
  141. done();
  142. })
  143. .catch(error => unexpectedErrorHandler(error, done));
  144. });
  145. it('can get a video track', done => {
  146. getUserMediaSpy.and.callFake(successfulGum);
  147. RTCUtils.obtainAudioAndVideoPermissions({ devices: [ 'video' ] })
  148. .then(streams => {
  149. expect(streams.length).toBe(1);
  150. expect(streams[0].stream instanceof MediaStreamMock)
  151. .toBe(true);
  152. expect(streams[0].stream.getVideoTracks().length).toBe(1);
  153. done();
  154. })
  155. .catch(error => unexpectedErrorHandler(error, done));
  156. });
  157. it('gets 720 videor resolution by default', done => {
  158. getUserMediaSpy.and.callFake(successfulGum);
  159. RTCUtils.obtainAudioAndVideoPermissions({ devices: [ 'video' ] })
  160. .then(streams => {
  161. const videoTrack = streams[0].stream.getVideoTracks()[0];
  162. const { height } = videoTrack.getSettings();
  163. expect(height).toBe(720);
  164. done();
  165. })
  166. .catch(error => unexpectedErrorHandler(error, done));
  167. });
  168. describe('requesting desktop', () => {
  169. it('errors if desktop is not supported', done => {
  170. isScreenSupportedSpy.and.returnValue(false);
  171. RTCUtils.obtainAudioAndVideoPermissions({
  172. devices: [ 'desktop' ] })
  173. .then(() => done.fail(
  174. 'obtainAudioAndVideoPermissions should not succeed'))
  175. .catch(error => {
  176. expect(error.message)
  177. .toBe('Desktop sharing is not supported!');
  178. done();
  179. });
  180. });
  181. it('can obtain a desktop stream', done => {
  182. spyOn(screenObtainer, 'obtainStream')
  183. .and.callFake((options, success) => {
  184. const mediaStreamMock = new MediaStreamMock();
  185. mediaStreamMock.addTrack(
  186. new MediaStreamTrackMock('video', options));
  187. success({ stream: mediaStreamMock });
  188. });
  189. RTCUtils.obtainAudioAndVideoPermissions({
  190. devices: [ 'desktop' ] })
  191. .then(streams => {
  192. expect(streams.length).toBe(1);
  193. expect(streams[0].videoType).toBe('desktop');
  194. done();
  195. })
  196. .catch(error => unexpectedErrorHandler(error, done));
  197. });
  198. });
  199. });
  200. });