Upload.test.mjs

// @ts-check

import { ok, rejects, strictEqual } from "node:assert";
import { describe, it } from "node:test";

import Upload from "./Upload.mjs";

describe(
  "Class `Upload`.",
  {
    concurrency: true,
  },
  () => {
    it("Resolving a file.", async () => {
      const upload = new Upload();

      ok(upload.promise instanceof Promise);
      strictEqual(typeof upload.resolve, "function");

      /** @type {any} */
      const file = {};

      upload.resolve(file);

      const resolved = await upload.promise;

      strictEqual(resolved, file);
      strictEqual(upload.file, file);
    });

    it("Handled rejection.", async () => {
      const upload = new Upload();

      ok(upload.promise instanceof Promise);
      strictEqual(typeof upload.reject, "function");

      const error = new Error("Message.");

      upload.reject(error);

      // This is the safe way to check the promise status, see:
      // https://github.com/nodejs/node/issues/31392#issuecomment-575451230
      await rejects(Promise.race([upload.promise, Promise.resolve()]), error);
    });

    it("Unhandled rejection.", async () => {
      const upload = new Upload();

      ok(upload.promise instanceof Promise);
      strictEqual(typeof upload.reject, "function");

      const error = new Error("Message.");

      upload.reject(error);

      // Node.js CLI flag `--unhandled-rejections=throw` must be used when these
      // tests are run with Node.js v14 (it’s unnecessary for Node.js v15+) or
      // the process won’t exit with an error if the unhandled rejection is’t
      // silenced as intended.
    });
  },
);