/* Copyright 2017 Mozilla Foundation * * 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. */ import { bytesToString, createPromiseCapability, createValidAbsoluteUrl, isArrayBuffer, isBool, isEmptyObj, isNum, isSameOrigin, isSpace, isString, log2, removeNullCharacters, string32, stringToBytes, stringToPDFString, } from "../../src/shared/util"; describe("util", function() { describe("bytesToString", function() { it("handles non-array arguments", function() { expect(function() { bytesToString(null); }).toThrow(new Error("Invalid argument for bytesToString")); }); it("handles array arguments with a length not exceeding the maximum", function() { expect(bytesToString(new Uint8Array([]))).toEqual(""); expect(bytesToString(new Uint8Array([102, 111, 111]))).toEqual("foo"); }); it("handles array arguments with a length exceeding the maximum", function() { const length = 10000; // Larger than MAX_ARGUMENT_COUNT = 8192. // Create an array with `length` 'a' character codes. let bytes = new Uint8Array(length); for (let i = 0; i < length; i++) { bytes[i] = "a".charCodeAt(0); } // Create a string with `length` 'a' characters. We need an array of size // `length + 1` since `join` puts the argument between the array elements. let string = Array(length + 1).join("a"); expect(bytesToString(bytes)).toEqual(string); }); }); describe("isArrayBuffer", function() { it("handles array buffer values", function() { expect(isArrayBuffer(new ArrayBuffer(0))).toEqual(true); expect(isArrayBuffer(new Uint8Array(0))).toEqual(true); }); it("handles non-array buffer values", function() { expect(isArrayBuffer("true")).toEqual(false); expect(isArrayBuffer(1)).toEqual(false); expect(isArrayBuffer(null)).toEqual(false); expect(isArrayBuffer(undefined)).toEqual(false); }); }); describe("isBool", function() { it("handles boolean values", function() { expect(isBool(true)).toEqual(true); expect(isBool(false)).toEqual(true); }); it("handles non-boolean values", function() { expect(isBool("true")).toEqual(false); expect(isBool("false")).toEqual(false); expect(isBool(1)).toEqual(false); expect(isBool(0)).toEqual(false); expect(isBool(null)).toEqual(false); expect(isBool(undefined)).toEqual(false); }); }); describe("isEmptyObj", function() { it("handles empty objects", function() { expect(isEmptyObj({})).toEqual(true); }); it("handles non-empty objects", function() { expect(isEmptyObj({ foo: "bar" })).toEqual(false); }); }); describe("isNum", function() { it("handles numeric values", function() { expect(isNum(1)).toEqual(true); expect(isNum(0)).toEqual(true); expect(isNum(-1)).toEqual(true); expect(isNum(1000000000000000000)).toEqual(true); expect(isNum(12.34)).toEqual(true); }); it("handles non-numeric values", function() { expect(isNum("true")).toEqual(false); expect(isNum(true)).toEqual(false); expect(isNum(null)).toEqual(false); expect(isNum(undefined)).toEqual(false); }); }); describe("isSpace", function() { it("handles space characters", function() { expect(isSpace(0x20)).toEqual(true); expect(isSpace(0x09)).toEqual(true); expect(isSpace(0x0d)).toEqual(true); expect(isSpace(0x0a)).toEqual(true); }); it("handles non-space characters", function() { expect(isSpace(0x0b)).toEqual(false); expect(isSpace(null)).toEqual(false); expect(isSpace(undefined)).toEqual(false); }); }); describe("isString", function() { it("handles string values", function() { expect(isString("foo")).toEqual(true); expect(isString("")).toEqual(true); }); it("handles non-string values", function() { expect(isString(true)).toEqual(false); expect(isString(1)).toEqual(false); expect(isString(null)).toEqual(false); expect(isString(undefined)).toEqual(false); }); }); describe("log2", function() { it("handles values smaller than/equal to zero", function() { expect(log2(0)).toEqual(0); expect(log2(-1)).toEqual(0); }); it("handles values larger than zero", function() { expect(log2(1)).toEqual(0); expect(log2(2)).toEqual(1); expect(log2(3)).toEqual(2); expect(log2(3.14)).toEqual(2); }); }); describe("string32", function() { it("converts unsigned 32-bit integers to strings", function() { expect(string32(0x74727565)).toEqual("true"); expect(string32(0x74797031)).toEqual("typ1"); expect(string32(0x4f54544f)).toEqual("OTTO"); }); }); describe("stringToBytes", function() { it("handles non-string arguments", function() { expect(function() { stringToBytes(null); }).toThrow(new Error("Invalid argument for stringToBytes")); }); it("handles string arguments", function() { expect(stringToBytes("")).toEqual(new Uint8Array([])); expect(stringToBytes("foo")).toEqual(new Uint8Array([102, 111, 111])); }); }); describe("stringToPDFString", function() { it("handles ISO Latin 1 strings", function() { let str = "\x8Dstring\x8E"; expect(stringToPDFString(str)).toEqual("\u201Cstring\u201D"); }); it("handles UTF-16 big-endian strings", function() { let str = "\xFE\xFF\x00\x73\x00\x74\x00\x72\x00\x69\x00\x6E\x00\x67"; expect(stringToPDFString(str)).toEqual("string"); }); it("handles UTF-16 little-endian strings", function() { let str = "\xFF\xFE\x73\x00\x74\x00\x72\x00\x69\x00\x6E\x00\x67\x00"; expect(stringToPDFString(str)).toEqual("string"); }); it("handles empty strings", function() { // ISO Latin 1 let str1 = ""; expect(stringToPDFString(str1)).toEqual(""); // UTF-16BE let str2 = "\xFE\xFF"; expect(stringToPDFString(str2)).toEqual(""); // UTF-16LE let str3 = "\xFF\xFE"; expect(stringToPDFString(str3)).toEqual(""); }); }); describe("removeNullCharacters", function() { it("should not modify string without null characters", function() { let str = "string without null chars"; expect(removeNullCharacters(str)).toEqual("string without null chars"); }); it("should modify string with null characters", function() { let str = "string\x00With\x00Null\x00Chars"; expect(removeNullCharacters(str)).toEqual("stringWithNullChars"); }); }); describe("ReadableStream", function() { it("should return an Object", function() { let readable = new ReadableStream(); expect(typeof readable).toEqual("object"); }); it("should have property getReader", function() { let readable = new ReadableStream(); expect(typeof readable.getReader).toEqual("function"); }); }); describe("URL", function() { it("should return an Object", function() { const url = new URL("https://example.com"); expect(typeof url).toEqual("object"); }); it("should have property `href`", function() { const url = new URL("https://example.com"); expect(typeof url.href).toEqual("string"); }); }); describe("isSameOrigin", function() { it("handles invalid base URLs", function() { // The base URL is not valid. expect(isSameOrigin("/foo", "/bar")).toEqual(false); // The base URL has no origin. expect(isSameOrigin("blob:foo", "/bar")).toEqual(false); }); it("correctly checks if the origin of both URLs matches", function() { expect( isSameOrigin( "https://www.mozilla.org/foo", "https://www.mozilla.org/bar" ) ).toEqual(true); expect( isSameOrigin( "https://www.mozilla.org/foo", "https://www.example.com/bar" ) ).toEqual(false); }); }); describe("createValidAbsoluteUrl", function() { it("handles invalid URLs", function() { expect(createValidAbsoluteUrl(undefined, undefined)).toEqual(null); expect(createValidAbsoluteUrl(null, null)).toEqual(null); expect(createValidAbsoluteUrl("/foo", "/bar")).toEqual(null); }); it("handles URLs that do not use a whitelisted protocol", function() { expect(createValidAbsoluteUrl("magnet:?foo", null)).toEqual(null); }); it("correctly creates a valid URL for whitelisted protocols", function() { // `http` protocol expect( createValidAbsoluteUrl("http://www.mozilla.org/foo", null) ).toEqual(new URL("http://www.mozilla.org/foo")); expect(createValidAbsoluteUrl("/foo", "http://www.mozilla.org")).toEqual( new URL("http://www.mozilla.org/foo") ); // `https` protocol expect( createValidAbsoluteUrl("https://www.mozilla.org/foo", null) ).toEqual(new URL("https://www.mozilla.org/foo")); expect(createValidAbsoluteUrl("/foo", "https://www.mozilla.org")).toEqual( new URL("https://www.mozilla.org/foo") ); // `ftp` protocol expect(createValidAbsoluteUrl("ftp://www.mozilla.org/foo", null)).toEqual( new URL("ftp://www.mozilla.org/foo") ); expect(createValidAbsoluteUrl("/foo", "ftp://www.mozilla.org")).toEqual( new URL("ftp://www.mozilla.org/foo") ); // `mailto` protocol (base URLs have no meaning and should yield `null`) expect(createValidAbsoluteUrl("mailto:foo@bar.baz", null)).toEqual( new URL("mailto:foo@bar.baz") ); expect(createValidAbsoluteUrl("/foo", "mailto:foo@bar.baz")).toEqual( null ); // `tel` protocol (base URLs have no meaning and should yield `null`) expect(createValidAbsoluteUrl("tel:+0123456789", null)).toEqual( new URL("tel:+0123456789") ); expect(createValidAbsoluteUrl("/foo", "tel:0123456789")).toEqual(null); }); }); describe("createPromiseCapability", function() { it("should resolve with correct data", function(done) { const promiseCapability = createPromiseCapability(); expect(promiseCapability.settled).toEqual(false); promiseCapability.resolve({ test: "abc" }); promiseCapability.promise.then(function(data) { expect(promiseCapability.settled).toEqual(true); expect(data).toEqual({ test: "abc" }); done(); }, done.fail); }); it("should reject with correct reason", function(done) { const promiseCapability = createPromiseCapability(); expect(promiseCapability.settled).toEqual(false); promiseCapability.reject(new Error("reason")); promiseCapability.promise.then(done.fail, function(reason) { expect(promiseCapability.settled).toEqual(true); expect(reason instanceof Error).toEqual(true); expect(reason.message).toEqual("reason"); done(); }); }); }); });