Files
shaka-player/test/util/mp4_parser_unit.js
T
Jacob Trimble 47daf49f31 Use arrow functions for callbacks.
This is an automated change to convert use of "function" functions
to arrow functions.  This doesn't change all uses of bind() that
could be converted.  This also doesn't remove all "function" functions.

Change-Id: I40ac7d086bcef947a1be083359c8fd1d4499a9c3
2019-05-09 16:40:46 +00:00

333 lines
12 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('Mp4Parser', () => {
const Util = shaka.test.Util;
let boxData;
let fullBoxData;
let boxWithChildData;
let boxWithSampleDescription;
let partialBoxWithSampleDescription;
let multipleSingleLevelBoxes;
let twoLevelBoxStructure;
beforeAll(() => {
boxData = new Uint8Array([
0x00, 0x00, 0x00, 0x0C, // size
0x62, 0x30, 0x30, 0x31, // type
0x00, 0x11, 0x22, 0x33, // payload
]).buffer;
fullBoxData = new Uint8Array([
0x00, 0x00, 0x00, 0x10, // size
0x62, 0x30, 0x30, 0x31, // type
0x01, // version
0x12, 0x34, 0x56, // flags
0x00, 0x11, 0x22, 0x33, // payload
]).buffer;
boxWithChildData = new Uint8Array([
0x00, 0x00, 0x00, 0x14, // size
0x62, 0x30, 0x30, 0x33, // type
0x00, 0x00, 0x00, 0x0C, // child [0] size
0x62, 0x30, 0x33, 0x31, // child [0] type
0x00, 0x11, 0x22, 0x33, // child [0] payload
0x00, 0x00, 0x00, 0x0C, // child [1] size
0x62, 0x30, 0x33, 0x32, // child [1] type
0x44, 0x55, 0x66, 0x77, // child [1] payload
]).buffer;
boxWithSampleDescription = new Uint8Array([
0x00, 0x00, 0x00, 0x24, // size
0x62, 0x30, 0x30, 0x33, // type
0x00, 0x00, 0x00, 0x02, // number of chidren
0x00, 0x00, 0x00, 0x0C, // child [0] size
0x62, 0x30, 0x33, 0x32, // child [0] type
0x00, 0x11, 0x22, 0x33, // child [0] payload
0x00, 0x00, 0x00, 0x0C, // child [1] size
0x62, 0x30, 0x33, 0x33, // child [1] type
0x44, 0x55, 0x66, 0x77, // child [1] payload
]).buffer;
partialBoxWithSampleDescription = new Uint8Array([
0x00, 0x00, 0x00, 0x24, // size
0x62, 0x30, 0x30, 0x33, // type
0x00, 0x00, 0x00, 0x02, // number of chidren
0x00, 0x00, 0x00, 0x0C, // child [0] size
0x62, 0x30, 0x33, 0x32, // child [0] type
0x00, 0x11, 0x22, 0x33, // child [0] payload
// Omit child [1]
]).buffer;
multipleSingleLevelBoxes = new Uint8Array([
0x00, 0x00, 0x00, 0x0C, // box [0] size
0x62, 0x30, 0x30, 0x31, // box [0] type
0x00, 0x11, 0x22, 0x33, // box [0] payload
0x00, 0x00, 0x00, 0x0C, // box [1] size
0x62, 0x30, 0x30, 0x32, // box [1] type
0x00, 0x11, 0x22, 0x33, // box [1] payload
0x00, 0x00, 0x00, 0x0C, // box [2] size
0x62, 0x30, 0x30, 0x33, // box [2] type
0x00, 0x11, 0x22, 0x33, // box [2] payload
0x00, 0x00, 0x00, 0x0C, // box [3] size
0x62, 0x30, 0x30, 0x34, // box [3] type
0x00, 0x11, 0x22, 0x33, // box [3] payload
]).buffer;
twoLevelBoxStructure = new Uint8Array([
0x00, 0x00, 0x00, 0x14, // box [0] size
0x62, 0x30, 0x31, 0x30, // box [0] type
0x00, 0x00, 0x00, 0x0C, // box [0] [0] size
0x00, 0x30, 0x31, 0x31, // box [0] [0] type
0x00, 0x11, 0x22, 0x33, // box [0] [0] payload
0x00, 0x00, 0x00, 0x14, // box [1] size
0x62, 0x30, 0x32, 0x30, // box [1] type
0x00, 0x00, 0x00, 0x0C, // box [1] [0] size
0x62, 0x30, 0x32, 0x31, // box [1] [0] type
0x00, 0x11, 0x22, 0x33, // box [1] [0] payload
0x00, 0x00, 0x00, 0x14, // box [2] size
0x62, 0x30, 0x33, 0x30, // box [2] type
0x00, 0x00, 0x00, 0x0C, // box [2] [0] size
0x62, 0x30, 0x33, 0x31, // box [2] [0] type
0x00, 0x11, 0x22, 0x33, // box [2] [0] payload
0x00, 0x00, 0x00, 0x14, // box [3] size
0x62, 0x30, 0x34, 0x30, // box [3] type
0x00, 0x00, 0x00, 0x0C, // box [3] [0] size
0x62, 0x30, 0x34, 0x31, // box [3] [0] type
0x00, 0x11, 0x22, 0x33, // box [3] [0] payload
]).buffer;
});
describe('headerDefinitions', () => {
it('reads box header', () => {
const callback = jasmine.createSpy('parser callback').and.callFake(
(box) => {
expect(box.size).toEqual(12);
expect(box.version).toEqual(null);
expect(box.flags).toEqual(null);
});
new shaka.util.Mp4Parser()
.box('b001', Util.spyFunc(callback)).parse(boxData);
expect(callback).toHaveBeenCalled();
});
it('reads full box header', () => {
const callback = jasmine.createSpy('parser callback').and.callFake(
(box) => {
expect(box.size).toEqual(16);
expect(box.version).toEqual(1);
expect(box.flags).toEqual(0x123456);
});
new shaka.util.Mp4Parser()
.fullBox('b001', Util.spyFunc(callback)).parse(fullBoxData);
expect(callback).toHaveBeenCalled();
});
});
describe('boxDefinitions', () => {
it('reads children definition', () => {
const parentBox = jasmine.createSpy('parent box').and.callFake(
shaka.util.Mp4Parser.children);
const childBox1 = jasmine.createSpy('child box 1').and.callFake(
(box) => {
expect(box.size).toEqual(12);
expect(box.version).toEqual(null);
expect(box.flags).toEqual(null);
});
const childBox2 = jasmine.createSpy('child box 2').and.callFake(
(box) => {
expect(box.size).toEqual(12);
expect(box.version).toEqual(null);
expect(box.flags).toEqual(null);
});
new shaka.util.Mp4Parser()
.box('b003', Util.spyFunc(parentBox))
.box('b031', Util.spyFunc(childBox1))
.box('b032', Util.spyFunc(childBox2)).parse(boxWithChildData);
expect(parentBox).toHaveBeenCalled();
expect(childBox1).toHaveBeenCalled();
expect(childBox2).toHaveBeenCalled();
});
it('stops reading children when asked to', () => {
const parentBox = jasmine.createSpy('parent box').and.callFake(
shaka.util.Mp4Parser.children);
const childBox1 = jasmine.createSpy('child box 1').and.callFake(
(box) => {
box.parser.stop();
});
const childBox2 = jasmine.createSpy('child box 2');
new shaka.util.Mp4Parser()
.box('b003', Util.spyFunc(parentBox))
.box('b031', Util.spyFunc(childBox1))
.box('b032', Util.spyFunc(childBox2)).parse(boxWithChildData);
expect(parentBox).toHaveBeenCalled();
expect(childBox1).toHaveBeenCalled();
expect(childBox2).not.toHaveBeenCalled();
});
it('reads all data definition', () => {
let payload = [];
new shaka.util.Mp4Parser()
.box('b001', shaka.util.Mp4Parser.allData(
(data) => {
payload = data;
})).parse(boxData);
expect(payload.length).toEqual(4);
expect(payload[0]).toEqual(0x00);
expect(payload[1]).toEqual(0x11);
expect(payload[2]).toEqual(0x22);
expect(payload[3]).toEqual(0x33);
});
it('reads sample description definition', () => {
const parentBox = jasmine.createSpy('parent box').and.callFake(
shaka.util.Mp4Parser.sampleDescription);
const childBox1 = jasmine.createSpy('child box 1');
const childBox2 = jasmine.createSpy('child box 2');
new shaka.util.Mp4Parser()
.box('b003', Util.spyFunc(parentBox))
.box('b032', Util.spyFunc(childBox1))
.box('b033', Util.spyFunc(childBox2)).parse(boxWithSampleDescription);
expect(parentBox).toHaveBeenCalledTimes(1);
expect(childBox1).toHaveBeenCalledTimes(1);
expect(childBox2).toHaveBeenCalledTimes(1);
});
it('stops reading sample description when asked to', () => {
const parentBox = jasmine.createSpy('parent box').and.callFake(
shaka.util.Mp4Parser.sampleDescription);
const childBox1 = jasmine.createSpy('child box 1').and.callFake(
(box) => {
box.parser.stop();
});
const childBox2 = jasmine.createSpy('child box 2');
new shaka.util.Mp4Parser()
.box('b003', Util.spyFunc(parentBox))
.box('b032', Util.spyFunc(childBox1))
.box('b033', Util.spyFunc(childBox2)).parse(boxWithSampleDescription);
expect(parentBox).toHaveBeenCalledTimes(1);
expect(childBox1).toHaveBeenCalledTimes(1);
expect(childBox2).not.toHaveBeenCalled();
});
});
describe('parsing', () => {
it('finds all top level boxes', () => {
const box1 = jasmine.createSpy('box 1');
const box2 = jasmine.createSpy('box 2');
const box3 = jasmine.createSpy('box 3');
new shaka.util.Mp4Parser()
.box('b001', Util.spyFunc(box1))
.box('b002', Util.spyFunc(box2))
.box('b003', Util.spyFunc(box3)).parse(multipleSingleLevelBoxes);
expect(box1).toHaveBeenCalled();
expect(box2).toHaveBeenCalled();
expect(box3).toHaveBeenCalled();
});
it('skips undefined top level boxes', () => {
// By leaving a single box undefined, it should not interfere
// with the other boxes (on the same level) from being read.
const box1 = jasmine.createSpy('box 1');
const box3 = jasmine.createSpy('box 3');
new shaka.util.Mp4Parser()
.box('b001', Util.spyFunc(box1))
.box('b003', Util.spyFunc(box3)).parse(multipleSingleLevelBoxes);
expect(box1).toHaveBeenCalled();
expect(box3).toHaveBeenCalled();
});
it('does not parse child boxes with undefined parent box', () => {
const box1 = jasmine.createSpy('box 1');
const box2Child = jasmine.createSpy('box 2 child');
const box3 = jasmine.createSpy('box 3');
// Listing a definition for box 2's child but not for box 2 should mean
// box 2's child is never parsed.
new shaka.util.Mp4Parser()
.box('b010', Util.spyFunc(box1))
.box('b021', Util.spyFunc(box2Child))
.box('b030', Util.spyFunc(box3)).parse(twoLevelBoxStructure);
expect(box1).toHaveBeenCalled();
expect(box2Child).not.toHaveBeenCalled();
expect(box3).toHaveBeenCalled();
});
it('can parse partial parent box and find first child', () => {
const parentBox = jasmine.createSpy('parent box').and.callFake(
shaka.util.Mp4Parser.sampleDescription);
const childBox1 = jasmine.createSpy('child box 1').and.callFake(
(box) => {
// We found what we were looking for, so stop parsing.
box.parser.stop();
});
try {
new shaka.util.Mp4Parser()
.box('b003', Util.spyFunc(parentBox))
.box('b032', Util.spyFunc(childBox1))
.parse(partialBoxWithSampleDescription, false /* partialOkay */);
fail('Should not have been able to parse!');
} catch (error) {
Util.expectToEqualError(error, new shaka.util.Error(
shaka.util.Error.Severity.CRITICAL,
shaka.util.Error.Category.MEDIA,
shaka.util.Error.Code.BUFFER_READ_OUT_OF_BOUNDS));
}
parentBox.calls.reset();
childBox1.calls.reset();
// With the partialOkay flag set to true, this should succeed.
new shaka.util.Mp4Parser()
.box('b003', Util.spyFunc(parentBox))
.box('b032', Util.spyFunc(childBox1))
.parse(partialBoxWithSampleDescription, true /* partialOkay */);
expect(parentBox).toHaveBeenCalledTimes(1);
expect(childBox1).toHaveBeenCalledTimes(1);
});
});
});