@plugjs/expect5 0.4.4 → 0.4.5

package/dist/expectation/expectations.mjs

@@ -0,0 +1,530 @@
+// expectation/expectations.ts
+import { diff } from "./diff.mjs";
+import { toInclude, toMatchContents } from "./include.mjs";
+import {
+  ExpectationError,
+  isMatcher,
+  prefixType,
+  stringifyConstructor,
+  stringifyValue,
+  typeOf
+} from "./types.mjs";
+var Expectations = class {
+  /**
+   * Create an {@link Expectations} instance associated with the specified
+   * value and error remarks.
+   *
+   * Optionally a parent {@link Expectations} instance can be specified.
+   */
+  constructor(value, remarks, parent) {
+    this.value = value;
+    this.remarks = remarks;
+    this.parent = parent;
+    this.not = new NegativeExpectations(this);
+  }
+  /** The {@link NegativeExpectations} associated with _this_ */
+  not;
+  /** Throw an {@link ExpectationError} associated with _this_ */
+  _fail(details, diff2) {
+    throw new ExpectationError(this, details, diff2);
+  }
+  /* ------------------------------------------------------------------------ *
+   * BASIC                                                                    *
+   * ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be of the specified _extended_ {@link TypeName type},
+   * and (if specified) further asserts it with an {@link AssertionFunction}.
+   *
+   * Negation: {@link NegativeExpectations.toBeA `not.toBeA(...)`}
+   */
+  toBeA(type, assertion) {
+    if (typeOf(this.value) === type) {
+      if (assertion)
+        assertion(this);
+      return this;
+    }
+    this._fail(`to be ${prefixType(type)}`);
+  }
+  toBeCloseTo(value, delta) {
+    const min = value - delta;
+    const max = value + delta;
+    return this.toBeWithinRange(min, max);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be neither `null` nor `undefined`.
+   *
+   * Negation: {@link NegativeExpectations.toBeDefined `not.toBeDefined()`}
+   */
+  toBeDefined() {
+    if (this.value !== null && this.value !== void 0)
+      return this;
+    this._fail(`to be neither ${stringifyValue(null)} nor ${stringifyValue(void 0)}`);
+  }
+  toBeError(constructorOrMessage, maybeMessage) {
+    const [constructor, message] = typeof constructorOrMessage === "function" ? [constructorOrMessage, maybeMessage] : [Error, constructorOrMessage];
+    if (message === void 0)
+      return this.toBeInstanceOf(constructor);
+    return this.toBeInstanceOf(constructor, (assert) => {
+      assert.toHaveProperty("message", (assertMessage) => {
+        assertMessage.toBeA("string");
+        if (typeof message === "string")
+          assertMessage.toStrictlyEqual(message);
+        else
+          assertMessage.toMatch(message);
+      });
+    });
+  }
+  /* ------------------------------------------------------------------------ */
+  /** Expects the value strictly equal to `false`. */
+  toBeFalse() {
+    return this.toStrictlyEqual(false);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be _falsy_ (zero, empty string, `false`, ...).
+   *
+   * Negation: {@link Expectations.toBeTruthy `toBeTruthy()`}
+   */
+  toBeFalsy() {
+    if (!this.value)
+      return this;
+    this._fail("to be falsy");
+  }
+  toBeGreaterThan(value) {
+    this.toBeA(typeof value);
+    if (this.value > value)
+      return this;
+    this._fail(`to be greater than ${stringifyValue(value)}`);
+  }
+  toBeGreaterThanOrEqual(value) {
+    this.toBeA(typeof value);
+    if (this.value >= value)
+      return this;
+    this._fail(`to be greater than or equal to ${stringifyValue(value)}`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be an instance of the specified {@link Constructor},
+   * and (if specified) further asserts it with an {@link AssertionFunction}.
+   *
+   * Negation: {@link NegativeExpectations.toBeInstanceOf `not.toInstanceOf(...)`}
+   */
+  toBeInstanceOf(constructor, assertion) {
+    if (this.value instanceof constructor) {
+      if (assertion)
+        assertion(this);
+      return this;
+    }
+    this._fail(`to be an instance of ${stringifyConstructor(constructor)}`);
+  }
+  toBeLessThan(value) {
+    this.toBeA(typeof value);
+    if (this.value < value)
+      return this;
+    this._fail(`to be less than ${stringifyValue(value)}`);
+  }
+  toBeLessThanOrEqual(value) {
+    this.toBeA(typeof value);
+    if (this.value <= value)
+      return this;
+    this._fail(`to be less than or equal to ${stringifyValue(value)}`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be `NaN`.
+   *
+   * Negation: {@link NegativeExpectations.toBeNaN `not.toBeNaN()`}
+   */
+  toBeNaN() {
+    const expectations = this.toBeA("number");
+    if (isNaN(expectations.value))
+      return expectations;
+    this._fail(`to be ${stringifyValue(NaN)}`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /** Expects the value to strictly equal `null`. */
+  toBeNull() {
+    return this.toStrictlyEqual(null);
+  }
+  /* ------------------------------------------------------------------------ */
+  /** Expects the value to strictly equal `true`. */
+  toBeTrue() {
+    return this.toStrictlyEqual(true);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be _falsy_ (non-zero, non-empty string, ...).
+   *
+   * Negation: {@link Expectations.toBeFalsy `toBeFalsy()`}
+   */
+  toBeTruthy() {
+    if (this.value)
+      return this;
+    this._fail("to be truthy");
+  }
+  /* ------------------------------------------------------------------------ */
+  /** Expects the value to strictly equal `undefined`. */
+  toBeUndefined() {
+    return this.toStrictlyEqual(void 0);
+  }
+  toBeWithinRange(min, max) {
+    if (max < min) {
+      const num = max;
+      max = min;
+      min = num;
+    }
+    this.toBeA(typeof min);
+    if (this.value < min || this.value > max) {
+      this._fail(`to be within ${stringifyValue(min)}...${stringifyValue(max)}`);
+    }
+    return this;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be _deep equal to_ the specified expected one.
+   *
+   * Negation: {@link NegativeExpectations.toEqual `not.toEqual(...)`}
+   */
+  toEqual(expected) {
+    if (this.value === expected)
+      return this;
+    const result = diff(this.value, expected);
+    if (result.diff) {
+      if (isMatcher(expected)) {
+        this._fail("to satisfy expectation matcher", result);
+      } else {
+        this._fail(`to equal ${stringifyValue(expected)}`, result);
+      }
+    } else {
+      return this;
+    }
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to have a `number` _property_ `length` with the specified
+   * expected value.
+   *
+   * Negation: {@link NegativeExpectations.toHaveLength `not.toHaveLength(...)`}
+   */
+  toHaveLength(length) {
+    this.toBeDefined();
+    const realLength = this.value["length"];
+    if (typeof realLength !== "number") {
+      this._fail('to have a numeric "length" property');
+    } else if (realLength !== length) {
+      this._fail(`to have length ${length}`);
+    }
+    return this;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to have the specified _property_ and (if specified)
+   * further asserts its value with an {@link AssertionFunction}.
+   *
+   * Negation: {@link NegativeExpectations.toHaveProperty `not.toHaveProperty(...)`}
+   */
+  toHaveProperty(property, assertion) {
+    this.toBeDefined();
+    const propertyValue = this.value[property];
+    if (propertyValue === void 0) {
+      this._fail(`to have property "${String(property)}"`);
+    }
+    if (assertion) {
+      try {
+        const parent = { expectations: this, prop: property };
+        const expectations = new Expectations(propertyValue, this.remarks, parent);
+        assertion(expectations);
+      } catch (error) {
+        if (error instanceof ExpectationError && error.diff) {
+          error.diff = {
+            diff: true,
+            value: this.value,
+            props: { [property]: error.diff }
+          };
+        }
+        throw error;
+      }
+    }
+    return this;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to have a `number` _property_ `size` with the specified
+   * expected value.
+   *
+   * Negation: {@link NegativeExpectations.toHaveSize `not.toHaveSize(...)`}
+   */
+  toHaveSize(size) {
+    this.toBeDefined();
+    const realSize = this.value["size"];
+    if (typeof realSize !== "number") {
+      this._fail('to have a numeric "size" property');
+    } else if (realSize !== size) {
+      this._fail(`to have size ${size}`);
+    }
+    return this;
+  }
+  toInclude(contents) {
+    toInclude(this, false, contents);
+    return this;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be a `string` _matching_ the specified sub-`string`
+   * or {@link RegExp}.
+   *
+   * Negation: {@link NegativeExpectations.toMatch `not.toMatch(...)`}
+   */
+  toMatch(matcher) {
+    const expectations = this.toBeA("string");
+    if (expectations.value.match(matcher))
+      return expectations;
+    this._fail(`to match ${stringifyValue(matcher)}`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expect the value to be an {@link Iterable} object includind _all_ values
+   * (and only those values) from the specified _array_ or {@link Set},
+   * in any order.
+   */
+  toMatchContents(contents) {
+    toMatchContents(this, contents);
+    return this;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be _strictly equal to_ the specified expected one.
+   *
+   * Negation: {@link NegativeExpectations.toStrictlyEqual `not.toStrictlyEqual(...)`}
+   */
+  toStrictlyEqual(expected) {
+    if (this.value === expected)
+      return this;
+    const diff2 = { diff: true, value: this.value, expected };
+    this._fail(`to strictly equal ${stringifyValue(expected)}`, diff2);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be a `function` throwing, and (if specified) further
+   * asserts the thrown value with an {@link AssertionFunction}.
+   *
+   * Negation: {@link NegativeExpectations.toThrow `not.toThrow()`}
+   */
+  toThrow(assert) {
+    const func = this.toBeA("function");
+    let passed = false;
+    try {
+      func.value();
+      passed = true;
+    } catch (thrown) {
+      if (assert)
+        assert(new Expectations(thrown, this.remarks));
+    }
+    if (passed)
+      this._fail("to throw");
+    return this;
+  }
+  toThrowError(constructorOrMessage, maybeMessage) {
+    const [constructor, message] = typeof constructorOrMessage === "function" ? [constructorOrMessage, maybeMessage] : [Error, constructorOrMessage];
+    return this.toThrow((assert) => assert.toBeError(constructor, message));
+  }
+};
+var NegativeExpectations = class {
+  /**
+   * Create a {@link NegativeExpectations} instance associated with the
+   * specified (positive) {@link Expectations}.
+   */
+  constructor(_expectations) {
+    this._expectations = _expectations;
+    this._value = _expectations.value;
+  }
+  /** For convenience, the value associated with the {@link Expectations} */
+  _value;
+  /** Throw an {@link ExpectationError} associated with _this_ */
+  _fail(details, diff2) {
+    throw new ExpectationError(this._expectations, details, diff2);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value _**NOT**_ to be of the specified _extended_
+   * {@link TypeName type}.
+   *
+   * Negates: {@link Expectations.toBeA `toBeA(...)`}
+   */
+  toBeA(type) {
+    if (typeOf(this._value) !== type)
+      return this._expectations;
+    this._fail(`not to be ${prefixType(type)}`);
+  }
+  toBeCloseTo(value, delta) {
+    const min = value - delta;
+    const max = value + delta;
+    return this.toBeWithinRange(min, max);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be either `null` or `undefined`.
+   *
+   * Negates: {@link Expectations.toBeDefined `toBeDefined()`}
+   */
+  toBeDefined() {
+    if (this._value === null || this._value === void 0) {
+      return this._expectations;
+    }
+    this._fail(`to be ${stringifyValue(null)} or ${stringifyValue(void 0)}`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value _**NOT**_ to be an instance of the specified
+   * {@link Constructor}.
+   *
+   * Negates: {@link Expectations.toBeInstanceOf `toBeInstanceOf(...)`}
+   */
+  toBeInstanceOf(constructor) {
+    if (this._value instanceof constructor) {
+      this._fail(`not to be an instance of ${stringifyConstructor(constructor)}`);
+    }
+    return this._expectations;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value _**NOT**_ to be `NaN`.
+   *
+   * Negates: {@link Expectations.toBeNaN `toBeNaN()`}
+   */
+  toBeNaN() {
+    const expectations = this._expectations.toBeA("number");
+    if (isNaN(expectations.value))
+      this._fail(`not to be ${stringifyValue(NaN)}`);
+    return expectations;
+  }
+  toBeWithinRange(min, max) {
+    if (max < min) {
+      const num = max;
+      max = min;
+      min = num;
+    }
+    this._expectations.toBeA(typeof min);
+    if (this._value >= min && this._value <= max) {
+      this._fail(`not to be within ${stringifyValue(min)}...${stringifyValue(max)}`);
+    }
+    return this._expectations;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value _**NOT**_ to be _deep equal to_ the specified expected
+   * one.
+   *
+   * Negates: {@link Expectations.toEqual `toEqual(...)`}
+   */
+  toEqual(expected) {
+    let result = { diff: false, value: this._value };
+    if (this._value !== expected) {
+      result = diff(this._value, expected);
+      if (result.diff)
+        return this._expectations;
+    }
+    if (isMatcher(expected)) {
+      this._fail("not to satisfy expectation matcher", result);
+    } else {
+      this._fail(`not to equal ${stringifyValue(expected)}`, result);
+    }
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to have a `number` _property_ `length` _different_ from
+   * the specified expected value.
+   *
+   * Negates: {@link Expectations.toHaveLength `toHaveLength(...)`}
+   */
+  toHaveLength(length) {
+    this._expectations.toBeDefined();
+    const realLength = this._value["length"];
+    if (typeof realLength !== "number") {
+      this._fail('to have a numeric "length" property');
+    } else if (realLength === length) {
+      this._fail(`not to have length ${length}`);
+    }
+    return this._expectations;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value _**NOT**_ to have the specified _property_.
+   *
+   * Negates: {@link Expectations.toHaveProperty `toHaveProperty(...)`}
+   */
+  toHaveProperty(property) {
+    this._expectations.toBeDefined();
+    const propertyValue = this._value[property];
+    if (propertyValue === void 0)
+      return this._expectations;
+    this._fail(`not to have property "${String(property)}"`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to have a `number` _property_ `size` _different_ from
+   * the specified expected value.
+   *
+   * Negates: {@link Expectations.toHaveSize `toHaveSize(...)`}
+   */
+  toHaveSize(size) {
+    this._expectations.toBeDefined();
+    const realSize = this._value["size"];
+    if (typeof realSize !== "number") {
+      this._fail('to have a numeric "size" property');
+    } else if (realSize === size) {
+      this._fail(`not to have size ${size}`);
+    }
+    return this._expectations;
+  }
+  toInclude(contents) {
+    toInclude(this._expectations, true, contents);
+    return this._expectations;
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be a `string` _**NOT MATCHING**_ the specified
+   * sub-`string` or {@link RegExp}.
+   *
+   * Negates: {@link Expectations.toMatch `toMatch(...)`}
+   */
+  toMatch(matcher) {
+    const expectations = this._expectations.toBeA("string");
+    if (!expectations.value.match(matcher))
+      return expectations;
+    this._fail(`not to match ${stringifyValue(matcher)}`);
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value to be a `function` not throwing anything.
+   *
+   * Negates: {@link Expectations.toThrow `toThrow(...)`}
+   */
+  toThrow() {
+    const expectations = this._expectations.toBeA("function");
+    try {
+      expectations.value();
+      return expectations;
+    } catch (caught) {
+      this._fail("not to throw");
+    }
+  }
+  /* ------------------------------------------------------------------------ */
+  /**
+   * Expects the value _**NOT**_ to be _strictly equal to_ the specified
+   * expected one.
+   *
+   * Negates: {@link Expectations.toStrictlyEqual `toStrictlyEqual(...)`}
+   */
+  toStrictlyEqual(expected) {
+    if (this._value !== expected)
+      return this._expectations;
+    this._fail(`not to strictly equal ${stringifyValue(expected)}`);
+  }
+};
+export {
+  Expectations,
+  NegativeExpectations
+};
+//# sourceMappingURL=expectations.mjs.map

package/dist/expectation/expectations.mjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/expectation/expectations.ts"],
+  "mappings": "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",
+  "names": ["diff"]
+}

package/dist/expectation/include.cjs

@@ -26,45 +26,45 @@ __export(include_exports, {
 module.exports = __toCommonJS(include_exports);
 var import_diff = require("./diff.cjs");
 var import_types = require("./types.cjs");
-function toInclude(expected) {
-  if (expected instanceof Map)
-    return includesMappings(this, expected);
-  if (expected instanceof Set)
-    return includesValues(this, expected);
-  if (Array.isArray(expected))
-    return includesValues(this, new Set(expected));
-  if (expected instanceof Object)
-    return includesProps(this, expected);
-  throw new TypeError(`Invalid type for "toInclude(...)": ${(0, import_types.stringifyValue)(expected)}`);
+function toInclude(expectations, negative, contents) {
+  if (contents instanceof Map)
+    return includesMappings(expectations, negative, contents);
+  if (contents instanceof Set)
+    return includesValues(expectations, negative, contents);
+  if (Array.isArray(contents))
+    return includesValues(expectations, negative, new Set(contents));
+  if (contents instanceof Object)
+    return includesProps(expectations, negative, contents);
+  throw new TypeError(`Invalid type for "toInclude(...)": ${(0, import_types.stringifyValue)(contents)}`);
 }
-function toMatchContents(contents) {
+function toMatchContents(expectations, contents) {
   let actual;
   let expected;
   try {
-    actual = new Set(this.value);
+    actual = new Set(expectations.value);
     expected = new Set(contents);
   } catch (error) {
-    throw new import_types.ExpectationError(this, "to be an iterable object", false);
+    throw new import_types.ExpectationError(expectations, "to be an iterable object");
   }
   const result = (0, import_diff.diff)(actual, expected);
   delete result.error;
-  if (result.diff === this.negative)
-    return this.expects;
+  if (!result.diff)
+    return;
   throw new import_types.ExpectationError(
-    this,
+    expectations,
     `to match contents of ${(0, import_types.stringifyObjectType)(contents)}`,
-    { ...result, value: this.value }
+    { ...result, value: expectations.value }
   );
 }
-function includesProps(context, expected) {
-  if (context.value instanceof Map) {
-    return includesMappings(context, new Map(Object.entries(expected)));
+function includesProps(expectations, negative, expected) {
+  if (expectations.value instanceof Map) {
+    return includesMappings(expectations, negative, new Map(Object.entries(expected)));
   }
-  context.expects.toBeInstanceOf(Object);
-  const actual = context.value;
+  expectations.toBeInstanceOf(Object);
+  const actual = expectations.value;
   const keys = new Set(Object.keys(expected));
   const props = {};
-  if (context.negative) {
+  if (negative) {
     for (const key of keys) {
       if (actual[key] !== void 0 || key in actual) {
         props[key] = { diff: true, extra: actual[key] };
@@ -86,22 +86,23 @@ function includesProps(context, expected) {
   }
   const count = Object.keys(props).length;
   if (count === 0)
-    return context.expects;
+    return;
   const type = count === 1 ? "property" : "properties";
-  throw new import_types.ExpectationError(context, `to include ${count} ${type}`, {
+  const not = negative ? "not " : "";
+  throw new import_types.ExpectationError(expectations, `${not}to include ${count} ${type}`, {
     diff: true,
     value: actual,
     props
   });
 }
-function includesValues(context, expected) {
-  context.expects.toBeInstanceOf(Object);
-  if (typeof context.value[Symbol.iterator] !== "function") {
-    throw new import_types.ExpectationError(context, "to be an iterable object", false);
+function includesValues(expectations, negative, expected) {
+  expectations.toBeInstanceOf(Object);
+  if (typeof expectations.value[Symbol.iterator] !== "function") {
+    throw new import_types.ExpectationError(expectations, "to be an iterable object");
   }
-  const actual = new Set(context.value);
+  const actual = new Set(expectations.value);
   const values = [];
-  if (context.negative) {
+  if (negative) {
     for (const exp of expected) {
       for (const act of actual) {
         const result = (0, import_diff.diff)(act, exp);
@@ -128,20 +129,20 @@ function includesValues(context, expected) {
   }
   const count = values.length;
   if (count === 0)
-    return context.expects;
+    return;
   const type = count === 1 ? "value" : "values";
-  throw new import_types.ExpectationError(context, `to include ${count} ${type}`, {
+  const not = negative ? "not " : "";
+  throw new import_types.ExpectationError(expectations, `${not}to include ${count} ${type}`, {
     diff: true,
-    value: context.value,
+    value: expectations.value,
     values
   });
 }
-function includesMappings(context, expected) {
-  context.expects.toBeInstanceOf(Map);
-  const actual = context.value;
+function includesMappings(expectations, negative, expected) {
+  const actual = expectations.toBeInstanceOf(Map).value;
   const keys = new Set(expected.keys());
   const mappings = [];
-  if (context.negative) {
+  if (negative) {
     for (const key of keys) {
       if (actual.has(key)) {
         mappings.push([key, { diff: true, extra: actual.get(key) }]);
@@ -160,11 +161,12 @@ function includesMappings(context, expected) {
   }
   const count = mappings.length;
   if (count === 0)
-    return context.expects;
+    return;
   const type = count === 1 ? "mapping" : "mappings";
-  throw new import_types.ExpectationError(context, `to include ${count} ${type}`, {
+  const not = negative ? "not " : "";
+  throw new import_types.ExpectationError(expectations, `${not}to include ${count} ${type}`, {
     diff: true,
-    value: context.value,
+    value: expectations.value,
     mappings
   });
 }