Files
shaka-player/test/player_integration.js
T
Jacob Trimble 4fdf8f7a1c Allow running tests without Babel.
This greatly speeds up startup time when running tests on a modern
browser.  This change also fixes a bug in one of the tests that only
worked with Babel running.

Change-Id: I1493ef30388c5043dcdf8350bec7817ab5d28d55
2019-08-20 20:10:02 +00:00

1673 lines
54 KiB
JavaScript

/**
* @license
* Copyright 2016 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
describe('Player', () => {
const Util = shaka.test.Util;
const waitUntilPlayheadReaches = Util.waitUntilPlayheadReaches;
/** @type {!jasmine.Spy} */
let onErrorSpy;
/** @type {!HTMLVideoElement} */
let video;
/** @type {shaka.Player} */
let player;
/** @type {!shaka.util.EventManager} */
let eventManager;
let compiledShaka;
beforeAll(async () => {
video = shaka.util.Dom.createVideoElement();
document.body.appendChild(video);
compiledShaka = await Util.loadShaka(getClientArg('uncompiled'));
});
beforeEach(async () => {
await shaka.test.TestScheme.createManifests(compiledShaka, '_compiled');
player = new compiledShaka.Player(video);
// Grab event manager from the uncompiled library:
eventManager = new shaka.util.EventManager();
onErrorSpy = jasmine.createSpy('onError');
onErrorSpy.and.callFake((event) => {
fail(event.detail);
});
eventManager.listen(player, 'error', Util.spyFunc(onErrorSpy));
});
afterEach(async () => {
eventManager.release();
await player.destroy();
});
afterAll(() => {
document.body.removeChild(video);
});
describe('attach', () => {
beforeEach(async () => {
// To test attach, we want to construct a player without a video element
// attached in advance. To do that, we destroy the player that was
// constructed in the outermost beforeEach(), then construct a new one
// without a video element.
await player.destroy();
player = new compiledShaka.Player();
});
it('can be used before load()', async () => {
await player.attach(video);
await player.load('test:sintel_compiled');
});
});
describe('getStats', () => {
it('gives stats about current stream', async () => {
// This is tested more in player_unit.js. This is here to test the public
// API and to check for renaming.
await player.load('test:sintel_compiled');
video.play();
await waitUntilPlayheadReaches(eventManager, video, 1, 10);
const stats = player.getStats();
const expected = {
width: jasmine.any(Number),
height: jasmine.any(Number),
streamBandwidth: jasmine.any(Number),
decodedFrames: jasmine.any(Number),
droppedFrames: jasmine.any(Number),
estimatedBandwidth: jasmine.any(Number),
loadLatency: jasmine.any(Number),
playTime: jasmine.any(Number),
pauseTime: jasmine.any(Number),
bufferingTime: jasmine.any(Number),
// We should have loaded the first Period by now, so we should have a
// history.
switchHistory: jasmine.arrayContaining([{
timestamp: jasmine.any(Number),
id: jasmine.any(Number),
type: 'variant',
fromAdaptation: true,
bandwidth: 0,
}]),
stateHistory: jasmine.arrayContaining([{
state: 'playing',
timestamp: jasmine.any(Number),
duration: jasmine.any(Number),
}]),
};
expect(stats).toEqual(expected);
});
});
describe('setTextTrackVisibility', () => {
// Using mode='disabled' on TextTrack causes cues to go null, which leads
// to a crash in TextEngine. This validates that we do not trigger this
// behavior when changing visibility of text.
it('does not cause cues to be null', async () => {
await player.load('test:sintel_compiled');
video.play();
await waitUntilPlayheadReaches(eventManager, video, 1, 10);
// This TextTrack was created as part of load() when we set up the
// TextDisplayer.
const textTrack = video.textTracks[0];
expect(textTrack).not.toBe(null);
if (textTrack) {
// This should not be null initially.
expect(textTrack.cues).not.toBe(null);
await player.setTextTrackVisibility(true);
// This should definitely not be null when visible.
expect(textTrack.cues).not.toBe(null);
await player.setTextTrackVisibility(false);
// This should not transition to null when invisible.
expect(textTrack.cues).not.toBe(null);
}
});
it('is called automatically if language prefs match', async () => {
// If the text is a match for the user's preferences, and audio differs
// from text, we enable text display automatically.
// NOTE: This is also a regression test for #1696, in which a change
// to this feature broke StreamingEngine initialization.
const preferredTextLanguage = 'fa'; // The same as in the content itself
player.configure({preferredTextLanguage: preferredTextLanguage});
// Now load a version of Sintel with delayed setup of video & audio
// streams and wait for completion.
await player.load('test:sintel_realistic_compiled');
// By this point, a MediaSource error would be thrown in a repro of bug
// #1696.
// Make sure the automatic setting took effect.
expect(player.isTextTrackVisible()).toBe(true);
// Make sure the content we tested with has text tracks, that the config
// we used matches the text language, and that the audio language differs.
// These will catch any changes to the underlying content that would
// invalidate the test setup.
expect(player.getTextTracks().length).not.toBe(0);
const textTrack = player.getTextTracks()[0];
expect(textTrack.language).toBe(preferredTextLanguage);
const variantTrack = player.getVariantTracks()[0];
expect(variantTrack.language).not.toBe(textTrack.language);
});
it('is not called automatically without language pref match', async () => {
// If the text preference doesn't match the content, we do not enable text
// display automatically.
const preferredTextLanguage = 'xx'; // Differs from the content itself
player.configure({preferredTextLanguage: preferredTextLanguage});
// Now load the content and wait for completion.
await player.load('test:sintel_realistic_compiled');
// Make sure the automatic setting did not happen.
expect(player.isTextTrackVisible()).toBe(false);
// Make sure the content we tested with has text tracks, that the config
// we used does not match the text language, and that the text and audio
// languages do not match each other (to keep this distinct from the next
// test case). This will catch any changes to the underlying content that
// would invalidate the test setup.
expect(player.getTextTracks().length).not.toBe(0);
const textTrack = player.getTextTracks()[0];
expect(textTrack.language).not.toBe(preferredTextLanguage);
const variantTrack = player.getVariantTracks()[0];
expect(variantTrack.language).not.toBe(textTrack.language);
});
it('is not called automatically with audio and text match', async () => {
// If the audio and text tracks use the same language, we do not enable
// text display automatically, no matter the text preference.
const preferredTextLanguage = 'und'; // The same as in the content itself
player.configure({preferredTextLanguage: preferredTextLanguage});
// Now load the content and wait for completion.
await player.load('test:sintel_compiled');
// Make sure the automatic setting did not happen.
expect(player.isTextTrackVisible()).toBe(false);
// Make sure the content we tested with has text tracks, that the
// config we used matches the content, and that the text and audio
// languages match each other. This will catch any changes to the
// underlying content that would invalidate the test setup.
expect(player.getTextTracks().length).not.toBe(0);
const textTrack = player.getTextTracks()[0];
expect(textTrack.language).toBe(preferredTextLanguage);
const variantTrack = player.getVariantTracks()[0];
expect(variantTrack.language).toBe(textTrack.language);
});
// Repro for https://github.com/google/shaka-player/issues/1879.
it('actually appends cues when enabled initially', async () => {
let cues = [];
/** @const {!shaka.test.FakeTextDisplayer} */
const displayer = new shaka.test.FakeTextDisplayer();
displayer.appendSpy.and.callFake((added) => {
cues = cues.concat(added);
});
player.configure('textDisplayFactory', Util.factoryReturns(displayer));
const preferredTextLanguage = 'fa'; // The same as in the content itself
player.configure({preferredTextLanguage: preferredTextLanguage});
await player.load('test:sintel_realistic_compiled');
await Util.delay(1); // Allow the first segments to be appended.
expect(player.isTextTrackVisible()).toBe(true);
expect(displayer.isTextVisible()).toBe(true);
expect(cues.length).toBeGreaterThan(0);
});
it('actually appends cues for external text', async () => {
let cues = [];
/** @const {!shaka.test.FakeTextDisplayer} */
const displayer = new shaka.test.FakeTextDisplayer();
displayer.appendSpy.and.callFake((added) => {
cues = cues.concat(added);
});
player.configure('textDisplayFactory', Util.factoryReturns(displayer));
const eventManager = new shaka.util.EventManager();
/** @type {shaka.test.Waiter} */
const waiter = new shaka.test.Waiter(eventManager);
await player.load('test:sintel_no_text_compiled');
const locationUri = new goog.Uri(location.href);
const partialUri = new goog.Uri('/base/test/test/assets/text-clip.vtt');
const absoluteUri = locationUri.resolve(partialUri);
await player.addTextTrack(absoluteUri.toString(), 'en', 'subtitles',
'text/vtt');
const textTracks = player.getTextTracks();
expect(textTracks).toBeTruthy();
expect(textTracks.length).toBe(1);
player.setTextTrackVisibility(true);
await waiter.waitForEvent(player, 'texttrackvisibility');
// Wait for the text cues to get appended.
// TODO: this should be based on an event instead.
await Util.delay(1);
expect(player.isTextTrackVisible()).toBe(true);
expect(displayer.isTextVisible()).toBe(true);
expect(cues.length).toBeGreaterThan(0);
});
});
describe('plays', () => {
it('with external text tracks', async () => {
await player.load('test:sintel_no_text_compiled');
// For some reason, using path-absolute URLs (i.e. without the hostname)
// like this doesn't work on Safari. So manually resolve the URL.
const locationUri = new goog.Uri(location.href);
const partialUri = new goog.Uri('/base/test/test/assets/text-clip.vtt');
const absoluteUri = locationUri.resolve(partialUri);
await player.addTextTrack(absoluteUri.toString(), 'en', 'subtitles',
'text/vtt');
const textTracks = player.getTextTracks();
expect(textTracks).toBeTruthy();
expect(textTracks.length).toBe(1);
expect(textTracks[0].active).toBe(true);
expect(textTracks[0].language).toBe('en');
});
it('with cea closed captions', async () => {
await player.load('test:cea-708_mp4_compiled');
const textTracks = player.getTextTracks();
expect(textTracks).toBeTruthy();
expect(textTracks.length).toBe(1);
expect(textTracks[0].language).toBe('en');
});
it('while changing languages with short Periods', async () => {
// See: https://github.com/google/shaka-player/issues/797
player.configure({preferredAudioLanguage: 'en'});
await player.load('test:sintel_short_periods_compiled');
video.play();
await waitUntilPlayheadReaches(eventManager, video, 8, 30);
// The Period changes at 10 seconds. Assert that we are in the previous
// Period and have buffered into the next one.
expect(video.currentTime).toBeLessThan(9);
// The two periods might not be in a single contiguous buffer, so don't
// check end(0). Gap-jumping will deal with any discontinuities.
const bufferEnd = video.buffered.end(video.buffered.length - 1);
expect(bufferEnd).toBeGreaterThan(11);
// Change to a different language; this should clear the buffers and
// cause a Period transition again.
expect(getActiveLanguage()).toBe('en');
player.selectAudioLanguage('es');
await waitUntilPlayheadReaches(eventManager, video, 21, 30);
// Should have gotten past the next Period transition and still be
// playing the new language.
expect(getActiveLanguage()).toBe('es');
});
it('at higher playback rates', async () => {
await player.load('test:sintel_compiled');
video.play();
await waitUntilPlayheadReaches(eventManager, video, 1, 10);
// Enabling trick play should change our playback rate to the same rate.
player.trickPlay(2);
expect(video.playbackRate).toBe(2);
// Let playback continue playing for a bit longer.
await shaka.test.Util.delay(2);
// Cancelling trick play should return our playback rate to normal.
player.cancelTrickPlay();
expect(video.playbackRate).toBe(1);
});
/**
* Gets the language of the active Variant.
* @return {string}
*/
function getActiveLanguage() {
const tracks = player.getVariantTracks().filter((t) => {
return t.active;
});
expect(tracks.length).toBeGreaterThan(0);
return tracks[0].language;
}
});
describe('TextDisplayer plugin', () => {
// Simulate the use of an external TextDisplayer plugin.
/** @type {shaka.test.FakeTextDisplayer} */
let textDisplayer;
beforeEach(() => {
textDisplayer = new shaka.test.FakeTextDisplayer();
textDisplayer.isTextVisibleSpy.and.callFake(() => {
return false;
});
textDisplayer.destroySpy.and.returnValue(Promise.resolve());
player.configure({
textDisplayFactory: Util.factoryReturns(textDisplayer),
});
// Make sure the configuration was taken.
const ConfiguredFactory = player.getConfiguration().textDisplayFactory;
const configuredTextDisplayer = new ConfiguredFactory();
expect(configuredTextDisplayer).toBe(textDisplayer);
});
// Regression test for https://github.com/google/shaka-player/issues/1187
it('does not throw on destroy', async () => {
await player.load('test:sintel_compiled');
video.play();
await waitUntilPlayheadReaches(eventManager, video, 1, 10);
await player.unload();
// Before we fixed #1187, the call to destroy() on textDisplayer was
// renamed in the compiled version and could not be called.
expect(textDisplayer.destroySpy).toHaveBeenCalled();
});
});
describe('TextAndRoles', () => {
// Regression Test. Makes sure that the language and role fields have been
// properly exported from the player.
it('exports language and roles fields', async () => {
await player.load('test:sintel_compiled');
const languagesAndRoles = player.getTextLanguagesAndRoles();
expect(languagesAndRoles.length).toBeTruthy();
for (const languageAndRole of languagesAndRoles) {
expect(languageAndRole.language).not.toBeUndefined();
expect(languageAndRole.role).not.toBeUndefined();
}
});
});
describe('streaming event', () => {
// Calling switch early during load() caused a failed assertion in Player
// and the track selection was ignored. Because this bug involved
// interactions between Player and StreamingEngine, it is an integration
// test and not a unit test.
// https://github.com/google/shaka-player/issues/1119
it('allows early selection of specific tracks', async () => {
/** @type {!jasmine.Spy} */
const streamingListener = jasmine.createSpy('listener');
// Because this is an issue with failed assertions, destroy the existing
// player from the compiled version, and create a new one using the
// uncompiled version. Then we will get assertions.
eventManager.unlisten(player, 'error');
await player.destroy();
player = new shaka.Player(video);
player.configure({abr: {enabled: false}});
eventManager.listen(player, 'error', Util.spyFunc(onErrorSpy));
// When 'streaming' fires, select the first track explicitly.
player.addEventListener('streaming', Util.spyFunc(streamingListener));
streamingListener.and.callFake(() => {
const tracks = player.getVariantTracks();
player.selectVariantTrack(tracks[0]);
});
// Now load the content.
await player.load('test:sintel');
// When the bug triggers, we fail assertions in Player.
// Make sure the listener was triggered, so that it could trigger the
// code path in this bug.
expect(streamingListener).toHaveBeenCalled();
});
// After fixing the issue above, calling switch early during a second load()
// caused a failed assertion in StreamingEngine, because we did not reset
// switchingPeriods_ in Player. Because this bug involved interactions
// between Player and StreamingEngine, it is an integration test and not a
// unit test.
// https://github.com/google/shaka-player/issues/1119
it('allows selection of tracks in subsequent loads', async () => {
/** @type {!jasmine.Spy} */
const streamingListener = jasmine.createSpy('listener');
// Because this is an issue with failed assertions, destroy the existing
// player from the compiled version, and create a new one using the
// uncompiled version. Then we will get assertions.
eventManager.unlisten(player, 'error');
await player.destroy();
player = new shaka.Player(video);
player.configure({abr: {enabled: false}});
eventManager.listen(player, 'error', Util.spyFunc(onErrorSpy));
// This bug only triggers when you do this on the second load.
// So we load one piece of content, then set up the streaming listener
// to change tracks, then we load a second piece of content.
await player.load('test:sintel');
// Give StreamingEngine time to complete all setup and to call back into
// the Player with canSwitch_. If you move on too quickly to the next
// load(), the bug does not reproduce.
await shaka.test.Util.delay(1);
player.addEventListener('streaming', Util.spyFunc(streamingListener));
streamingListener.and.callFake(() => {
const track = player.getVariantTracks()[0];
player.selectVariantTrack(track);
});
// Now load again to trigger the failed assertion.
await player.load('test:sintel');
// When the bug triggers, we fail assertions in StreamingEngine.
// So just make sure the listener was triggered, so that it could
// trigger the code path in this bug.
expect(streamingListener).toHaveBeenCalled();
});
});
describe('tracks', () => {
// This is a regression test for b/138941217, in which tracks briefly
// vanished during the loading process. On Chromecast devices, where the
// timing is very different from on desktop, this could occur such that
// there were no tracks after load() is resolved.
// This is an integration test so that we can check the behavior of the
// Player against actual platform behavior on all supported platforms.
it('remain available at every stage of loading', async () => {
let tracksFound = false;
/**
* @param {string} when When the check takes place.
*
* Will fail the test if tracks disappear after they first become
* available.
*/
const checkTracks = (when) => {
// If tracks have already been found, expect them to still be found.
const tracksNow = player.getVariantTracks().length != 0;
if (tracksFound) {
expect(tracksNow).withContext(when).toBe(true);
} else {
// If tracks are now found, they should not, at any point during
// the loading process, disappear again.
if (tracksNow) {
tracksFound = true;
}
}
shaka.log.debug(
'checkTracks', when,
'tracksFound=', tracksFound,
'tracksNow=', tracksNow);
};
/** @param {Event} event */
const checkOnEvent = (event) => {
checkTracks(event.type + ' event');
};
// On each of these events, we will notice when tracks first appear, and
// verify that they never disappear at any point in the loading sequence.
eventManager.listen(video, 'canplay', checkOnEvent);
eventManager.listen(video, 'canplaythrough', checkOnEvent);
eventManager.listen(video, 'durationchange', checkOnEvent);
eventManager.listen(video, 'emptied', checkOnEvent);
eventManager.listen(video, 'loadeddata', checkOnEvent);
eventManager.listen(video, 'loadedmetadata', checkOnEvent);
eventManager.listen(video, 'loadstart', checkOnEvent);
eventManager.listen(video, 'pause', checkOnEvent);
eventManager.listen(video, 'play', checkOnEvent);
eventManager.listen(video, 'playing', checkOnEvent);
eventManager.listen(video, 'seeked', checkOnEvent);
eventManager.listen(video, 'seeking', checkOnEvent);
eventManager.listen(video, 'stalled', checkOnEvent);
eventManager.listen(video, 'waiting', checkOnEvent);
eventManager.listen(player, 'trackschanged', checkOnEvent);
const waiter = (new shaka.test.Waiter(eventManager)).timeoutAfter(10);
const canPlayThrough = waiter.waitForEvent(video, 'canplaythrough');
// Important: use a stream that starts somewhere other than zero, so that
// the video element's time is initially different from the start time of
// playback, and there is no content at time zero.
await player.load('test:sintel_start_at_3_compiled', 5);
shaka.log.debug('load resolved');
// When load is resolved(), tracks should definitely exist.
expect(tracksFound).toBe(true);
// Let the test keep running until we can play through. In the original
// bug, tracks would disappear _after_ load() on some platforms.
await canPlayThrough;
});
});
});
// TODO(vaage): Try to group the stat tests together.
describe('Player Stats', () => {
let player;
// Destroy the player in |afterEach| so that it will be destroyed
// regardless of if the test succeeded or failed.
afterEach(async () => {
await player.destroy();
});
// Regression test for Issue #968 where trying to get the stats before
// calling load would fail because not all components had been initialized.
it('can get stats before loading content', () => {
// We are opting not to initialize the player with a video element so that
// it is in the least loaded state possible.
player = new shaka.Player();
const stats = player.getStats();
expect(stats).toBeTruthy();
});
});
// This test suite checks that we can interrupt manifest parsing using other
// methods. This ensures that if someone accidentally loads a bad uri, they
// don't need to wait for a time-out before being able to load a good uri.
//
// TODO: Any call to |load|, |attach|, etc. should abort manifest retries.
// Add the missing tests for |load| and |attach|.
describe('Player Manifest Retries', () => {
const interruptedError = shaka.test.Util.jasmineError(new shaka.util.Error(
shaka.util.Error.Severity.CRITICAL, shaka.util.Error.Category.PLAYER,
shaka.util.Error.Code.LOAD_INTERRUPTED));
/** @type {!HTMLVideoElement} */
let video;
/** @type {shaka.Player} */
let player;
/** @type {!jasmine.Spy} */
let stateChangeSpy;
beforeAll(() => {
video = shaka.util.Dom.createVideoElement();
document.body.appendChild(video);
// For these tests, we don't want any network requests to succeed. We want
// to force the networking engine to run-out of retries for our manifest
// requests.
shaka.net.NetworkingEngine.registerScheme(
'reject',
alwaysFailNetworkScheme);
});
afterAll(() => {
shaka.net.NetworkingEngine.unregisterScheme('reject');
document.body.removeChild(video);
});
beforeEach(async () => {
stateChangeSpy = jasmine.createSpy('stateChange');
player = new shaka.Player();
player.addEventListener(
'onstatechange', shaka.test.Util.spyFunc(stateChangeSpy));
await player.attach(video);
});
afterEach(async () => {
await player.destroy();
});
it('unload prevents further manifest load retries', async () => {
const loading = player.load('reject://www.foo.com/bar.mpd');
entersState('manifest-parser', () => player.unload());
await expectAsync(loading).toBeRejectedWith(interruptedError);
});
it('detach prevents further manifest load retries', async () => {
const loading = player.load('reject://www.foo.com/bar.mpd');
entersState('manifest-parser', () => player.detach());
await expectAsync(loading).toBeRejectedWith(interruptedError);
});
it('destroy prevents further manifest load retries', async () => {
const loading = player.load('reject://www.foo.com/bar.mpd');
entersState('manifest-parser', () => player.destroy());
await expectAsync(loading).toBeRejectedWith(interruptedError);
});
/**
* A networking scheme that will ways throw a recoverable error so that
* networking engine will keep retrying.
*
* @return {!shaka.util.AbortableOperation}
*/
function alwaysFailNetworkScheme() {
const error = new shaka.util.Error(
shaka.util.Error.Severity.RECOVERABLE,
shaka.util.Error.Category.NETWORK,
shaka.util.Error.Code.HTTP_ERROR);
return shaka.util.AbortableOperation.failed(error);
}
/**
* Call |doThis| when the player enters a specific state.
*
* @param {string} stateName
* @param {function()} doThis
*/
function entersState(stateName, doThis) {
stateChangeSpy.and.callFake((event) => {
if (event.state == stateName) {
doThis();
}
});
}
});
// This test suite focuses on how the player moves through the different load
// states.
describe('Player Load Path', () => {
const SMALL_MP4_CONTENT_URI = '/base/test/test/assets/small.mp4';
/** @type {!HTMLVideoElement} */
let video;
/** @type {shaka.Player} */
let player;
/** @type {!jasmine.Spy} */
let stateChangeSpy;
/** @type {!jasmine.Spy} */
let stateIdleSpy;
beforeAll(async () => {
video = shaka.util.Dom.createVideoElement();
document.body.appendChild(video);
await shaka.test.TestScheme.createManifests(shaka, '_compiled');
});
afterAll(() => {
document.body.removeChild(video);
});
beforeEach(() => {
stateChangeSpy = jasmine.createSpy('stateChange');
stateIdleSpy = jasmine.createSpy('stateIdle');
});
/**
* @param {HTMLMediaElement} attachedTo
*/
function createPlayer(attachedTo) {
player = new shaka.Player(attachedTo);
player.addEventListener(
'onstatechange',
shaka.test.Util.spyFunc(stateChangeSpy));
player.addEventListener(
'onstateidle',
shaka.test.Util.spyFunc(stateIdleSpy));
}
// Even though some test will destroy the player, we want to make sure that
// we don't allow the player to stay attached to the video element.
afterEach(async () => {
await player.destroy();
});
it('attach and initialize media source when constructed with media element',
async () => {
expect(video.src).toBeFalsy();
createPlayer(/* attachedTo= */ video);
// Wait until we enter the media source state.
await new Promise((resolve) => {
whenEnteringState('media-source', resolve);
});
expect(video.src).toBeTruthy();
});
it('does not set video.src when no video is provided', async () => {
expect(video.src).toBeFalsy();
createPlayer(/* attachedTo= */ null);
// Wait until the player has hit an idle state (no more internal loading
// actions).
await spyIsCalled(stateIdleSpy);
expect(video.src).toBeFalsy();
});
it('attach + initializeMediaSource=true will initialize media source',
async () => {
createPlayer(/* attachedTo= */ null);
expect(video.src).toBeFalsy();
await player.attach(video, /* initializeMediaSource= */ true);
expect(video.src).toBeTruthy();
});
it('attach + initializeMediaSource=false will not intialize media source',
async () => {
createPlayer(/* attachedTo= */ null);
expect(video.src).toBeFalsy();
await player.attach(video, /* initializeMediaSource= */ false);
expect(video.src).toBeFalsy();
});
it('unload + initializeMediaSource=false does not initialize media source',
async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.unload(/* initializeMediaSource= */ false);
expect(video.src).toBeFalsy();
});
it('unload + initializeMediaSource=true initializes media source',
async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.unload(/* initializeMediaSource= */ true);
expect(video.src).toBeTruthy();
});
// There was a bug when calling unload before calling load would cause
// the load to continue before the (first) unload was complete.
// https://github.com/google/shaka-player/issues/612
it('load will wait for unload to finish', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
// We are going to call |unload| and |load| right after each other. What
// we expect to see is that the player is fully unloaded before the load
// occurs.
const unload = player.unload();
const load = player.load('test:sintel');
await unload;
await load;
expect(getVisitedStates()).toEqual([
'attach',
// First call to |load|.
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
// Our call to |unload| would have started the transition to
// "unloaded", but since we called |load| right away, the transition
// to "unloaded" was most likely done by the call to |load|.
'unload',
'attach',
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
]);
});
it('load and unload can be called multiple times', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.unload();
await player.load('test:sintel');
await player.unload();
expect(getVisitedStates()).toEqual([
'attach',
'media-source',
// Load and unload 1
'manifest-parser',
'manifest',
'drm-engine',
'load',
'unload',
'attach',
'media-source',
// Load and unload 2
'manifest-parser',
'manifest',
'drm-engine',
'load',
'unload',
'attach',
'media-source',
]);
});
it('load can be called multiple times', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.load('test:sintel');
await player.load('test:sintel');
expect(getVisitedStates()).toEqual([
'attach',
// Load 1
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
// Load 2
'unload',
'attach',
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
// Load 3
'unload',
'attach',
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
]);
});
it('load will interrupt load', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
const load1 = player.load('test:sintel');
const load2 = player.load('test:sintel');
// Load 1 should have been interrupted because of load 2.
await expectAsync(load1).toBeRejected();
// Load 2 should finish with no issues.
await load2;
});
it('unload will interrupt load', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
const load = player.load('test:sintel');
const unload = player.unload();
await expectAsync(load).toBeRejected();
await unload;
// We should never have gotten into the loaded state.
expect(getVisitedStates()).not.toContain('load');
});
it('destroy will interrupt load', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
const load = player.load('test:sintel');
const destroy = player.destroy();
await expectAsync(load).toBeRejected();
await destroy;
// We should never have gotten into the loaded state.
expect(getVisitedStates()).not.toContain('load');
});
// When |destroy| is called, the player should move through the unload state
// on its way to the detached state.
it('destroy will unload and then detach', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.destroy();
// We really only care about the last two elements (unload and detach),
// however the test is easier to read if we list the full chain.
expect(getVisitedStates()).toEqual([
'attach',
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
'unload',
'detach',
]);
});
// Calling |unload| multiple times should not cause any problems. Calling
// |unload| after another |unload| call should just have the player re-enter
// the state it was waiting in.
it('unloading multiple times is okay', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.unload();
await player.unload();
expect(getVisitedStates()).toEqual([
// |player.attach|
'attach',
'media-source',
// |player.load|
'manifest-parser',
'manifest',
'drm-engine',
'load',
// |player.unload| (first call)
'unload',
'attach',
'media-source',
// |player.unload| (second call)
'unload',
'attach',
'media-source',
]);
});
// When we destroy, it will allow a current unload operation to occur even
// though we are going to unload and detach as part of |destroy|.
it('destroy will not interrupt unload', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
const unload = player.unload();
const destroy = player.destroy();
await unload;
await destroy;
});
// While out tests will naturally test this (because we destroy in
// afterEach), this test will explicitly express our intentions to support
// the use-case of calling |destroy| multiple times on a player instance.
it('destroying multiple times is okay', async () => {
createPlayer(/* attachedTo= */ null);
await player.attach(video);
await player.load('test:sintel');
await player.destroy();
await player.destroy();
});
// As a regression test for Issue #1570, this checks that when we
// pre-initialize media source engine, we do not re-create the media source
// instance when loading.
it('pre-initialized media source is used when player continues loading',
async () => {
createPlayer(/* attachedTo= */ null);
// After we attach and initialize media source, we should just see
// two states in our history.
await player.attach(video, /* initializeMediaSource= */ true);
expect(getVisitedStates()).toEqual([
'attach',
'media-source',
]);
// When we load, the only change in the visited states should be that
// we added "load".
await player.load('test:sintel');
expect(getVisitedStates()).toEqual([
'attach',
'media-source',
'manifest-parser',
'manifest',
'drm-engine',
'load',
]);
});
// We want to make sure that we can interrupt the load process at key-points
// in time. After each node in the graph, we should be able to reroute and do
// something different.
//
// To test this, we test that we can successfully unload the player after each
// node after attached. We exclude the nodes before (and including) attach
// since unloading will put us back at attach (creating a infinite loop).
describe('interrupt after', () => {
/**
* Given the name of a state, tell the player to load content but unload
* when it reaches |state|. The load should be interrupted and the player
* should return to the unloaded state.
*
* @param {string} state
* @return {!Promise}
*/
async function testInterruptAfter(state) {
createPlayer(/* attachedTo= */ null);
let pendingUnload;
whenEnteringState(state, () => {
pendingUnload = player.unload(/* initMediaSource= */ false);
});
// We attach manually so that we had time to override the state change
// spy's action.
await player.attach(video);
await expectAsync(player.load('test:sintel')).toBeRejected();
// By the time that |player.load| failed, we should have started
// |player.unload|.
expect(pendingUnload).toBeTruthy();
await pendingUnload;
}
it('media source', async () => {
await testInterruptAfter('media-source');
});
it('manifest-parser', async () => {
await testInterruptAfter('manifest-parser');
});
it('manifest', async () => {
await testInterruptAfter('manifest');
});
it('drm-engine', async () => {
await testInterruptAfter('drm-engine');
});
});
describe('error handling', () => {
beforeEach(() => {
createPlayer(/* attachedTo= */ null);
});
it('returns to attach after load error', async () => {
// The easiest way we can inject an error is to fail fetching the
// manifest. To do this, we force the network request by throwing an error
// in a request filter. The specific error does not matter.
const networkingEngine = player.getNetworkingEngine();
expect(networkingEngine).toBeTruthy();
networkingEngine.registerRequestFilter(() => {
throw new shaka.util.Error(
shaka.util.Error.Severity.CRITICAL,
shaka.util.Error.Category.NETWORK,
shaka.util.Error.Code.REQUEST_FILTER_ERROR);
});
// Make the two requests one-after-another so that we don't have any idle
// time between them.
const attachRequest = player.attach(video);
const loadRequest = player.load('test:sintel');
await attachRequest;
await expectAsync(loadRequest).toBeRejected();
// Wait a couple interrupter cycles to allow the player to enter idle
// state.
const event = await spyIsCalled(stateIdleSpy);
// Since attached and loaded in the same interrupter cycle, there won't be
// any idle time until we finish failing to load. We expect to idle in
// attach.
expect(event.state).toBe('attach');
});
});
// Some platforms will not have media source support, so we want to make sure
// that the player will behave as expected when media source is missing.
describe('without media source', () => {
let mediaSource;
beforeEach(async () => {
// Remove our media source support. In order to remove it, we need to set
// it via [] notation or else closure will stop us.
mediaSource = window.MediaSource;
window['MediaSource'] = undefined;
createPlayer(/* attachTo= */ null);
await spyIsCalled(stateIdleSpy);
});
afterEach(() => {
// Restore our media source support to what it was before. If we did not
// have support before, this will do nothing.
window['MediaSource'] = mediaSource;
});
it('attaching ignores init media source flag', async () => {
// Normally the player would initialize media source after attaching to
// the media element, however since we don't support media source, it
// should stop at the attach state.
player.attach(video, /* initMediaSource= */ true);
const event = await spyIsCalled(stateIdleSpy);
expect(event.state).toBe('attach');
});
it('loading ignores media source path', async () => {
await player.attach(video, /* initMediaSource= */ false);
// Normally the player would load content like this with the media source
// path, but since we don't have media source support, it should use the
// src= path.
player.load(SMALL_MP4_CONTENT_URI);
const event = await spyIsCalled(stateIdleSpy);
expect(event.state).toBe('src-equals');
});
it('unloading ignores init media source flag', async () => {
await player.attach(video, /* initMediaSource= */ false);
await player.load(SMALL_MP4_CONTENT_URI);
// Normally the player would try to go to the media source state because
// we are saying to initialize media source after unloading, but since we
// don't have media source, it should stop at the attach state.
player.unload(/* initMediaSource= */ true);
const event = await spyIsCalled(stateIdleSpy);
expect(event.state).toBe('attach');
});
});
// We want to make sure that we can move from any state to any of our
// destination states. This means moving to a state (directly or indirectly)
// and then telling it to go to one of our destination states (e.g. attach,
// load with media source, load with src=).
describe('routing', () => {
beforeEach(async () => {
createPlayer(/* attachedTo= */ null);
await spyIsCalled(stateIdleSpy);
});
it('goes from detach to detach', async () => {
await startIn('detach');
await goTo('detach');
});
it('goes from detach to attach', async () => {
await startIn('detach');
await goTo('attach');
});
it('goes from detach to media source', async () => {
await startIn('detach');
await goTo('media-source');
});
it('goes from attach to detach', async () => {
await startIn('attach');
await goTo('detach');
});
it('goes from attach to attach', async () => {
await startIn('attach');
await goTo('attach');
});
it('goes from attach to media source', async () => {
await startIn('attach');
await goTo('media-source');
});
it('goes from attach to load', async () => {
await startIn('attach');
await goTo('load');
});
it('goes from attach to src equals', async () => {
await startIn('attach');
await goTo('src-equals');
});
it('goes from media source to detach', async () => {
await startIn('media-source');
await goTo('detach');
});
it('goes from media source to attach', async () => {
await startIn('media-source');
await goTo('attach');
});
it('goes from media source to media source', async () => {
await startIn('media-source');
await goTo('media-source');
});
it('goes from media source to load', async () => {
await startIn('media-source');
await goTo('load');
});
it('goes from media source to src equals', async () => {
await startIn('media-source');
await goTo('src-equals');
});
it('goes from load to detach', async () => {
await startIn('load');
await goTo('detach');
});
it('goes from load to attach', async () => {
await startIn('load');
await goTo('attach');
});
it('goes from load to media source', async () => {
await startIn('load');
await goTo('media-source');
});
it('goes from load to load', async () => {
await startIn('load');
await goTo('load');
});
it('goes from load to src equals', async () => {
await startIn('load');
await goTo('src-equals');
});
it('goes from src equals to detach', async () => {
await startIn('src-equals');
await goTo('detach');
});
it('goes from src equals to attach', async () => {
await startIn('src-equals');
await goTo('attach');
});
it('goes from src equals to media source', async () => {
await startIn('src-equals');
await goTo('media-source');
});
it('goes from src equals to load', async () => {
await startIn('src-equals');
await goTo('load');
});
it('goes from src equals to src equals', async () => {
await startIn('src-equals');
await goTo('src-equals');
});
it('goes from manifest parser to detach', async () => {
await passingThrough('manifest-parser', () => {
return goTo('detach');
});
});
it('goes from manifest parser to attach', async () => {
await passingThrough('manifest-parser', () => {
return goTo('attach');
});
});
it('goes from manifest parser to media source', async () => {
await passingThrough('manifest-parser', () => {
return goTo('media-source');
});
});
it('goes from manifest parser to load', async () => {
await passingThrough('manifest-parser', () => {
return goTo('load');
});
});
it('goes from manifest parser to src equals', async () => {
await passingThrough('manifest-parser', () => {
return goTo('src-equals');
});
});
it('goes from manifest to detach', async () => {
await passingThrough('manifest', () => {
return goTo('detach');
});
});
it('goes from manifest to attach', async () => {
await passingThrough('manifest', () => {
return goTo('attach');
});
});
it('goes from manifest to media source', async () => {
await passingThrough('manifest', () => {
return goTo('media-source');
});
});
it('goes from manifest to load', async () => {
await passingThrough('manifest', () => {
return goTo('load');
});
});
it('goes from manifest to src equals', async () => {
await passingThrough('manifest', () => {
return goTo('src-equals');
});
});
it('goes from drm engine to detach', async () => {
await passingThrough('drm-engine', () => {
return goTo('detach');
});
});
it('goes from drm engine to attach', async () => {
await passingThrough('drm-engine', () => {
return goTo('attach');
});
});
it('goes from drm engine to media source', async () => {
await passingThrough('drm-engine', () => {
return goTo('media-source');
});
});
it('goes from drm engine to load', async () => {
await passingThrough('drm-engine', () => {
return goTo('load');
});
});
it('goes from drm engine to src equals', async () => {
await passingThrough('drm-engine', () => {
return goTo('src-equals');
});
});
it('goes from unload to detach', async () => {
await passingThrough('unload', () => {
return goTo('detach');
});
});
it('goes from unload to attach', async () => {
await passingThrough('unload', () => {
return goTo('attach');
});
});
it('goes from unload to media source', async () => {
await passingThrough('unload', () => {
return goTo('media-source');
});
});
it('goes from unload to load', async () => {
await passingThrough('unload', () => {
return goTo('load');
});
});
it('goes from unload to src equals', async () => {
await passingThrough('unload', () => {
return goTo('src-equals');
});
});
/**
* Put the player into the specific state. This method's purpose is to make
* it easier to see when the test is assuming the starting state of the
* player.
*
* For states that require the player to be attached to a media element,
* this will ensure that |attach| is called before making the call to move
* to the specific state.
*
* @param {string} state
* @return {!Promise}
*/
async function startIn(state) {
/** @type {!Map.<string, function():!Promise>} */
const actions = new Map()
.set('detach', async () => {
await player.detach();
})
.set('attach', async () => {
await player.attach(video, /* initMediaSource= */ false);
})
.set('media-source', async () => {
await player.attach(video, /* initMediaSource= */ true);
})
.set('load', async () => {
await player.attach(video, /* initMediaSource= */ true);
await player.load('test:sintel');
})
.set('src-equals', async () => {
await player.attach(video, /* initMediaSource= */ false);
await player.load(SMALL_MP4_CONTENT_URI, 0, 'video/mp4');
});
const action = actions.get(state);
expect(action).toBeTruthy();
// Do not wait for the action to complete, our idle spy makes us wait. We
// want to know where we stop, so using the idle spy is more accurate in
// this situation.
action();
// Make sure that the player stops in the state that we asked it go to.
const event = await spyIsCalled(stateIdleSpy);
expect(event.state).toBe(state);
}
/**
* Some states are intermediaries, making it impossible to "start" in them.
* Instead this method calls |doThis| when we are passing through the state.
* The goal of this method is to make it possible to test routing when the
* current route is interrupted to go somewhere.
*
* @param {string} state
* @param {function():!Promise} doThis
* @return {!Promise}
*/
async function passingThrough(state, doThis) {
/** @type {!Set.<string>} */
const preLoadStates = new Set([
'manifest-parser',
'manifest',
'drm-engine',
]);
/** @type {!Set.<string>} */
const postLoadStates = new Set([
'unload',
]);
// Only a subset of the possible states are actually intermediary states.
const validState = preLoadStates.has(state) || postLoadStates.has(state);
expect(validState).toBeTruthy();
// We don't await the last action because it should not finish, however we
// need to handle the failure or else Jasmine will fail with "Unhandled
// rejection".
if (preLoadStates.has(state)) {
await player.attach(video);
player.load('test:sintel').catch(() => {});
} else {
await player.attach(video);
await player.load('test:sintel');
player.unload().catch(() => {});
}
return new Promise((resolve, reject) => {
let called = false;
whenEnteringState(state, () => {
// Make sure we don't execute more than once per promise.
if (called) {
return;
}
called = true;
// We need to call doThis in-sync with entering the state so that it
// can start in the same interpreter cycle. If we did not do this, the
// player could have changed states before |doThis| was called.
doThis().then(resolve, reject);
});
});
}
/**
* Go to a specific state. This does not ensure the current state before
* starting the state change.
*
* @param {string} state
* @return {!Promise}
*/
async function goTo(state) {
/** @type {!Map.<string, function():!Promise>} */
const actions = new Map()
.set('detach', () => {
return player.detach();
})
.set('attach', () => {
return player.attach(video, /* initMediaSource= */ false);
})
.set('media-source', () => {
return player.attach(video, /* initMediaSource= */ true);
})
.set('load', () => {
return player.load('test:sintel');
})
.set('src-equals', () => {
return player.load(SMALL_MP4_CONTENT_URI, 0, 'video/mp4');
});
const action = actions.get(state);
expect(action).toBeTruthy();
// Do not wait for the action to complete, our idle spy make us wait. We
// want to know where we stop, so using the idle spy is more accurate in
// this situation.
action();
const event = await spyIsCalled(stateIdleSpy);
expect(event.state).toBe(state);
}
});
/**
* Get a list of all the states that the walker went through after
* |beforeEach| finished.
*
* @return {!Array.<string>}
*/
function getVisitedStates() {
const states = [];
for (const call of stateChangeSpy.calls.allArgs()) {
states.push(call[0].state);
}
return states;
}
/**
* Overwrite our |stateChangeSpy| so that it will do |doThis| when we
* enter |state|. |doThis| will be executed synchronously to ensure that
* it is done before the walker does its next action.
*
* @param {string} state
* @param {function()} doThis
*/
function whenEnteringState(state, doThis) {
stateChangeSpy.and.callFake((event) => {
if (event.state == state) {
doThis();
}
});
}
/**
* Wrap a spy in a promise so that it will resolve when the spy is called.
*
* @param {!jasmine.Spy} spy
* @return {!Promise}
*/
function spyIsCalled(spy) {
return new Promise((resolve) => {
spy.and.callFake(resolve);
});
}
});