pdf.js/test/unit/api_spec.js

/* 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 {
  buildGetDocumentParams,
  DefaultFileReaderFactory,
  TEST_PDFS_PATH,
} from "./test_utils.js";
import {
  createPromiseCapability,
  FontType,
  ImageKind,
  InvalidPDFException,
  MissingPDFException,
  OPS,
  PasswordException,
  PasswordResponses,
  PermissionFlag,
  StreamType,
} from "../../src/shared/util.js";
import {
  DefaultCanvasFactory,
  getDocument,
  PDFDataRangeTransport,
  PDFDocumentProxy,
  PDFPageProxy,
  PDFWorker,
} from "../../src/display/api.js";
import {
  RenderingCancelledException,
  StatTimer,
} from "../../src/display/display_utils.js";
import { AutoPrintRegExp } from "../../web/ui_utils.js";
import { GlobalImageCache } from "../../src/core/image_utils.js";
import { GlobalWorkerOptions } from "../../src/display/worker_options.js";
import { isNodeJS } from "../../src/shared/is_node.js";
import { Metadata } from "../../src/display/metadata.js";

describe("api", function () {
  const basicApiFileName = "basicapi.pdf";
  const basicApiFileLength = 105779; // bytes
  const basicApiGetDocumentParams = buildGetDocumentParams(basicApiFileName);

  let CanvasFactory;

  beforeAll(function (done) {
    CanvasFactory = new DefaultCanvasFactory();
    done();
  });

  afterAll(function (done) {
    CanvasFactory = null;
    done();
  });

  function waitSome(callback) {
    const WAIT_TIMEOUT = 10;
    setTimeout(function () {
      callback();
    }, WAIT_TIMEOUT);
  }

  describe("getDocument", function () {
    it("creates pdf doc from URL-string", async function () {
      const urlStr = TEST_PDFS_PATH + basicApiFileName;
      const loadingTask = getDocument(urlStr);
      const pdfDocument = await loadingTask.promise;

      expect(typeof urlStr).toEqual("string");
      expect(pdfDocument instanceof PDFDocumentProxy).toEqual(true);
      expect(pdfDocument.numPages).toEqual(3);

      await loadingTask.destroy();
    });

    it("creates pdf doc from URL-object", async function () {
      if (isNodeJS) {
        pending("window.location is not supported in Node.js.");
      }
      const urlObj = new URL(
        TEST_PDFS_PATH + basicApiFileName,
        window.location
      );
      const loadingTask = getDocument(urlObj);
      const pdfDocument = await loadingTask.promise;

      expect(urlObj instanceof URL).toEqual(true);
      expect(pdfDocument instanceof PDFDocumentProxy).toEqual(true);
      expect(pdfDocument.numPages).toEqual(3);

      await loadingTask.destroy();
    });

    it("creates pdf doc from URL", function (done) {
      const loadingTask = getDocument(basicApiGetDocumentParams);

      const progressReportedCapability = createPromiseCapability();
      // Attach the callback that is used to report loading progress;
      // similarly to how viewer.js works.
      loadingTask.onProgress = function (progressData) {
        if (!progressReportedCapability.settled) {
          progressReportedCapability.resolve(progressData);
        }
      };

      const promises = [
        progressReportedCapability.promise,
        loadingTask.promise,
      ];
      Promise.all(promises)
        .then(function (data) {
          expect(data[0].loaded / data[0].total >= 0).toEqual(true);
          expect(data[1] instanceof PDFDocumentProxy).toEqual(true);
          expect(loadingTask).toEqual(data[1].loadingTask);
          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("creates pdf doc from URL and aborts before worker initialized", function (done) {
      const loadingTask = getDocument(basicApiGetDocumentParams);
      const destroyed = loadingTask.destroy();

      loadingTask.promise
        .then(function (reason) {
          done.fail("shall fail loading");
        })
        .catch(function (reason) {
          expect(true).toEqual(true);
          destroyed.then(done);
        });
    });
    it("creates pdf doc from URL and aborts loading after worker initialized", function (done) {
      const loadingTask = getDocument(basicApiGetDocumentParams);
      // This can be somewhat random -- we cannot guarantee perfect
      // 'Terminate' message to the worker before/after setting up pdfManager.
      const destroyed = loadingTask._worker.promise.then(function () {
        return loadingTask.destroy();
      });
      destroyed
        .then(function (data) {
          expect(true).toEqual(true);
          done();
        })
        .catch(done.fail);
    });
    it("creates pdf doc from typed array", function (done) {
      const typedArrayPdfPromise = DefaultFileReaderFactory.fetch({
        path: TEST_PDFS_PATH + basicApiFileName,
      });

      typedArrayPdfPromise
        .then(typedArrayPdf => {
          // Sanity check to make sure that we fetched the entire PDF file.
          expect(typedArrayPdf.length).toEqual(basicApiFileLength);

          const loadingTask = getDocument(typedArrayPdf);

          const progressReportedCapability = createPromiseCapability();
          loadingTask.onProgress = function (data) {
            progressReportedCapability.resolve(data);
          };

          return Promise.all([
            loadingTask.promise,
            progressReportedCapability.promise,
          ]).then(function (data) {
            expect(data[0] instanceof PDFDocumentProxy).toEqual(true);
            expect(data[1].loaded / data[1].total).toEqual(1);

            loadingTask.destroy().then(done);
          });
        })
        .catch(done.fail);
    });
    it("creates pdf doc from invalid PDF file", function (done) {
      // A severely corrupt PDF file (even Adobe Reader fails to open it).
      const loadingTask = getDocument(buildGetDocumentParams("bug1020226.pdf"));
      loadingTask.promise
        .then(function () {
          done.fail("shall fail loading");
        })
        .catch(function (reason) {
          expect(reason instanceof InvalidPDFException).toEqual(true);
          expect(reason.message).toEqual("Invalid PDF structure.");

          loadingTask.destroy().then(done);
        });
    });
    it("creates pdf doc from non-existent URL", function (done) {
      if (!isNodeJS) {
        // re-enable https://github.com/mozilla/pdf.js/issues/13061
        pending("Fails intermittently on linux in browsers.");
      }
      const loadingTask = getDocument(
        buildGetDocumentParams("non-existent.pdf")
      );
      loadingTask.promise
        .then(function (error) {
          done.fail("shall fail loading");
        })
        .catch(function (error) {
          expect(error instanceof MissingPDFException).toEqual(true);
          loadingTask.destroy().then(done);
        });
    });
    it("creates pdf doc from PDF file protected with user and owner password", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("pr6531_1.pdf"));

      const passwordNeededCapability = createPromiseCapability();
      const passwordIncorrectCapability = createPromiseCapability();
      // Attach the callback that is used to request a password;
      // similarly to how viewer.js handles passwords.
      loadingTask.onPassword = function (updatePassword, reason) {
        if (
          reason === PasswordResponses.NEED_PASSWORD &&
          !passwordNeededCapability.settled
        ) {
          passwordNeededCapability.resolve();

          updatePassword("qwerty"); // Provide an incorrect password.
          return;
        }
        if (
          reason === PasswordResponses.INCORRECT_PASSWORD &&
          !passwordIncorrectCapability.settled
        ) {
          passwordIncorrectCapability.resolve();

          updatePassword("asdfasdf"); // Provide the correct password.
          return;
        }
        // Shouldn't get here.
        expect(false).toEqual(true);
      };

      const promises = [
        passwordNeededCapability.promise,
        passwordIncorrectCapability.promise,
        loadingTask.promise,
      ];
      Promise.all(promises)
        .then(function (data) {
          expect(data[2] instanceof PDFDocumentProxy).toEqual(true);
          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("creates pdf doc from PDF file protected with only a user password", function (done) {
      const filename = "pr6531_2.pdf";

      const passwordNeededLoadingTask = getDocument(
        buildGetDocumentParams(filename, {
          password: "",
        })
      );
      const result1 = passwordNeededLoadingTask.promise.then(
        function () {
          done.fail("shall fail with no password");
          return Promise.reject(new Error("loadingTask should be rejected"));
        },
        function (data) {
          expect(data instanceof PasswordException).toEqual(true);
          expect(data.code).toEqual(PasswordResponses.NEED_PASSWORD);
          return passwordNeededLoadingTask.destroy();
        }
      );

      const passwordIncorrectLoadingTask = getDocument(
        buildGetDocumentParams(filename, {
          password: "qwerty",
        })
      );
      const result2 = passwordIncorrectLoadingTask.promise.then(
        function () {
          done.fail("shall fail with wrong password");
          return Promise.reject(new Error("loadingTask should be rejected"));
        },
        function (data) {
          expect(data instanceof PasswordException).toEqual(true);
          expect(data.code).toEqual(PasswordResponses.INCORRECT_PASSWORD);
          return passwordIncorrectLoadingTask.destroy();
        }
      );

      const passwordAcceptedLoadingTask = getDocument(
        buildGetDocumentParams(filename, {
          password: "asdfasdf",
        })
      );
      const result3 = passwordAcceptedLoadingTask.promise.then(function (data) {
        expect(data instanceof PDFDocumentProxy).toEqual(true);
        return passwordAcceptedLoadingTask.destroy();
      });
      Promise.all([result1, result2, result3])
        .then(function () {
          done();
        })
        .catch(done.fail);
    });

    it(
      "creates pdf doc from password protected PDF file and aborts/throws " +
        "in the onPassword callback (issue 7806)",
      function (done) {
        const filename = "issue3371.pdf";

        const passwordNeededLoadingTask = getDocument(
          buildGetDocumentParams(filename)
        );
        const passwordIncorrectLoadingTask = getDocument(
          buildGetDocumentParams(filename, {
            password: "qwerty",
          })
        );

        let passwordNeededDestroyed;
        passwordNeededLoadingTask.onPassword = function (callback, reason) {
          if (reason === PasswordResponses.NEED_PASSWORD) {
            passwordNeededDestroyed = passwordNeededLoadingTask.destroy();
            return;
          }
          // Shouldn't get here.
          expect(false).toEqual(true);
        };
        const result1 = passwordNeededLoadingTask.promise.then(
          function () {
            done.fail("shall fail since the loadingTask should be destroyed");
            return Promise.reject(new Error("loadingTask should be rejected"));
          },
          function (reason) {
            expect(reason instanceof PasswordException).toEqual(true);
            expect(reason.code).toEqual(PasswordResponses.NEED_PASSWORD);
            return passwordNeededDestroyed;
          }
        );

        passwordIncorrectLoadingTask.onPassword = function (callback, reason) {
          if (reason === PasswordResponses.INCORRECT_PASSWORD) {
            throw new Error("Incorrect password");
          }
          // Shouldn't get here.
          expect(false).toEqual(true);
        };
        const result2 = passwordIncorrectLoadingTask.promise.then(
          function () {
            done.fail("shall fail since the onPassword callback should throw");
            return Promise.reject(new Error("loadingTask should be rejected"));
          },
          function (reason) {
            expect(reason instanceof PasswordException).toEqual(true);
            expect(reason.code).toEqual(PasswordResponses.INCORRECT_PASSWORD);
            return passwordIncorrectLoadingTask.destroy();
          }
        );

        Promise.all([result1, result2])
          .then(function () {
            done();
          })
          .catch(done.fail);
      }
    );

    it("creates pdf doc from empty typed array", function (done) {
      const loadingTask = getDocument(new Uint8Array(0));

      loadingTask.promise.then(
        function () {
          done.fail("shall not open empty file");
        },
        function (reason) {
          expect(reason instanceof InvalidPDFException);
          expect(reason.message).toEqual(
            "The PDF file is empty, i.e. its size is zero bytes."
          );

          loadingTask.destroy().then(done);
        }
      );
    });
  });

  describe("PDFWorker", function () {
    it("worker created or destroyed", function (done) {
      if (isNodeJS) {
        pending("Worker is not supported in Node.js.");
      }

      const worker = new PDFWorker({ name: "test1" });
      worker.promise
        .then(function () {
          expect(worker.name).toEqual("test1");
          expect(!!worker.port).toEqual(true);
          expect(worker.destroyed).toEqual(false);
          expect(!!worker._webWorker).toEqual(true);
          expect(worker.port === worker._webWorker).toEqual(true);

          worker.destroy();
          expect(!!worker.port).toEqual(false);
          expect(worker.destroyed).toEqual(true);
          done();
        })
        .catch(done.fail);
    });
    it("worker created or destroyed by getDocument", function (done) {
      if (isNodeJS) {
        pending("Worker is not supported in Node.js.");
      }

      const loadingTask = getDocument(basicApiGetDocumentParams);
      let worker;
      loadingTask.promise.then(function () {
        worker = loadingTask._worker;
        expect(!!worker).toEqual(true);
      });

      const destroyPromise = loadingTask.promise.then(function () {
        return loadingTask.destroy();
      });
      destroyPromise
        .then(function () {
          const destroyedWorker = loadingTask._worker;
          expect(!!destroyedWorker).toEqual(false);
          expect(worker.destroyed).toEqual(true);
          done();
        })
        .catch(done.fail);
    });
    it("worker created and can be used in getDocument", function (done) {
      if (isNodeJS) {
        pending("Worker is not supported in Node.js.");
      }

      const worker = new PDFWorker({ name: "test1" });
      const loadingTask = getDocument(
        buildGetDocumentParams(basicApiFileName, {
          worker,
        })
      );
      loadingTask.promise.then(function () {
        const docWorker = loadingTask._worker;
        expect(!!docWorker).toEqual(false);
        // checking is the same port is used in the MessageHandler
        const messageHandlerPort = loadingTask._transport.messageHandler.comObj;
        expect(messageHandlerPort === worker.port).toEqual(true);
      });

      const destroyPromise = loadingTask.promise.then(function () {
        return loadingTask.destroy();
      });
      destroyPromise
        .then(function () {
          expect(worker.destroyed).toEqual(false);
          worker.destroy();
          done();
        })
        .catch(done.fail);
    });
    it("creates more than one worker", function (done) {
      if (isNodeJS) {
        pending("Worker is not supported in Node.js.");
      }

      const worker1 = new PDFWorker({ name: "test1" });
      const worker2 = new PDFWorker({ name: "test2" });
      const worker3 = new PDFWorker({ name: "test3" });
      const ready = Promise.all([
        worker1.promise,
        worker2.promise,
        worker3.promise,
      ]);
      ready
        .then(function () {
          expect(
            worker1.port !== worker2.port &&
              worker1.port !== worker3.port &&
              worker2.port !== worker3.port
          ).toEqual(true);
          worker1.destroy();
          worker2.destroy();
          worker3.destroy();
          done();
        })
        .catch(done.fail);
    });
    it("gets current workerSrc", function () {
      if (isNodeJS) {
        pending("Worker is not supported in Node.js.");
      }

      const workerSrc = PDFWorker.getWorkerSrc();
      expect(typeof workerSrc).toEqual("string");
      expect(workerSrc).toEqual(GlobalWorkerOptions.workerSrc);
    });
  });
  describe("PDFDocument", function () {
    let pdfLoadingTask, pdfDocument;

    beforeAll(function (done) {
      pdfLoadingTask = getDocument(basicApiGetDocumentParams);
      pdfLoadingTask.promise.then(function (data) {
        pdfDocument = data;
        done();
      });
    });

    afterAll(function (done) {
      pdfLoadingTask.destroy().then(done);
    });

    it("gets number of pages", function () {
      expect(pdfDocument.numPages).toEqual(3);
    });
    it("gets fingerprint", function () {
      expect(pdfDocument.fingerprint).toEqual(
        "ea8b35919d6279a369e835bde778611b"
      );
    });
    it("gets page", function (done) {
      const promise = pdfDocument.getPage(1);
      promise
        .then(function (data) {
          expect(data instanceof PDFPageProxy).toEqual(true);
          expect(data.pageNumber).toEqual(1);
          done();
        })
        .catch(done.fail);
    });
    it("gets non-existent page", function (done) {
      let outOfRangePromise = pdfDocument.getPage(100);
      let nonIntegerPromise = pdfDocument.getPage(2.5);
      let nonNumberPromise = pdfDocument.getPage("1");

      outOfRangePromise = outOfRangePromise.then(
        function () {
          throw new Error("shall fail for out-of-range pageNumber parameter");
        },
        function (reason) {
          expect(reason instanceof Error).toEqual(true);
        }
      );
      nonIntegerPromise = nonIntegerPromise.then(
        function () {
          throw new Error("shall fail for non-integer pageNumber parameter");
        },
        function (reason) {
          expect(reason instanceof Error).toEqual(true);
        }
      );
      nonNumberPromise = nonNumberPromise.then(
        function () {
          throw new Error("shall fail for non-number pageNumber parameter");
        },
        function (reason) {
          expect(reason instanceof Error).toEqual(true);
        }
      );

      Promise.all([outOfRangePromise, nonIntegerPromise, nonNumberPromise])
        .then(function () {
          done();
        })
        .catch(done.fail);
    });

    it("gets page, from /Pages tree with circular reference", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("Pages-tree-refs.pdf")
      );

      const page1 = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getPage(1).then(
          function (pdfPage) {
            expect(pdfPage instanceof PDFPageProxy).toEqual(true);
            expect(pdfPage.ref).toEqual({ num: 6, gen: 0 });
          },
          function (reason) {
            throw new Error("shall not fail for valid page");
          }
        );
      });

      const page2 = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getPage(2).then(
          function (pdfPage) {
            throw new Error("shall fail for invalid page");
          },
          function (reason) {
            expect(reason instanceof Error).toEqual(true);
            expect(reason.message).toEqual(
              "Pages tree contains circular reference."
            );
          }
        );
      });

      Promise.all([page1, page2]).then(function () {
        loadingTask.destroy().then(done);
      }, done.fail);
    });

    it("gets page index", function (done) {
      // reference to second page
      const ref = { num: 17, gen: 0 };
      const promise = pdfDocument.getPageIndex(ref);
      promise
        .then(function (pageIndex) {
          expect(pageIndex).toEqual(1);
          done();
        })
        .catch(done.fail);
    });
    it("gets invalid page index", function (done) {
      const ref = { num: 3, gen: 0 }; // Reference to a font dictionary.
      const promise = pdfDocument.getPageIndex(ref);
      promise
        .then(function () {
          done.fail("shall fail for invalid page reference.");
        })
        .catch(function (reason) {
          expect(reason instanceof Error).toEqual(true);
          done();
        });
    });

    it("gets destinations, from /Dests dictionary", function (done) {
      const promise = pdfDocument.getDestinations();
      promise
        .then(function (data) {
          expect(data).toEqual({
            chapter1: [{ gen: 0, num: 17 }, { name: "XYZ" }, 0, 841.89, null],
          });
          done();
        })
        .catch(done.fail);
    });
    it("gets a destination, from /Dests dictionary", function (done) {
      const promise = pdfDocument.getDestination("chapter1");
      promise
        .then(function (data) {
          expect(data).toEqual([
            { gen: 0, num: 17 },
            { name: "XYZ" },
            0,
            841.89,
            null,
          ]);
          done();
        })
        .catch(done.fail);
    });
    it("gets a non-existent destination, from /Dests dictionary", function (done) {
      const promise = pdfDocument.getDestination(
        "non-existent-named-destination"
      );
      promise
        .then(function (data) {
          expect(data).toEqual(null);
          done();
        })
        .catch(done.fail);
    });

    it("gets destinations, from /Names (NameTree) dictionary", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("issue6204.pdf"));
      const promise = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getDestinations();
      });
      promise
        .then(function (destinations) {
          expect(destinations).toEqual({
            "Page.1": [{ num: 1, gen: 0 }, { name: "XYZ" }, 0, 375, null],
            "Page.2": [{ num: 6, gen: 0 }, { name: "XYZ" }, 0, 375, null],
          });

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets a destination, from /Names (NameTree) dictionary", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("issue6204.pdf"));
      const promise = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getDestination("Page.1");
      });
      promise
        .then(function (destination) {
          expect(destination).toEqual([
            { num: 1, gen: 0 },
            { name: "XYZ" },
            0,
            375,
            null,
          ]);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets a non-existent destination, from /Names (NameTree) dictionary", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("issue6204.pdf"));
      const promise = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getDestination("non-existent-named-destination");
      });
      promise
        .then(function (destination) {
          expect(destination).toEqual(null);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });

    it("gets non-string destination", function (done) {
      let numberPromise = pdfDocument.getDestination(4.3);
      let booleanPromise = pdfDocument.getDestination(true);
      let arrayPromise = pdfDocument.getDestination([
        { num: 17, gen: 0 },
        { name: "XYZ" },
        0,
        841.89,
        null,
      ]);

      numberPromise = numberPromise.then(
        function () {
          throw new Error("shall fail for non-string destination.");
        },
        function (reason) {
          expect(reason instanceof Error).toEqual(true);
        }
      );
      booleanPromise = booleanPromise.then(
        function () {
          throw new Error("shall fail for non-string destination.");
        },
        function (reason) {
          expect(reason instanceof Error).toEqual(true);
        }
      );
      arrayPromise = arrayPromise.then(
        function () {
          throw new Error("shall fail for non-string destination.");
        },
        function (reason) {
          expect(reason instanceof Error).toEqual(true);
        }
      );

      Promise.all([numberPromise, booleanPromise, arrayPromise]).then(
        done,
        done.fail
      );
    });

    it("gets non-existent page labels", function (done) {
      const promise = pdfDocument.getPageLabels();
      promise
        .then(function (data) {
          expect(data).toEqual(null);
          done();
        })
        .catch(done.fail);
    });
    it("gets page labels", function (done) {
      // PageLabels with Roman/Arabic numerals.
      const loadingTask0 = getDocument(buildGetDocumentParams("bug793632.pdf"));
      const promise0 = loadingTask0.promise.then(function (pdfDoc) {
        return pdfDoc.getPageLabels();
      });

      // PageLabels with only a label prefix.
      const loadingTask1 = getDocument(buildGetDocumentParams("issue1453.pdf"));
      const promise1 = loadingTask1.promise.then(function (pdfDoc) {
        return pdfDoc.getPageLabels();
      });

      // PageLabels identical to standard page numbering.
      const loadingTask2 = getDocument(buildGetDocumentParams("rotation.pdf"));
      const promise2 = loadingTask2.promise.then(function (pdfDoc) {
        return pdfDoc.getPageLabels();
      });

      // PageLabels with bad "Prefix" entries.
      const loadingTask3 = getDocument(
        buildGetDocumentParams("bad-PageLabels.pdf")
      );
      const promise3 = loadingTask3.promise.then(function (pdfDoc) {
        return pdfDoc.getPageLabels();
      });

      Promise.all([promise0, promise1, promise2, promise3])
        .then(function (pageLabels) {
          expect(pageLabels[0]).toEqual(["i", "ii", "iii", "1"]);
          expect(pageLabels[1]).toEqual(["Front Page1"]);
          expect(pageLabels[2]).toEqual(["1", "2"]);
          expect(pageLabels[3]).toEqual(["X3"]);

          Promise.all([
            loadingTask0.destroy(),
            loadingTask1.destroy(),
            loadingTask2.destroy(),
            loadingTask3.destroy(),
          ]).then(done);
        })
        .catch(done.fail);
    });

    it("gets default page layout", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getPageLayout();
        })
        .then(function (mode) {
          expect(mode).toEqual("");

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets non-default page layout", function (done) {
      pdfDocument
        .getPageLayout()
        .then(function (mode) {
          expect(mode).toEqual("SinglePage");
          done();
        })
        .catch(done.fail);
    });

    it("gets default page mode", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getPageMode();
        })
        .then(function (mode) {
          expect(mode).toEqual("UseNone");

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets non-default page mode", function (done) {
      pdfDocument
        .getPageMode()
        .then(function (mode) {
          expect(mode).toEqual("UseOutlines");
          done();
        })
        .catch(done.fail);
    });

    it("gets default viewer preferences", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getViewerPreferences();
        })
        .then(function (prefs) {
          expect(prefs).toEqual(null);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets non-default viewer preferences", function (done) {
      pdfDocument
        .getViewerPreferences()
        .then(function (prefs) {
          expect(prefs).toEqual({
            Direction: "L2R",
          });
          done();
        })
        .catch(done.fail);
    });

    it("gets default open action", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getOpenAction();
        })
        .then(function (openAction) {
          expect(openAction).toEqual(null);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets non-default open action (with destination)", function (done) {
      pdfDocument
        .getOpenAction()
        .then(function (openAction) {
          expect(openAction.dest).toEqual([
            { num: 15, gen: 0 },
            { name: "FitH" },
            null,
          ]);
          expect(openAction.action).toBeUndefined();

          done();
        })
        .catch(done.fail);
    });
    it("gets non-default open action (with Print action)", function (done) {
      // PDF document with "Print" Named action in the OpenAction dictionary.
      const loadingTask1 = getDocument(
        buildGetDocumentParams("bug1001080.pdf")
      );
      // PDF document with "Print" Named action in the OpenAction dictionary,
      // but the OpenAction dictionary is missing the `Type` entry.
      const loadingTask2 = getDocument(
        buildGetDocumentParams("issue11442_reduced.pdf")
      );

      const promise1 = loadingTask1.promise
        .then(function (pdfDoc) {
          return pdfDoc.getOpenAction();
        })
        .then(function (openAction) {
          expect(openAction.dest).toBeUndefined();
          expect(openAction.action).toEqual("Print");

          return loadingTask1.destroy();
        });
      const promise2 = loadingTask2.promise
        .then(function (pdfDoc) {
          return pdfDoc.getOpenAction();
        })
        .then(function (openAction) {
          expect(openAction.dest).toBeUndefined();
          expect(openAction.action).toEqual("Print");

          return loadingTask2.destroy();
        });

      Promise.all([promise1, promise2]).then(done, done.fail);
    });

    it("gets non-existent attachments", function (done) {
      const promise = pdfDocument.getAttachments();
      promise
        .then(function (data) {
          expect(data).toEqual(null);
          done();
        })
        .catch(done.fail);
    });
    it("gets attachments", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("attachment.pdf"));
      const promise = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getAttachments();
      });
      promise
        .then(function (data) {
          const attachment = data["foo.txt"];
          expect(attachment.filename).toEqual("foo.txt");
          expect(attachment.content).toEqual(
            new Uint8Array([98, 97, 114, 32, 98, 97, 122, 32, 10])
          );

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });

    it("gets javascript", function (done) {
      const promise = pdfDocument.getJavaScript();
      promise
        .then(function (data) {
          expect(data).toEqual(null);
          done();
        })
        .catch(done.fail);
    });
    it("gets javascript with printing instructions (JS action)", function (done) {
      // PDF document with "JavaScript" action in the OpenAction dictionary.
      const loadingTask = getDocument(buildGetDocumentParams("issue6106.pdf"));
      const promise = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getJavaScript();
      });
      promise
        .then(function (data) {
          expect(data).toEqual([
            "this.print({bUI:true,bSilent:false,bShrinkToFit:true});",
          ]);
          expect(data[0]).toMatch(AutoPrintRegExp);
          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });

    it("gets JSActions (none)", function (done) {
      const promise = pdfDocument.getJSActions();
      promise
        .then(function (data) {
          expect(data).toEqual(null);
          done();
        })
        .catch(done.fail);
    });
    it("gets JSActions", function (done) {
      // PDF document with "JavaScript" action in the OpenAction dictionary.
      const loadingTask = getDocument(
        buildGetDocumentParams("doc_actions.pdf")
      );
      const promise = loadingTask.promise.then(async pdfDoc => {
        const docActions = await pdfDoc.getJSActions();
        const page1 = await pdfDoc.getPage(1);
        const page3 = await pdfDoc.getPage(3);
        const page1Actions = await page1.getJSActions();
        const page3Actions = await page3.getJSActions();
        return [docActions, page1Actions, page3Actions];
      });
      promise
        .then(async ([docActions, page1Actions, page3Actions]) => {
          expect(docActions).toEqual({
            DidPrint: [`this.getField("Text2").value = "DidPrint";`],
            DidSave: [`this.getField("Text2").value = "DidSave";`],
            WillClose: [`this.getField("Text1").value = "WillClose";`],
            WillPrint: [`this.getField("Text1").value = "WillPrint";`],
            WillSave: [`this.getField("Text1").value = "WillSave";`],
          });
          expect(page1Actions).toEqual({
            PageOpen: [`this.getField("Text1").value = "PageOpen 1";`],
            PageClose: [`this.getField("Text2").value = "PageClose 1";`],
          });
          expect(page3Actions).toEqual({
            PageOpen: [`this.getField("Text5").value = "PageOpen 3";`],
            PageClose: [`this.getField("Text6").value = "PageClose 3";`],
          });
          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });

    it("gets non-existent outline", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );

      const promise = loadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getOutline();
      });
      promise
        .then(function (outline) {
          expect(outline).toEqual(null);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets outline", function (done) {
      const promise = pdfDocument.getOutline();
      promise
        .then(function (outline) {
          // Two top level entries.
          expect(Array.isArray(outline)).toEqual(true);
          expect(outline.length).toEqual(2);
          // Make sure some basic attributes are set.
          const outlineItem = outline[1];
          expect(outlineItem.title).toEqual("Chapter 1");
          expect(Array.isArray(outlineItem.dest)).toEqual(true);
          expect(outlineItem.url).toEqual(null);
          expect(outlineItem.unsafeUrl).toBeUndefined();
          expect(outlineItem.newWindow).toBeUndefined();

          expect(outlineItem.bold).toEqual(true);
          expect(outlineItem.italic).toEqual(false);
          expect(outlineItem.color).toEqual(
            new Uint8ClampedArray([0, 64, 128])
          );

          expect(outlineItem.items.length).toEqual(1);
          expect(outlineItem.items[0].title).toEqual("Paragraph 1.1");
          done();
        })
        .catch(done.fail);
    });
    it("gets outline containing a url", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("issue3214.pdf"));

      loadingTask.promise
        .then(function (pdfDoc) {
          pdfDoc.getOutline().then(function (outline) {
            expect(Array.isArray(outline)).toEqual(true);
            expect(outline.length).toEqual(5);

            const outlineItemTwo = outline[2];
            expect(typeof outlineItemTwo.title).toEqual("string");
            expect(outlineItemTwo.dest).toEqual(null);
            expect(outlineItemTwo.url).toEqual("http://google.com/");
            expect(outlineItemTwo.unsafeUrl).toEqual("http://google.com");
            expect(outlineItemTwo.newWindow).toBeUndefined();

            const outlineItemOne = outline[1];
            expect(outlineItemOne.bold).toEqual(false);
            expect(outlineItemOne.italic).toEqual(true);
            expect(outlineItemOne.color).toEqual(
              new Uint8ClampedArray([0, 0, 0])
            );

            loadingTask.destroy().then(done);
          });
        })
        .catch(done.fail);
    });

    it("gets non-existent permissions", function (done) {
      pdfDocument
        .getPermissions()
        .then(function (permissions) {
          expect(permissions).toEqual(null);

          done();
        })
        .catch(done.fail);
    });

    it("gets permissions", function (done) {
      // Editing not allowed.
      const loadingTask0 = getDocument(
        buildGetDocumentParams("issue9972-1.pdf")
      );
      const promise0 = loadingTask0.promise.then(function (pdfDoc) {
        return pdfDoc.getPermissions();
      });

      // Printing not allowed.
      const loadingTask1 = getDocument(
        buildGetDocumentParams("issue9972-2.pdf")
      );
      const promise1 = loadingTask1.promise.then(function (pdfDoc) {
        return pdfDoc.getPermissions();
      });

      // Copying not allowed.
      const loadingTask2 = getDocument(
        buildGetDocumentParams("issue9972-3.pdf")
      );
      const promise2 = loadingTask2.promise.then(function (pdfDoc) {
        return pdfDoc.getPermissions();
      });

      const totalPermissionCount = Object.keys(PermissionFlag).length;
      Promise.all([promise0, promise1, promise2])
        .then(function (permissions) {
          expect(permissions[0].length).toEqual(totalPermissionCount - 1);
          expect(
            permissions[0].includes(PermissionFlag.MODIFY_CONTENTS)
          ).toBeFalsy();

          expect(permissions[1].length).toEqual(totalPermissionCount - 2);
          expect(permissions[1].includes(PermissionFlag.PRINT)).toBeFalsy();
          expect(
            permissions[1].includes(PermissionFlag.PRINT_HIGH_QUALITY)
          ).toBeFalsy();

          expect(permissions[2].length).toEqual(totalPermissionCount - 1);
          expect(permissions[2].includes(PermissionFlag.COPY)).toBeFalsy();

          Promise.all([
            loadingTask0.destroy(),
            loadingTask1.destroy(),
            loadingTask2.destroy(),
          ]).then(done);
        })
        .catch(done.fail);
    });

    it("gets metadata", function (done) {
      const promise = pdfDocument.getMetadata();
      promise
        .then(function ({
          info,
          metadata,
          contentDispositionFilename,
          contentLength,
        }) {
          expect(info.Title).toEqual("Basic API Test");
          // Custom, non-standard, information dictionary entries.
          expect(info.Custom).toEqual(undefined);
          // The following are PDF.js specific, non-standard, properties.
          expect(info.PDFFormatVersion).toEqual("1.7");
          expect(info.IsLinearized).toEqual(false);
          expect(info.IsAcroFormPresent).toEqual(false);
          expect(info.IsXFAPresent).toEqual(false);
          expect(info.IsCollectionPresent).toEqual(false);

          expect(metadata instanceof Metadata).toEqual(true);
          expect(metadata.get("dc:title")).toEqual("Basic API Test");

          expect(contentDispositionFilename).toEqual(null);
          expect(contentLength).toEqual(basicApiFileLength);
          done();
        })
        .catch(done.fail);
    });
    it("gets metadata, with custom info dict entries", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getMetadata();
        })
        .then(function ({
          info,
          metadata,
          contentDispositionFilename,
          contentLength,
        }) {
          expect(info.Creator).toEqual("TeX");
          expect(info.Producer).toEqual("pdfeTeX-1.21a");
          expect(info.CreationDate).toEqual("D:20090401163925-07'00'");
          // Custom, non-standard, information dictionary entries.
          const custom = info.Custom;
          expect(typeof custom === "object" && custom !== null).toEqual(true);

          expect(custom["PTEX.Fullbanner"]).toEqual(
            "This is pdfeTeX, " +
              "Version 3.141592-1.21a-2.2 (Web2C 7.5.4) kpathsea version 3.5.6"
          );
          // The following are PDF.js specific, non-standard, properties.
          expect(info.PDFFormatVersion).toEqual("1.4");
          expect(info.IsLinearized).toEqual(false);
          expect(info.IsAcroFormPresent).toEqual(false);
          expect(info.IsXFAPresent).toEqual(false);
          expect(info.IsCollectionPresent).toEqual(false);

          expect(metadata).toEqual(null);
          expect(contentDispositionFilename).toEqual(null);
          expect(contentLength).toEqual(1016315);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });
    it("gets metadata, with missing PDF header (bug 1606566)", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("bug1606566.pdf"));

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getMetadata();
        })
        .then(function ({
          info,
          metadata,
          contentDispositionFilename,
          contentLength,
        }) {
          // The following are PDF.js specific, non-standard, properties.
          expect(info.PDFFormatVersion).toEqual(null);
          expect(info.IsLinearized).toEqual(false);
          expect(info.IsAcroFormPresent).toEqual(false);
          expect(info.IsXFAPresent).toEqual(false);
          expect(info.IsCollectionPresent).toEqual(false);

          expect(metadata).toEqual(null);
          expect(contentDispositionFilename).toEqual(null);
          expect(contentLength).toEqual(624);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });

    it("gets markInfo", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("annotation-line.pdf")
      );

      loadingTask.promise
        .then(function (pdfDoc) {
          return pdfDoc.getMarkInfo();
        })
        .then(function (info) {
          expect(info.Marked).toEqual(true);
          expect(info.UserProperties).toEqual(false);
          expect(info.Suspects).toEqual(false);
          done();
        })
        .catch(done.fail);
    });

    it("gets data", function (done) {
      const promise = pdfDocument.getData();
      promise
        .then(function (data) {
          expect(data instanceof Uint8Array).toEqual(true);
          expect(data.length).toEqual(basicApiFileLength);
          done();
        })
        .catch(done.fail);
    });
    it("gets download info", function (done) {
      const promise = pdfDocument.getDownloadInfo();
      promise
        .then(function (data) {
          expect(data).toEqual({ length: basicApiFileLength });
          done();
        })
        .catch(done.fail);
    });
    it("gets document stats", function (done) {
      const promise = pdfDocument.getStats();
      promise
        .then(function (stats) {
          expect(stats).toEqual({ streamTypes: {}, fontTypes: {} });
          done();
        })
        .catch(done.fail);
    });

    it("cleans up document resources", function (done) {
      const promise = pdfDocument.cleanup();
      promise.then(function () {
        expect(true).toEqual(true);
        done();
      }, done.fail);
    });

    it("checks that fingerprints are unique", function (done) {
      const loadingTask1 = getDocument(
        buildGetDocumentParams("issue4436r.pdf")
      );
      const loadingTask2 = getDocument(buildGetDocumentParams("issue4575.pdf"));

      Promise.all([loadingTask1.promise, loadingTask2.promise])
        .then(function (data) {
          const fingerprint1 = data[0].fingerprint;
          const fingerprint2 = data[1].fingerprint;

          expect(fingerprint1).not.toEqual(fingerprint2);

          expect(fingerprint1).toEqual("2f695a83d6e7553c24fc08b7ac69712d");
          expect(fingerprint2).toEqual("04c7126b34a46b6d4d6e7a1eff7edcb6");

          Promise.all([loadingTask1.destroy(), loadingTask2.destroy()]).then(
            done
          );
        })
        .catch(done.fail);
    });

    describe("Cross-origin", function () {
      let loadingTask;
      function _checkCanLoad(expectSuccess, filename, options) {
        if (isNodeJS) {
          pending("Cannot simulate cross-origin requests in Node.js");
        }
        const params = buildGetDocumentParams(filename, options);
        const url = new URL(params.url);
        if (url.hostname === "localhost") {
          url.hostname = "127.0.0.1";
        } else if (params.url.hostname === "127.0.0.1") {
          url.hostname = "localhost";
        } else {
          pending("Can only run cross-origin test on localhost!");
        }
        params.url = url.href;
        loadingTask = getDocument(params);
        return loadingTask.promise
          .then(function (pdf) {
            return pdf.destroy();
          })
          .then(
            function () {
              expect(expectSuccess).toEqual(true);
            },
            function (error) {
              if (expectSuccess) {
                // For ease of debugging.
                expect(error).toEqual("There should not be any error");
              }
              expect(expectSuccess).toEqual(false);
            }
          );
      }
      function testCanLoad(filename, options) {
        return _checkCanLoad(true, filename, options);
      }
      function testCannotLoad(filename, options) {
        return _checkCanLoad(false, filename, options);
      }
      afterEach(function (done) {
        if (loadingTask && !loadingTask.destroyed) {
          loadingTask.destroy().then(done);
        } else {
          done();
        }
      });
      it("server disallows cors", function (done) {
        testCannotLoad("basicapi.pdf").then(done);
      });
      it("server allows cors without credentials, default withCredentials", function (done) {
        testCanLoad("basicapi.pdf?cors=withoutCredentials").then(done);
      });
      it("server allows cors without credentials, and withCredentials=false", function (done) {
        testCanLoad("basicapi.pdf?cors=withoutCredentials", {
          withCredentials: false,
        }).then(done);
      });
      it("server allows cors without credentials, but withCredentials=true", function (done) {
        testCannotLoad("basicapi.pdf?cors=withoutCredentials", {
          withCredentials: true,
        }).then(done);
      });
      it("server allows cors with credentials, and withCredentials=true", function (done) {
        testCanLoad("basicapi.pdf?cors=withCredentials", {
          withCredentials: true,
        }).then(done);
      });
      it("server allows cors with credentials, and withCredentials=false", function (done) {
        // The server supports even more than we need, so if the previous tests
        // pass, then this should pass for sure.
        // The only case where this test fails is when the server does not reply
        // with the Access-Control-Allow-Origin header.
        testCanLoad("basicapi.pdf?cors=withCredentials", {
          withCredentials: false,
        }).then(done);
      });
    });
  });
  describe("Page", function () {
    let pdfLoadingTask, pdfDocument, page;

    beforeAll(function (done) {
      pdfLoadingTask = getDocument(basicApiGetDocumentParams);
      pdfLoadingTask.promise
        .then(function (doc) {
          pdfDocument = doc;
          pdfDocument.getPage(1).then(function (data) {
            page = data;
            done();
          });
        })
        .catch(done.fail);
    });

    afterAll(function (done) {
      pdfLoadingTask.destroy().then(done);
    });

    it("gets page number", function () {
      expect(page.pageNumber).toEqual(1);
    });
    it("gets rotate", function () {
      expect(page.rotate).toEqual(0);
    });
    it("gets ref", function () {
      expect(page.ref).toEqual({ num: 15, gen: 0 });
    });
    it("gets userUnit", function () {
      expect(page.userUnit).toEqual(1.0);
    });

    it("gets view", function () {
      expect(page.view).toEqual([0, 0, 595.28, 841.89]);
    });
    it("gets view, with empty/invalid bounding boxes", function (done) {
      const viewLoadingTask = getDocument(
        buildGetDocumentParams("boundingBox_invalid.pdf")
      );

      viewLoadingTask.promise
        .then(pdfDoc => {
          const numPages = pdfDoc.numPages;
          expect(numPages).toEqual(3);

          const viewPromises = [];
          for (let i = 0; i < numPages; i++) {
            viewPromises[i] = pdfDoc.getPage(i + 1).then(pdfPage => {
              return pdfPage.view;
            });
          }

          Promise.all(viewPromises).then(([page1, page2, page3]) => {
            expect(page1).toEqual([0, 0, 612, 792]);
            expect(page2).toEqual([0, 0, 800, 600]);
            expect(page3).toEqual([0, 0, 600, 800]);

            viewLoadingTask.destroy().then(done);
          });
        })
        .catch(done.fail);
    });

    it("gets viewport", function () {
      const viewport = page.getViewport({ scale: 1.5, rotation: 90 });
      expect(viewport.viewBox).toEqual(page.view);
      expect(viewport.scale).toEqual(1.5);
      expect(viewport.rotation).toEqual(90);
      expect(viewport.transform).toEqual([0, 1.5, 1.5, 0, 0, 0]);
      expect(viewport.width).toEqual(1262.835);
      expect(viewport.height).toEqual(892.92);
    });
    it('gets viewport with "offsetX/offsetY" arguments', function () {
      const viewport = page.getViewport({
        scale: 1,
        rotation: 0,
        offsetX: 100,
        offsetY: -100,
      });
      expect(viewport.transform).toEqual([1, 0, 0, -1, 100, 741.89]);
    });
    it('gets viewport respecting "dontFlip" argument', function () {
      const scale = 1,
        rotation = 0;
      const viewport = page.getViewport({ scale, rotation });
      const dontFlipViewport = page.getViewport({
        scale,
        rotation,
        dontFlip: true,
      });

      expect(dontFlipViewport).not.toEqual(viewport);
      expect(dontFlipViewport).toEqual(viewport.clone({ dontFlip: true }));

      expect(viewport.transform).toEqual([1, 0, 0, -1, 0, 841.89]);
      expect(dontFlipViewport.transform).toEqual([1, 0, -0, 1, 0, 0]);
    });
    it("gets viewport with invalid rotation", function () {
      expect(function () {
        page.getViewport({ scale: 1, rotation: 45 });
      }).toThrow(
        new Error(
          "PageViewport: Invalid rotation, must be a multiple of 90 degrees."
        )
      );
    });

    it("gets annotations", function (done) {
      const defaultPromise = page.getAnnotations().then(function (data) {
        expect(data.length).toEqual(4);
      });

      const displayPromise = page
        .getAnnotations({ intent: "display" })
        .then(function (data) {
          expect(data.length).toEqual(4);
        });

      const printPromise = page
        .getAnnotations({ intent: "print" })
        .then(function (data) {
          expect(data.length).toEqual(4);
        });
      Promise.all([defaultPromise, displayPromise, printPromise])
        .then(function () {
          done();
        })
        .catch(done.fail);
    });

    it("gets annotations containing relative URLs (bug 766086)", function (done) {
      const filename = "bug766086.pdf";

      const defaultLoadingTask = getDocument(buildGetDocumentParams(filename));
      const defaultPromise = defaultLoadingTask.promise.then(function (pdfDoc) {
        return pdfDoc.getPage(1).then(function (pdfPage) {
          return pdfPage.getAnnotations();
        });
      });

      const docBaseUrlLoadingTask = getDocument(
        buildGetDocumentParams(filename, {
          docBaseUrl: "http://www.example.com/test/pdfs/qwerty.pdf",
        })
      );
      const docBaseUrlPromise = docBaseUrlLoadingTask.promise.then(function (
        pdfDoc
      ) {
        return pdfDoc.getPage(1).then(function (pdfPage) {
          return pdfPage.getAnnotations();
        });
      });

      const invalidDocBaseUrlLoadingTask = getDocument(
        buildGetDocumentParams(filename, {
          docBaseUrl: "qwerty.pdf",
        })
      );
      const invalidDocBaseUrlPromise = invalidDocBaseUrlLoadingTask.promise.then(
        function (pdfDoc) {
          return pdfDoc.getPage(1).then(function (pdfPage) {
            return pdfPage.getAnnotations();
          });
        }
      );

      Promise.all([defaultPromise, docBaseUrlPromise, invalidDocBaseUrlPromise])
        .then(function (data) {
          const defaultAnnotations = data[0];
          const docBaseUrlAnnotations = data[1];
          const invalidDocBaseUrlAnnotations = data[2];

          expect(defaultAnnotations[0].url).toBeUndefined();
          expect(defaultAnnotations[0].unsafeUrl).toEqual(
            "../../0021/002156/215675E.pdf#15"
          );

          expect(docBaseUrlAnnotations[0].url).toEqual(
            "http://www.example.com/0021/002156/215675E.pdf#15"
          );
          expect(docBaseUrlAnnotations[0].unsafeUrl).toEqual(
            "../../0021/002156/215675E.pdf#15"
          );

          expect(invalidDocBaseUrlAnnotations[0].url).toBeUndefined();
          expect(invalidDocBaseUrlAnnotations[0].unsafeUrl).toEqual(
            "../../0021/002156/215675E.pdf#15"
          );

          Promise.all([
            defaultLoadingTask.destroy(),
            docBaseUrlLoadingTask.destroy(),
            invalidDocBaseUrlLoadingTask.destroy(),
          ]).then(done);
        })
        .catch(done.fail);
    });

    it("gets text content", function (done) {
      const defaultPromise = page.getTextContent();
      const parametersPromise = page.getTextContent({
        normalizeWhitespace: true,
        disableCombineTextItems: true,
      });

      const promises = [defaultPromise, parametersPromise];
      Promise.all(promises)
        .then(function (data) {
          expect(!!data[0].items).toEqual(true);
          expect(data[0].items.length).toEqual(7);
          expect(!!data[0].styles).toEqual(true);

          // A simple check that ensures the two `textContent` object match.
          expect(JSON.stringify(data[0])).toEqual(JSON.stringify(data[1]));
          done();
        })
        .catch(done.fail);
    });

    it("gets text content, with correct properties (issue 8276)", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("issue8276_reduced.pdf")
      );

      loadingTask.promise
        .then(pdfDoc => {
          pdfDoc.getPage(1).then(pdfPage => {
            pdfPage.getTextContent().then(({ items, styles }) => {
              expect(items.length).toEqual(1);
              expect(Object.keys(styles)).toEqual(["Times"]);

              expect(items[0]).toEqual({
                dir: "ltr",
                fontName: "Times",
                height: 18,
                str: "Issue 8276",
                transform: [18, 0, 0, 18, 441.81, 708.4499999999999],
                width: 77.49,
              });
              expect(styles.Times).toEqual({
                fontFamily: "serif",
                ascent: NaN,
                descent: NaN,
                vertical: false,
              });

              loadingTask.destroy().then(done);
            });
          });
        })
        .catch(done.fail);
    });

    it("gets operator list", function (done) {
      const promise = page.getOperatorList();
      promise
        .then(function (oplist) {
          expect(!!oplist.fnArray).toEqual(true);
          expect(!!oplist.argsArray).toEqual(true);
          expect(oplist.lastChunk).toEqual(true);
          done();
        })
        .catch(done.fail);
    });

    it("gets operatorList with JPEG image (issue 4888)", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams("cmykjpeg.pdf"));

      loadingTask.promise
        .then(pdfDoc => {
          pdfDoc.getPage(1).then(pdfPage => {
            pdfPage.getOperatorList().then(opList => {
              const imgIndex = opList.fnArray.indexOf(OPS.paintImageXObject);
              const imgArgs = opList.argsArray[imgIndex];
              const { data } = pdfPage.objs.get(imgArgs[0]);

              expect(data instanceof Uint8ClampedArray).toEqual(true);
              expect(data.length).toEqual(90000);

              loadingTask.destroy().then(done);
            });
          });
        })
        .catch(done.fail);
    });

    it(
      "gets operatorList, from corrupt PDF file (issue 8702), " +
        "with/without `stopAtErrors` set",
      function (done) {
        const loadingTask1 = getDocument(
          buildGetDocumentParams("issue8702.pdf", {
            stopAtErrors: false, // The default value.
          })
        );
        const loadingTask2 = getDocument(
          buildGetDocumentParams("issue8702.pdf", {
            stopAtErrors: true,
          })
        );

        const result1 = loadingTask1.promise.then(pdfDoc => {
          return pdfDoc.getPage(1).then(pdfPage => {
            return pdfPage.getOperatorList().then(opList => {
              expect(opList.fnArray.length).toBeGreaterThan(100);
              expect(opList.argsArray.length).toBeGreaterThan(100);
              expect(opList.lastChunk).toEqual(true);

              return loadingTask1.destroy();
            });
          });
        });

        const result2 = loadingTask2.promise.then(pdfDoc => {
          return pdfDoc.getPage(1).then(pdfPage => {
            return pdfPage.getOperatorList().then(opList => {
              expect(opList.fnArray.length).toEqual(0);
              expect(opList.argsArray.length).toEqual(0);
              expect(opList.lastChunk).toEqual(true);

              return loadingTask2.destroy();
            });
          });
        });

        Promise.all([result1, result2]).then(done, done.fail);
      }
    );

    it("gets document stats after parsing page", function (done) {
      const promise = page.getOperatorList().then(function () {
        return pdfDocument.getStats();
      });
      const expectedStreamTypes = {};
      expectedStreamTypes[StreamType.FLATE] = true;
      const expectedFontTypes = {};
      expectedFontTypes[FontType.TYPE1] = true;
      expectedFontTypes[FontType.CIDFONTTYPE2] = true;

      promise
        .then(function (stats) {
          expect(stats).toEqual({
            streamTypes: expectedStreamTypes,
            fontTypes: expectedFontTypes,
          });
          done();
        })
        .catch(done.fail);
    });

    it("gets page stats after parsing page, without `pdfBug` set", function (done) {
      page
        .getOperatorList()
        .then(opList => {
          return page.stats;
        })
        .then(stats => {
          expect(stats).toEqual(null);
          done();
        }, done.fail);
    });
    it("gets page stats after parsing page, with `pdfBug` set", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams(basicApiFileName, { pdfBug: true })
      );

      loadingTask.promise
        .then(pdfDoc => {
          return pdfDoc.getPage(1).then(pdfPage => {
            return pdfPage.getOperatorList().then(opList => {
              return pdfPage.stats;
            });
          });
        })
        .then(stats => {
          expect(stats instanceof StatTimer).toEqual(true);
          expect(stats.times.length).toEqual(1);

          const [statEntry] = stats.times;
          expect(statEntry.name).toEqual("Page Request");
          expect(statEntry.end - statEntry.start).toBeGreaterThanOrEqual(0);

          loadingTask.destroy().then(done);
        }, done.fail);
    });
    it("gets page stats after rendering page, with `pdfBug` set", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams(basicApiFileName, { pdfBug: true })
      );
      let canvasAndCtx;

      loadingTask.promise
        .then(pdfDoc => {
          return pdfDoc.getPage(1).then(pdfPage => {
            const viewport = pdfPage.getViewport({ scale: 1 });
            canvasAndCtx = CanvasFactory.create(
              viewport.width,
              viewport.height
            );

            const renderTask = pdfPage.render({
              canvasContext: canvasAndCtx.context,
              canvasFactory: CanvasFactory,
              viewport,
            });
            return renderTask.promise.then(() => {
              return pdfPage.stats;
            });
          });
        })
        .then(stats => {
          expect(stats instanceof StatTimer).toEqual(true);
          expect(stats.times.length).toEqual(3);

          const [statEntryOne, statEntryTwo, statEntryThree] = stats.times;
          expect(statEntryOne.name).toEqual("Page Request");
          expect(statEntryOne.end - statEntryOne.start).toBeGreaterThanOrEqual(
            0
          );

          expect(statEntryTwo.name).toEqual("Rendering");
          expect(statEntryTwo.end - statEntryTwo.start).toBeGreaterThan(0);

          expect(statEntryThree.name).toEqual("Overall");
          expect(statEntryThree.end - statEntryThree.start).toBeGreaterThan(0);

          CanvasFactory.destroy(canvasAndCtx);
          loadingTask.destroy().then(done);
        }, done.fail);
    });

    it("cancels rendering of page", function (done) {
      const viewport = page.getViewport({ scale: 1 });
      const canvasAndCtx = CanvasFactory.create(
        viewport.width,
        viewport.height
      );

      const renderTask = page.render({
        canvasContext: canvasAndCtx.context,
        canvasFactory: CanvasFactory,
        viewport,
      });
      renderTask.cancel();

      renderTask.promise
        .then(function () {
          done.fail("shall cancel rendering");
        })
        .catch(function (error) {
          expect(error instanceof RenderingCancelledException).toEqual(true);
          expect(error.message).toEqual("Rendering cancelled, page 1");
          expect(error.type).toEqual("canvas");

          CanvasFactory.destroy(canvasAndCtx);
          done();
        });
    });

    it("re-render page, using the same canvas, after cancelling rendering", function (done) {
      const viewport = page.getViewport({ scale: 1 });
      const canvasAndCtx = CanvasFactory.create(
        viewport.width,
        viewport.height
      );

      const renderTask = page.render({
        canvasContext: canvasAndCtx.context,
        canvasFactory: CanvasFactory,
        viewport,
      });
      renderTask.cancel();

      renderTask.promise
        .then(
          () => {
            throw new Error("shall cancel rendering");
          },
          reason => {
            expect(reason instanceof RenderingCancelledException).toEqual(true);
          }
        )
        .then(() => {
          const reRenderTask = page.render({
            canvasContext: canvasAndCtx.context,
            canvasFactory: CanvasFactory,
            viewport,
          });
          return reRenderTask.promise;
        })
        .then(() => {
          CanvasFactory.destroy(canvasAndCtx);
          done();
        }, done.fail);
    });

    it("multiple render() on the same canvas", function (done) {
      const optionalContentConfigPromise = pdfDocument.getOptionalContentConfig();

      const viewport = page.getViewport({ scale: 1 });
      const canvasAndCtx = CanvasFactory.create(
        viewport.width,
        viewport.height
      );

      const renderTask1 = page.render({
        canvasContext: canvasAndCtx.context,
        canvasFactory: CanvasFactory,
        viewport,
        optionalContentConfigPromise,
      });
      const renderTask2 = page.render({
        canvasContext: canvasAndCtx.context,
        canvasFactory: CanvasFactory,
        viewport,
        optionalContentConfigPromise,
      });

      Promise.all([
        renderTask1.promise,
        renderTask2.promise.then(
          () => {
            done.fail("shall fail rendering");
          },
          reason => {
            /* it fails because we already using this canvas */
            expect(/multiple render\(\)/.test(reason.message)).toEqual(true);
          }
        ),
      ]).then(done);
    });

    it("cleans up document resources after rendering of page", function (done) {
      const loadingTask = getDocument(buildGetDocumentParams(basicApiFileName));
      let canvasAndCtx;

      loadingTask.promise
        .then(pdfDoc => {
          return pdfDoc.getPage(1).then(pdfPage => {
            const viewport = pdfPage.getViewport({ scale: 1 });
            canvasAndCtx = CanvasFactory.create(
              viewport.width,
              viewport.height
            );

            const renderTask = pdfPage.render({
              canvasContext: canvasAndCtx.context,
              canvasFactory: CanvasFactory,
              viewport,
            });
            return renderTask.promise.then(() => {
              return pdfDoc.cleanup();
            });
          });
        })
        .then(() => {
          expect(true).toEqual(true);

          CanvasFactory.destroy(canvasAndCtx);
          loadingTask.destroy().then(done);
        }, done.fail);
    });

    it("cleans up document resources during rendering of page", function (done) {
      const loadingTask = getDocument(
        buildGetDocumentParams("tracemonkey.pdf")
      );
      let canvasAndCtx;

      loadingTask.promise
        .then(pdfDoc => {
          return pdfDoc.getPage(1).then(pdfPage => {
            const viewport = pdfPage.getViewport({ scale: 1 });
            canvasAndCtx = CanvasFactory.create(
              viewport.width,
              viewport.height
            );

            const renderTask = pdfPage.render({
              canvasContext: canvasAndCtx.context,
              canvasFactory: CanvasFactory,
              viewport,
            });

            renderTask.onContinue = function (cont) {
              waitSome(cont);
            };

            return pdfDoc
              .cleanup()
              .then(
                () => {
                  throw new Error("shall fail cleanup");
                },
                reason => {
                  expect(reason instanceof Error).toEqual(true);
                  expect(reason.message).toEqual(
                    "startCleanup: Page 1 is currently rendering."
                  );
                }
              )
              .then(() => {
                return renderTask.promise;
              })
              .then(() => {
                CanvasFactory.destroy(canvasAndCtx);
                loadingTask.destroy().then(done);
              });
          });
        })
        .catch(done.fail);
    });

    it("caches image resources at the document/page level as expected (issue 11878)", async function () {
      const { NUM_PAGES_THRESHOLD } = GlobalImageCache,
        EXPECTED_WIDTH = 2550,
        EXPECTED_HEIGHT = 3300;

      const loadingTask = getDocument(buildGetDocumentParams("issue11878.pdf"));
      const pdfDoc = await loadingTask.promise;
      let firstImgData = null;

      for (let i = 1; i <= pdfDoc.numPages; i++) {
        const pdfPage = await pdfDoc.getPage(i);
        const opList = await pdfPage.getOperatorList();

        const { commonObjs, objs } = pdfPage;
        const imgIndex = opList.fnArray.indexOf(OPS.paintImageXObject);
        const [objId, width, height] = opList.argsArray[imgIndex];

        if (i < NUM_PAGES_THRESHOLD) {
          expect(objId).toEqual(`img_p${i - 1}_1`);

          expect(objs.has(objId)).toEqual(true);
          expect(commonObjs.has(objId)).toEqual(false);
        } else {
          expect(objId).toEqual(
            `g_${loadingTask.docId}_img_p${NUM_PAGES_THRESHOLD - 1}_1`
          );

          expect(objs.has(objId)).toEqual(false);
          expect(commonObjs.has(objId)).toEqual(true);
        }
        expect(width).toEqual(EXPECTED_WIDTH);
        expect(height).toEqual(EXPECTED_HEIGHT);

        // Ensure that the actual image data is identical for all pages.
        if (i === 1) {
          firstImgData = objs.get(objId);

          expect(firstImgData.width).toEqual(EXPECTED_WIDTH);
          expect(firstImgData.height).toEqual(EXPECTED_HEIGHT);

          expect(firstImgData.kind).toEqual(ImageKind.RGB_24BPP);
          expect(firstImgData.data instanceof Uint8ClampedArray).toEqual(true);
          expect(firstImgData.data.length).toEqual(25245000);
        } else {
          const objsPool = i >= NUM_PAGES_THRESHOLD ? commonObjs : objs;
          const currentImgData = objsPool.get(objId);

          expect(currentImgData.width).toEqual(firstImgData.width);
          expect(currentImgData.height).toEqual(firstImgData.height);

          expect(currentImgData.kind).toEqual(firstImgData.kind);
          expect(currentImgData.data instanceof Uint8ClampedArray).toEqual(
            true
          );
          expect(
            currentImgData.data.every((value, index) => {
              return value === firstImgData.data[index];
            })
          ).toEqual(true);
        }
      }

      await loadingTask.destroy();
      firstImgData = null;
    });
  });
  describe("Multiple `getDocument` instances", function () {
    // Regression test for https://github.com/mozilla/pdf.js/issues/6205
    // A PDF using the Helvetica font.
    const pdf1 = buildGetDocumentParams("tracemonkey.pdf");
    // A PDF using the Times font.
    const pdf2 = buildGetDocumentParams("TAMReview.pdf");
    // A PDF using the Arial font.
    const pdf3 = buildGetDocumentParams("issue6068.pdf");
    const loadingTasks = [];

    // Render the first page of the given PDF file.
    // Fulfills the promise with the base64-encoded version of the PDF.
    async function renderPDF(filename) {
      const loadingTask = getDocument(filename);
      loadingTasks.push(loadingTask);
      const pdf = await loadingTask.promise;
      const page = await pdf.getPage(1);
      const viewport = page.getViewport({ scale: 1.2 });
      const canvasAndCtx = CanvasFactory.create(
        viewport.width,
        viewport.height
      );
      const renderTask = page.render({
        canvasContext: canvasAndCtx.context,
        canvasFactory: CanvasFactory,
        viewport,
      });
      await renderTask.promise;
      const data = canvasAndCtx.canvas.toDataURL();
      CanvasFactory.destroy(canvasAndCtx);
      return data;
    }

    afterEach(function (done) {
      // Issue 6205 reported an issue with font rendering, so clear the loaded
      // fonts so that we can see whether loading PDFs in parallel does not
      // cause any issues with the rendered fonts.
      const destroyPromises = loadingTasks.map(function (loadingTask) {
        return loadingTask.destroy();
      });
      Promise.all(destroyPromises).then(done);
    });

    it("should correctly render PDFs in parallel", function (done) {
      let baseline1, baseline2, baseline3;
      const promiseDone = renderPDF(pdf1)
        .then(function (data1) {
          baseline1 = data1;
          return renderPDF(pdf2);
        })
        .then(function (data2) {
          baseline2 = data2;
          return renderPDF(pdf3);
        })
        .then(function (data3) {
          baseline3 = data3;
          return Promise.all([
            renderPDF(pdf1),
            renderPDF(pdf2),
            renderPDF(pdf3),
          ]);
        })
        .then(function (dataUrls) {
          expect(dataUrls[0]).toEqual(baseline1);
          expect(dataUrls[1]).toEqual(baseline2);
          expect(dataUrls[2]).toEqual(baseline3);
          return true;
        });
      promiseDone
        .then(function () {
          done();
        })
        .catch(done.fail);
    });
  });

  describe("PDFDataRangeTransport", function () {
    let dataPromise;

    beforeAll(function (done) {
      const fileName = "tracemonkey.pdf";
      dataPromise = DefaultFileReaderFactory.fetch({
        path: TEST_PDFS_PATH + fileName,
      });
      done();
    });

    afterAll(function () {
      dataPromise = null;
    });

    it("should fetch document info and page using ranges", function (done) {
      const initialDataLength = 4000;
      let fetches = 0,
        loadingTask;

      dataPromise
        .then(function (data) {
          const initialData = data.subarray(0, initialDataLength);
          const transport = new PDFDataRangeTransport(data.length, initialData);
          transport.requestDataRange = function (begin, end) {
            fetches++;
            waitSome(function () {
              transport.onDataProgress(4000);
              transport.onDataRange(begin, data.subarray(begin, end));
            });
          };
          loadingTask = getDocument(transport);
          return loadingTask.promise;
        })
        .then(function (pdfDocument) {
          expect(pdfDocument.numPages).toEqual(14);

          return pdfDocument.getPage(10);
        })
        .then(function (pdfPage) {
          expect(pdfPage.rotate).toEqual(0);
          expect(fetches).toBeGreaterThan(2);

          loadingTask.destroy().then(done);
        })
        .catch(done.fail);
    });

    it("should fetch document info and page using range and streaming", function (done) {
      const initialDataLength = 4000;
      let fetches = 0,
        loadingTask;

      dataPromise
        .then(function (data) {
          const initialData = data.subarray(0, initialDataLength);
          const transport = new PDFDataRangeTransport(data.length, initialData);
          transport.requestDataRange = function (begin, end) {
            fetches++;
            if (fetches === 1) {
              // Send rest of the data on first range request.
              transport.onDataProgressiveRead(data.subarray(initialDataLength));
            }
            waitSome(function () {
              transport.onDataRange(begin, data.subarray(begin, end));
            });
          };
          loadingTask = getDocument(transport);
          return loadingTask.promise;
        })
        .then(function (pdfDocument) {
          expect(pdfDocument.numPages).toEqual(14);

          return pdfDocument.getPage(10);
        })
        .then(function (pdfPage) {
          expect(pdfPage.rotate).toEqual(0);
          expect(fetches).toEqual(1);

          waitSome(function () {
            loadingTask.destroy().then(done);
          });
        })
        .catch(done.fail);
    });

    it(
      "should fetch document info and page, without range, " +
        "using complete initialData",
      function (done) {
        let fetches = 0,
          loadingTask;

        dataPromise
          .then(function (data) {
            const transport = new PDFDataRangeTransport(
              data.length,
              data,
              /* progressiveDone = */ true
            );
            transport.requestDataRange = function (begin, end) {
              fetches++;
            };
            loadingTask = getDocument({ disableRange: true, range: transport });
            return loadingTask.promise;
          })
          .then(function (pdfDocument) {
            expect(pdfDocument.numPages).toEqual(14);

            return pdfDocument.getPage(10);
          })
          .then(function (pdfPage) {
            expect(pdfPage.rotate).toEqual(0);
            expect(fetches).toEqual(0);

            loadingTask.destroy().then(done);
          })
          .catch(done.fail);
      }
    );
  });
});