rx-player/src/utils/__tests__/byte_parsing.test.ts

Canal+ HTML5 Video Player

import { describe, it, expect } from "vitest";
import * as byteUtils from "../byte_parsing";

describe("utils - byte parsing", () => {
  describe("concat", () => {
    it("should return an empty Uint8Array if no arguments are provided", () => {
      const res = byteUtils.concat();
      expect(res).toBeInstanceOf(Uint8Array);
      expect(res).toHaveLength(0);
    });

    it("should concatenate multiple Uint8Array in a single Uint8Array", () => {
      const arr1 = new Uint8Array([54, 255]);
      const arr2 = new Uint8Array([258, 54]);
      const arr3 = new Uint8Array([]);
      const arr4 = new Uint8Array([34, 87]);
      const expected = new Uint8Array([54, 255, 258, 54, 34, 87]);
      const res = byteUtils.concat(arr1, arr2, arr3, arr4);
      expect(res).toHaveLength(arr1.length + arr2.length + arr3.length + arr4.length);
      res.forEach((x, i) => expect(x).toBe(expected[i]));
    });

    it("should consider number arguments as 0-filled offests", () => {
      const arr1 = new Uint8Array([54, 255]);
      const arr2 = new Uint8Array([258, 54]);
      const arr3 = new Uint8Array([34, 87]);
      const expected = new Uint8Array(
        [54, 255, 0, 0, 258, 54, 34, 87, 0].map((e) => e & 0xff),
      );
      const res = byteUtils.concat(0, arr1, 2, arr2, arr3, 1);
      expect(res).toHaveLength(arr1.length + arr2.length + arr3.length + 0 + 2 + 1);
      res.forEach((x, i) => expect(x).toBe(expected[i]));
    });

    it("should return only 0-filled arrays if only numbers are provided", () => {
      const res = byteUtils.concat(0);
      expect(res).toHaveLength(0);

      const res2 = byteUtils.concat(10, 2);
      expect(res2).toHaveLength(10 + 2);
      res2.forEach((x) => expect(x).toBe(0));
    });
  });

  describe("be2toi", () => {
    it("should return 0 for an empty TypedArray", () => {
      expect(byteUtils.be2toi(new Uint8Array(0), 0)).toBe(0);
    });

    it("should return 0 for an out-of-bound offset", () => {
      const arr = new Uint8Array([255, 255, 1, 8]);
      expect(byteUtils.be2toi(arr, -45)).toBe(0);
      expect(byteUtils.be2toi(arr, 45)).toBe(0);
    });

    it("should return the number value for the 2 first elements of an Uint8Array from the offset", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([255, 255, 1, 8]);
      const expected = [65535, 65281, 264, 2048];
      expect(byteUtils.be2toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.be2toi(arr, 1)).toBe(expected[1]);
      expect(byteUtils.be2toi(arr, 2)).toBe(expected[2]);
      expect(byteUtils.be2toi(arr, 3)).toBe(expected[3]);
    });
  });

  describe("be3toi", () => {
    it("should return the number value for the 2 first elements of an Uint8Array from the offset", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([255, 255, 255, 1, 8, 17]);
      const expected = [16777215, 16776961, 16711944, 67601];
      expect(byteUtils.be3toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.be3toi(arr, 1)).toBe(expected[1]);
      expect(byteUtils.be3toi(arr, 2)).toBe(expected[2]);
      expect(byteUtils.be3toi(arr, 3)).toBe(expected[3]);
    });
  });

  describe("be4toi", () => {
    it("should return the number value for the 4 first elements of an Uint8Array from the offset", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([0, 0, 0, 1, 255, 3, 2]);
      const expected = [1, 511, 130819, 33489666];
      expect(byteUtils.be4toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.be4toi(arr, 1)).toBe(expected[1]);
      expect(byteUtils.be4toi(arr, 2)).toBe(expected[2]);
      expect(byteUtils.be4toi(arr, 3)).toBe(expected[3]);
    });
  });

  describe("be8toi", () => {
    it("should return the number value for the 8 first elements of an Uint8Array from the offset", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 255, 0, 255, 0, 255, 0]); // I can't set the top-most byte or I
      // go over MAX_SAFE_INTEGER
      const expected = [1, 280379743338240];
      expect(byteUtils.be8toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.be8toi(arr, 8)).toBe(expected[1]);
    });
  });

  describe("le2toi", () => {
    it("should return 0 for an empty TypedArray", () => {
      expect(byteUtils.le2toi(new Uint8Array(0), 0)).toBe(0);
    });

    it("should return 0 for an out-of-bound offset", () => {
      const arr = new Uint8Array([255, 255, 1, 8]);
      expect(byteUtils.le2toi(arr, -45)).toBe(0);
      expect(byteUtils.le2toi(arr, 45)).toBe(0);
    });

    it("should return the number value for the 2 first elements of an Uint8Array from the offset, little-endian style", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([8, 1, 255, 255]);
      const expected = [264, 65281, 65535, 255];
      expect(byteUtils.le2toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.le2toi(arr, 1)).toBe(expected[1]);
      expect(byteUtils.le2toi(arr, 2)).toBe(expected[2]);
      expect(byteUtils.le2toi(arr, 3)).toBe(expected[3]);
    });
  });

  describe("le4toi", () => {
    it("should return the number value for the 4 first elements of an Uint8Array from the offset, little-endian style", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([2, 3, 255, 1, 0, 0, 0]);
      const expected = [33489666, 130819, 511, 1];
      expect(byteUtils.le4toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.le4toi(arr, 1)).toBe(expected[1]);
      expect(byteUtils.le4toi(arr, 2)).toBe(expected[2]);
      expect(byteUtils.le4toi(arr, 3)).toBe(expected[3]);
    });
  });

  describe("le8toi", () => {
    it("should return the number value for the 8 first elements of an Uint8Array from the offset, little-endian style", () => {
      // as the test would be equivalent to re-implement the function, I
      // directly take the expected result (number to hex and hex to
      // number) and compare
      const arr = new Uint8Array([1, 0, 0, 0, 0, 0, 0, 0, 0, 255, 0, 255, 0, 255, 0, 0]); // I can't set the top-most byte or I
      // go over MAX_SAFE_INTEGER
      const expected = [1, 280379743338240];
      expect(byteUtils.le8toi(arr, 0)).toBe(expected[0]);
      expect(byteUtils.le8toi(arr, 8)).toBe(expected[1]);
    });
  });

  describe("itobe2", () => {
    it("should convert the number given into two elements in a Uint8Array", () => {
      expect(byteUtils.itobe2(65535)).toEqual(new Uint8Array([255, 255]));
      expect(byteUtils.itobe2(65281)).toEqual(new Uint8Array([255, 1]));
      expect(byteUtils.itobe2(264)).toEqual(new Uint8Array([1, 8]));
    });
  });

  describe("itobe4", () => {
    it("should convert the number given into four elements in a Uint8Array", () => {
      expect(byteUtils.itobe4(1)).toEqual(new Uint8Array([0, 0, 0, 1]));
      expect(byteUtils.itobe4(511)).toEqual(new Uint8Array([0, 0, 1, 255]));
      expect(byteUtils.itobe4(130819)).toEqual(new Uint8Array([0, 1, 255, 3]));
      expect(byteUtils.itobe4(33489666)).toEqual(new Uint8Array([1, 255, 3, 2]));
    });
  });

  describe("itobe8", () => {
    it("should return the number value for the 8 first elements of an Uint8Array from the offset", () => {
      expect(byteUtils.itobe8(1)).toEqual(new Uint8Array([0, 0, 0, 0, 0, 0, 0, 1]));
      expect(byteUtils.itobe8(1237106686452549)).toEqual(
        new Uint8Array([0x00, 0x04, 0x65, 0x24, 0x58, 0x98, 0x63, 0x45]),
      );
    });
  });

  describe("itole2", () => {
    it("should return a little-endian style Uint8Array of length 2 translated from the number given", () => {
      const values = [264, 65281, 65535, 255];
      expect(byteUtils.itole2(values[0])).toEqual(new Uint8Array([8, 1]));
      expect(byteUtils.itole2(values[1])).toEqual(new Uint8Array([1, 255]));
      expect(byteUtils.itole2(values[2])).toEqual(new Uint8Array([255, 255]));
    });
  });

  describe("itole4", () => {
    it("should return a little-endian style Uint8Array of length 4 translated from the number given", () => {
      const values = [33489666, 130819, 511, 1];
      expect(byteUtils.itole4(values[0])).toEqual(new Uint8Array([2, 3, 255, 1]));
      expect(byteUtils.itole4(values[1])).toEqual(new Uint8Array([3, 255, 1, 0]));
      expect(byteUtils.itole4(values[2])).toEqual(new Uint8Array([255, 1, 0, 0]));
      expect(byteUtils.itole4(values[3])).toEqual(new Uint8Array([1, 0, 0, 0]));
    });
  });

  describe("be4toiSigned", () => {
    it("should return 32-bit two's complement signed integer", () => {
      expect(byteUtils.be4toiSigned(new Uint8Array([255, 255, 255, 255]), 0)).toEqual(-1);
      expect(
        byteUtils.be4toiSigned(new Uint8Array([0, 0, 255, 255, 255, 255]), 2),
      ).toEqual(-1);
      expect(byteUtils.be4toiSigned(new Uint8Array([0, 0, 0, 0, 0, 0]), 2)).toEqual(0);
      expect(byteUtils.be4toiSigned(new Uint8Array([0, 0, 0, 0, 1, 0]), 2)).toEqual(256);
      expect(byteUtils.be4toiSigned(new Uint8Array([0, 0, 255, 255, 255, 0]), 2)).toEqual(
        -256,
      );
    });
  });
});