Files
shaka-player/test/ui/ui_unit.js
T
Jacob Trimble c0e7a9b62a Use callbacks for ManifestGenerator.
This allows us to avoid suppressing the indentation rules and ensures
we have correct indentation.  It also makes it harder to make mistakes
since the variables are only accessible within the callback and you
can't accidentally contaminate another object with an incorrect call.

Closes #1692

Change-Id: Ic38b5cd57a2587dfc8c115ba782656c15565b655
2019-09-04 22:51:12 +00:00

599 lines
20 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('UI', () => {
const UiUtils = shaka.test.UiUtils;
const Util = shaka.test.Util;
const returnManifest = (manifest) =>
Util.factoryReturns(new shaka.test.FakeManifestParser(manifest));
/** @type {shaka.Player} */
let player;
/** @type {!Element} */
let cssLink;
beforeAll(async () => {
// Add css file
cssLink = document.createElement('link');
await UiUtils.setupCSS(cssLink);
});
afterEach(async () => {
await UiUtils.cleanupUI();
});
afterAll(() => {
document.head.removeChild(cssLink);
});
describe('constructed through API', () => {
/** @type {!HTMLElement} */
let videoContainer;
/** @type {!HTMLVideoElement} */
let video;
beforeEach(() => {
videoContainer =
/** @type {!HTMLElement} */ (document.createElement('div'));
document.body.appendChild(videoContainer);
video = shaka.util.Dom.createVideoElement();
videoContainer.appendChild(video);
UiUtils.createUIThroughAPI(videoContainer, video);
});
it('has all the basic elements', () => {
checkBasicUIElements(videoContainer);
});
});
describe('constructed through DOM auto-setup', () => {
describe('set up with one container', () => {
/** @type {!HTMLElement} */
let container;
beforeEach(async () => {
container =
/** @type {!HTMLElement} */ (document.createElement('div'));
document.body.appendChild(container);
await UiUtils.createUIThroughDOMAutoSetup([container], /* videos */ []);
});
it('has all the basic elements', () => {
checkBasicUIElements(container);
});
});
describe('set up with several containers', () => {
/** @type {!HTMLElement} */
let container1;
/** @type {!HTMLElement} */
let container2;
beforeEach(async () => {
container1 =
/** @type {!HTMLElement} */ (document.createElement('div'));
document.body.appendChild(container1);
container2 =
/** @type {!HTMLElement} */ (document.createElement('div'));
document.body.appendChild(container2);
await UiUtils.createUIThroughDOMAutoSetup([container1, container2],
/* videos */ []);
});
it('has all the basic elements', () => {
checkBasicUIElements(container1);
checkBasicUIElements(container2);
});
});
describe('set up with one video', () => {
/** @type {!HTMLVideoElement} */
let video;
beforeEach(async () => {
video = shaka.util.Dom.createVideoElement();
document.body.appendChild(video);
await UiUtils.createUIThroughDOMAutoSetup(/* containers */ [], [video]);
});
it('has all the basic elements', () => {
checkBasicUIElements(
/** @type {!HTMLVideoElement} */ (video.parentElement));
});
});
describe('set up with several videos', () => {
/** @type {!Array.<!HTMLVideoElement>} */
const videos = [];
beforeEach(async () => {
// Four is just a random number I (ismena) came up with to test a
// multi-video use case. It could be replaces with any other
// (reasonable) number.
for (const _ of shaka.util.Iterables.range(4)) {
shaka.util.Functional.ignored(_);
const video = /** @type {!HTMLVideoElement} */
(document.createElement('video'));
document.body.appendChild(video);
videos.push(video);
}
await UiUtils.createUIThroughDOMAutoSetup(/* containers */ [], videos);
});
it('has all the basic elements', () => {
for (const video of videos) {
checkBasicUIElements(
/** @type {!HTMLVideoElement} */ (video.parentElement));
}
});
});
describe('set up with a video and a container', () => {
/** @type {!HTMLElement} */
let container;
/** @type {!HTMLVideoElement} */
let video;
beforeEach(async () => {
container =
/** @type {!HTMLElement} */ (document.createElement('div'));
document.body.appendChild(container);
video = shaka.util.Dom.createVideoElement();
container.appendChild(video);
await UiUtils.createUIThroughDOMAutoSetup([container], [video]);
});
it('has all the basic elements', () => {
checkBasicUIElements(container);
});
});
});
describe('controls', () => {
/** @type {!HTMLElement} */
let videoContainer;
/** @type {!HTMLVideoElement} */
let video;
beforeEach(() => {
videoContainer =
/** @type {!HTMLElement} */ (document.createElement('div'));
document.body.appendChild(videoContainer);
video = shaka.util.Dom.createVideoElement();
videoContainer.appendChild(video);
});
it('goes into fullscreen on double click', async () => {
const config = {
controlPanelElements: [
'overflow_menu',
],
overflowMenuButtons: [
'quality',
],
};
const ui = UiUtils.createUIThroughAPI(videoContainer, video, config);
const controls = ui.getControls();
const spy = spyOn(controls, 'toggleFullScreen');
const controlsContainer =
videoContainer.querySelector('.shaka-controls-container');
UiUtils.simulateEvent(controlsContainer, 'dblclick');
await Util.shortDelay();
expect(spy).toHaveBeenCalledTimes(1);
});
describe('all the controls', () => {
/** @type {!HTMLElement} */
let controlsContainer;
beforeEach(() => {
const ui = UiUtils.createUIThroughAPI(videoContainer, video);
player = ui.getControls().getLocalPlayer();
const controlsContainers =
videoContainer.getElementsByClassName('shaka-controls-container');
expect(controlsContainers.length).toBe(1);
controlsContainer = /** @type {!HTMLElement} */ (controlsContainers[0]);
});
it('stay visible if overflow menuButton is open', () => {
const overflowMenus =
videoContainer.getElementsByClassName('shaka-overflow-menu');
expect(overflowMenus.length).toBe(1);
const overflowMenu = /** @type {!HTMLElement} */ (overflowMenus[0]);
const overflowMenuButtons =
videoContainer.getElementsByClassName('shaka-overflow-menu-button');
expect(overflowMenuButtons.length).toBe(1);
const overflowMenuButton = overflowMenuButtons[0];
overflowMenuButton.click();
expect(overflowMenu.style.display).not.toBe('none');
expect(controlsContainer.style.display).not.toBe('none');
});
});
describe('overflow menu', () => {
/** @type {!HTMLElement} */
let overflowMenu;
beforeEach(() => {
const config = {
controlPanelElements: [
'overflow_menu',
],
};
const ui = UiUtils.createUIThroughAPI(videoContainer, video, config);
player = ui.getControls().getLocalPlayer();
const overflowMenus =
videoContainer.getElementsByClassName('shaka-overflow-menu');
expect(overflowMenus.length).toBe(1);
overflowMenu = /** @type {!HTMLElement} */ (overflowMenus[0]);
});
it('has default buttons', () => {
UiUtils.confirmElementFound(overflowMenu, 'shaka-caption-button');
UiUtils.confirmElementFound(overflowMenu, 'shaka-resolution-button');
UiUtils.confirmElementFound(overflowMenu, 'shaka-language-button');
UiUtils.confirmElementFound(overflowMenu, 'shaka-pip-button');
});
it('becomes visible if overflowMenuButton was clicked', () => {
let display = window.getComputedStyle(overflowMenu, null).display;
expect(display).toBe('none');
const overflowMenuButtons =
videoContainer.getElementsByClassName('shaka-overflow-menu-button');
expect(overflowMenuButtons.length).toBe(1);
const overflowMenuButton = overflowMenuButtons[0];
overflowMenuButton.click();
display = overflowMenu.style.display;
expect(display).not.toBe('none');
});
it('allows picture-in-picture only when the content has video',
async () => {
// Load fake content that contains only audio.
const manifest =
shaka.test.ManifestGenerator.generate((manifest) => {
manifest.addPeriod(/* startTime= */ 0, (period) => {
period.addVariant(/* id= */ 0, (variant) => {
variant.addAudio(/* id= */ 1);
});
});
});
await player.load(
/* uri= */ 'fake', /* startTime= */ 0,
returnManifest(manifest));
const pipButtons =
videoContainer.getElementsByClassName('shaka-pip-button');
expect(pipButtons.length).toBe(1);
const pipButton = pipButtons[0];
// The picture-in-picture button should not be shown when the
// content only has audio.
expect(pipButton.classList.contains('shaka-hidden')).toBe(true);
// The picture-in-picture window should not be open when the content
// only has audio.
expect(document.pictureInPictureElement).toBeFalsy();
});
it('is accessible', () => {
for (const button of overflowMenu.childNodes) {
expect(/** @type {!HTMLElement} */ (button)
.hasAttribute('aria-label')).toBe(true);
}
});
});
describe('controls-button-panel', () => {
/** @type {!HTMLElement} */
let controlsButtonPanel;
it('has default elements', () => {
UiUtils.createUIThroughAPI(videoContainer, video);
const controlsButtonPanels = videoContainer.getElementsByClassName(
'shaka-controls-button-panel');
expect(controlsButtonPanels.length).toBe(1);
controlsButtonPanel =
/** @type {!HTMLElement} */ (controlsButtonPanels[0]);
UiUtils.confirmElementFound(controlsButtonPanel, 'shaka-current-time');
UiUtils.confirmElementFound(controlsButtonPanel, 'shaka-mute-button');
UiUtils.confirmElementFound(controlsButtonPanel, 'shaka-volume-bar');
UiUtils.confirmElementFound(controlsButtonPanel,
'shaka-fullscreen-button');
UiUtils.confirmElementFound(controlsButtonPanel,
'shaka-overflow-menu-button');
});
it('is accessible', () => {
function confirmAriaLabel(className) {
const elements =
controlsButtonPanel.getElementsByClassName(className);
expect(elements.length).toBe(1);
expect(elements[0].hasAttribute('aria-label')).toBe(true);
}
const config = {
controlPanelElements: [
'mute',
'volume',
'fullscreen',
'overflow_menu',
'fast_forward',
'rewind',
],
};
UiUtils.createUIThroughAPI(videoContainer, video, config);
const controlsButtonPanels = videoContainer.getElementsByClassName(
'shaka-controls-button-panel');
expect(controlsButtonPanels.length).toBe(1);
controlsButtonPanel =
/** @type {!HTMLElement} */ (controlsButtonPanels[0]);
confirmAriaLabel('shaka-mute-button');
confirmAriaLabel('shaka-volume-bar');
confirmAriaLabel('shaka-fullscreen-button');
confirmAriaLabel('shaka-overflow-menu-button');
confirmAriaLabel('shaka-fast-forward-button');
confirmAriaLabel('shaka-rewind-button');
});
});
describe('resolutions menu', () => {
/** @type {!HTMLElement} */
let resolutionsMenu;
/** @type {shaka.ui.Controls} */
let controls;
beforeEach(() => {
const config = {
controlPanelElements: [
'overflow_menu',
],
overflowMenuButtons: [
'quality',
],
};
const ui = UiUtils.createUIThroughAPI(videoContainer, video, config);
controls = ui.getControls();
player = controls.getLocalPlayer();
const resolutionsMenus =
videoContainer.getElementsByClassName('shaka-resolutions');
expect(resolutionsMenus.length).toBe(1);
resolutionsMenu = /** @type {!HTMLElement} */ (resolutionsMenus[0]);
});
it('becomes visible if resolutionButton was clicked', () => {
let display = window.getComputedStyle(resolutionsMenu, null).display;
expect(display).toBe('none');
const resolutionButtons =
videoContainer.getElementsByClassName('shaka-resolution-button');
expect(resolutionButtons.length).toBe(1);
const resolutionButton = resolutionButtons[0];
resolutionButton.click();
display = resolutionsMenu.style.display;
expect(display).not.toBe('none');
});
it('clears the buffer when changing resolutions', async () => {
// Load fake content that has more than one quality level.
const manifest = shaka.test.ManifestGenerator.generate((manifest) => {
manifest.addPeriod(0, (period) => {
period.addVariant(0, (variant) => {
variant.addVideo(1, (stream) => {
stream.size(320, 240);
});
variant.addVideo(2, (stream) => {
stream.size(640, 480);
});
});
});
});
await player.load(
/* uri= */ 'fake', /* startTime= */ 0, returnManifest(manifest));
const selectVariantTrack = spyOn(player, 'selectVariantTrack');
// There should be at least one explicit quality button.
const qualityButton =
videoContainer.querySelectorAll('button.explicit-resolution')[0];
expect(qualityButton).toBeDefined();
// Clicking this should select a track and clear the buffer.
expect(selectVariantTrack).not.toHaveBeenCalled();
qualityButton.click();
// The second argument is "clearBuffer", and should be true.
expect(selectVariantTrack).toHaveBeenCalledWith(
jasmine.any(Object), true);
});
it('displays resolutions based on current stream', async () => {
// A manifest with different resolutions at different
// languages/channel-counts to test the current resolution list is
// filtered.
const manifest = shaka.test.ManifestGenerator.generate((manifest) => {
manifest.addPeriod(0, (period) => {
period.addVariant(0, (variant) => {
variant.primary = true;
variant.language = 'en';
variant.addVideo(1, (stream) => {
stream.size(320, 240);
});
variant.addAudio(3, (stream) => {
stream.channelsCount = 2;
});
});
period.addVariant(4, (variant) => {
variant.language = 'en';
variant.addVideo(5, (stream) => {
stream.size(640, 480);
});
variant.addAudio(6, (stream) => {
stream.channelsCount = 2;
});
});
period.addVariant(7, (variant) => { // Duplicate with 4
variant.language = 'en';
variant.addVideo(8, (stream) => {
stream.size(640, 480);
});
variant.addAudio(9, (stream) => {
stream.channelsCount = 2;
});
});
period.addVariant(10, (variant) => {
variant.language = 'en';
variant.addVideo(11, (stream) => {
stream.size(1280, 720);
});
variant.addAudio(12, (stream) => {
stream.channelsCount = 1;
});
});
period.addVariant(13, (variant) => {
variant.language = 'es';
variant.addVideo(14, (stream) => {
stream.size(960, 540);
});
variant.addAudio(15, (stream) => {
stream.channelsCount = 2;
});
});
period.addVariant(16, (variant) => {
variant.language = 'fr';
variant.addVideo(17, (stream) => {
stream.size(256, 144);
});
variant.addAudio(18, (stream) => {
stream.channelsCount = 2;
});
});
});
});
const getResolutions = () => {
const resolutionButtons = videoContainer.querySelectorAll(
'button.explicit-resolution > span');
return Array.from(resolutionButtons)
.map((btn) => btn.innerText)
.sort();
};
await player.load(
/* uri= */ 'fake', /* startTime= */ 0, returnManifest(manifest));
player.configure('abr.enabled', false);
const tracks = player.getVariantTracks();
const en2 =
tracks.find((t) => t.language == 'en' && t.channelsCount == 2);
const en1 =
tracks.find((t) => t.language == 'en' && t.channelsCount == 1);
const es = tracks.find((t) => t.language == 'es');
// There are 3 variants with English 2-channel, but one is a duplicate
// and shouldn't appear in the list.
goog.asserts.assert(en2, 'Unable to find tracks');
player.selectVariantTrack(en2, true);
await updateResolutionMenu();
expect(getResolutions()).toEqual(['240p', '480p']);
// There is 1 variant with English 1-channel.
goog.asserts.assert(en1, 'Unable to find tracks');
player.selectVariantTrack(en1, true);
await updateResolutionMenu();
expect(getResolutions()).toEqual(['720p']);
// There is 1 variant with Spanish 2-channel.
goog.asserts.assert(es, 'Unable to find tracks');
player.selectVariantTrack(es, true);
await updateResolutionMenu();
expect(getResolutions()).toEqual(['540p']);
});
/**
* Use internals to update the resolution menu. Our fake manifest can
* cause problems with startup where the Player will get stuck using
* "deferred" switches, so we won't get events and the resolution menu
* won't update.
*
* @suppress {accessControls}
*/
async function updateResolutionMenu() {
await Util.shortDelay();
// TODO(#2089): We should be able to stop once we find one, but since
// there are multiple ResolutionMenu objects, we need to update all of
// them.
let found = false;
for (const elem of controls.elements_) {
if (elem instanceof shaka.ui.OverflowMenu) {
for (const child of elem.children_) {
if (child instanceof shaka.ui.ResolutionSelection) {
child.updateResolutionSelection_();
found = true;
}
}
}
}
goog.asserts.assert(found, 'Unable to find resolution menu');
}
});
});
/**
* @param {!HTMLElement} container
* @suppress {visibility}
*/
function checkBasicUIElements(container) {
const videos = container.getElementsByTagName('video');
expect(videos.length).not.toBe(0);
UiUtils.confirmElementFound(container, 'shaka-play-button-container');
UiUtils.confirmElementFound(container, 'shaka-play-button');
UiUtils.confirmElementFound(container, 'shaka-spinner-svg');
UiUtils.confirmElementFound(container, 'shaka-overflow-menu');
UiUtils.confirmElementFound(container, 'shaka-controls-button-panel');
UiUtils.confirmElementFound(container, 'shaka-seek-bar');
}
});