xunit.ts 1.4.0 → 3.0.0

package/dist/src/Runners/TestSuiteRunner.js

@@ -20,10 +20,10 @@ class TestSuiteRunner {
     }
     runSuite(suite, filters) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield Promise.all(this.reporters.map(r => r.suiteStarted(suite)));
+            this.reporters.map(r => r.suiteStarted(suite));
             const tests = suite.getTests(filters);
             const results = yield this.runTests(suite, tests);
-            yield Promise.all(this.reporters.map(r => r.suiteCompleted(suite, results)));
+            this.reporters.map(r => r.suiteCompleted(suite, results));
             return results;
         });
     }
@@ -31,7 +31,7 @@ class TestSuiteRunner {
         return __awaiter(this, void 0, void 0, function* () {
             const results = new TestSuiteResults_1.default(suite);
             if (tests === undefined || tests === null || Object.keys(tests).length === 0) {
-                yield Promise.all(this.reporters.map(r => r.testIncomplete(suite, "(no tests found)")));
+                this.reporters.map(r => r.testIncomplete(suite, "(no tests found)"));
                 return results;
             }
             const test_names = Object.keys(tests);

package/dist/src/Runners/TestSuiteRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"TestSuiteRunner.js","sourceRoot":"","sources":["../../../src/Runners/TestSuiteRunner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA,qFAA6D;AAI7D,MAAqB,eAAe;IAEnC,YAA6B,MAAkB,EAAmB,SAAwC;QAA7E,WAAM,GAAN,MAAM,CAAY;QAAmB,cAAS,GAAT,SAAS,CAA+B;IAC1G,CAAC;IAEK,QAAQ,CAAC,KAAgB,EAAE,OAAiB;;YACjD,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAC7E,OAAO,OAAO,CAAC;QAChB,CAAC;KAAA;IAEK,QAAQ,CAAC,KAAgB,EAAE,KAA+B;;YAC/D,MAAM,OAAO,GAAG,IAAI,0BAAgB,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC7E,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;gBACxF,OAAO,OAAO,CAAC;aACf;YAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE;gBAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;aAChC;YAED,OAAO,OAAO,CAAC;QAChB,CAAC;KAAA;CACD;AA5BD,kCA4BC"}
+{"version":3,"file":"TestSuiteRunner.js","sourceRoot":"","sources":["../../../src/Runners/TestSuiteRunner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA,qFAA6D;AAI7D,MAAqB,eAAe;IAEnC,YAA6B,MAAkB,EAAmB,SAAoC;QAAzE,WAAM,GAAN,MAAM,CAAY;QAAmB,cAAS,GAAT,SAAS,CAA2B;IACtG,CAAC;IAEK,QAAQ,CAAC,KAAgB,EAAE,OAAiB;;YACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1D,OAAO,OAAO,CAAC;QAChB,CAAC;KAAA;IAEK,QAAQ,CAAC,KAAgB,EAAE,KAAuC;;YACvE,MAAM,OAAO,GAAG,IAAI,0BAAgB,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC;gBACrE,OAAO,OAAO,CAAC;YAChB,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC;YAED,OAAO,OAAO,CAAC;QAChB,CAAC;KAAA;CACD;AA5BD,kCA4BC"}

package/dist/xunit.d.ts

@@ -1,5 +1,5 @@
+import Assert from "./src/Assertions";
 import Test from "./src/Framework/Test";
 import TestSuite from "./src/Framework/TestSuite";
-import Assert from "./src/Assertions";
-export { Test, TestSuite, Assert };
+export { Assert, Test, TestSuite };
 //# sourceMappingURL=xunit.d.ts.map

package/dist/xunit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xunit.d.ts","sourceRoot":"","sources":["../xunit.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,SAAS,MAAM,2BAA2B,CAAC;AAClD,OAAO,MAAM,MAAM,kBAAkB,CAAC;AAEtC,OAAO,EACN,IAAI,EACJ,SAAS,EACT,MAAM,EACN,CAAC"}
+{"version":3,"file":"xunit.d.ts","sourceRoot":"","sources":["../xunit.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,IAAI,MAAM,sBAAsB,CAAC;AACxC,OAAO,SAAS,MAAM,2BAA2B,CAAC;AAElD,OAAO,EACN,MAAM,EACN,IAAI,EACJ,SAAS,EAAE,CAAC"}

package/dist/xunit.js

@@ -3,11 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Assert = exports.TestSuite = exports.Test = void 0;
+exports.TestSuite = exports.Test = exports.Assert = void 0;
+const Assertions_1 = __importDefault(require("./src/Assertions"));
+exports.Assert = Assertions_1.default;
 const Test_1 = __importDefault(require("./src/Framework/Test"));
 exports.Test = Test_1.default;
 const TestSuite_1 = __importDefault(require("./src/Framework/TestSuite"));
 exports.TestSuite = TestSuite_1.default;
-const Assertions_1 = __importDefault(require("./src/Assertions"));
-exports.Assert = Assertions_1.default;
 //# sourceMappingURL=xunit.js.map

package/dist/xunit.js.map

@@ -1 +1 @@
-{"version":3,"file":"xunit.js","sourceRoot":"","sources":["../xunit.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAwC;AAKvC,eALM,cAAI,CAKN;AAJL,0EAAkD;AAKjD,oBALM,mBAAS,CAKN;AAJV,kEAAsC;AAKrC,iBALM,oBAAM,CAKN"}
+{"version":3,"file":"xunit.js","sourceRoot":"","sources":["../xunit.ts"],"names":[],"mappings":";;;;;;AAAA,kEAAsC;AAKrC,iBALM,oBAAM,CAKN;AAJP,gEAAwC;AAKvC,eALM,cAAI,CAKN;AAJL,0EAAkD;AAKjD,oBALM,mBAAS,CAKN"}

package/eslint.config.ts

@@ -0,0 +1,44 @@
+import js from "@eslint/js";
+import stylistic from "@stylistic/eslint-plugin";
+import { defineConfig } from "eslint/config";
+import sort from "eslint-plugin-simple-import-sort";
+import tseslint from "typescript-eslint";
+
+export default defineConfig([
+	{
+		ignores: ["dist"]
+	},
+	{
+		languageOptions: {
+			parser: tseslint.parser,
+			parserOptions: { projectService: true }
+		},
+		plugins: {
+			"@stylistic": stylistic,
+			"simple-import-sort": sort
+		},
+		files: ["**/*.ts"],
+		extends: [
+			js.configs.recommended,
+			tseslint.configs.recommended,
+			tseslint.configs.strictTypeChecked,
+			tseslint.configs.stylisticTypeChecked
+		],
+		rules: {
+			"indent": ["warn", "tab"],
+			"quotes": ["warn", "double"],
+
+			"simple-import-sort/imports": "warn",
+			"simple-import-sort/exports": "warn",
+			"sort-imports": "off",
+
+			"@stylistic/object-curly-spacing": ["warn", "always"],
+			"@stylistic/semi": ["error", "always"],
+
+			"@typescript-eslint/no-confusing-void-expression": "off",
+			"@typescript-eslint/no-extraneous-class": "off",
+			"@typescript-eslint/no-unsafe-function-type": "off",
+			"@typescript-eslint/restrict-template-expressions": "off"
+		}
+	}
+]);

package/package.json

@@ -1,35 +1,39 @@
 {
 	"name": "xunit.ts",
-	"version": "1.4.0",
+	"version": "3.0.0",
 	"description": "A unit testing framework for TypeScript, following standard xUnit patterns",
 	"main": "dist/xunit.js",
 	"author": "ecoAPM LLC",
 	"homepage": "https://github.com/ecoAPM/xunit.ts",
+	"repository": "https://github.com/ecoAPM/xunit.ts",
 	"bugs": "https://github.com/ecoAPM/xunit.ts/issues",
 	"license": "MIT",
 	"engines": {
-		"node": ">= 14"
+		"node": ">= 24"
 	},
 	"dependencies": {
 		"colors": "1.4.0",
-		"command-line-args": "5.2.1",
-		"command-line-usage": "7.0.1",
+		"command-line-args": "6.0.2",
+		"command-line-usage": "7.0.4",
 		"lodash.escaperegexp": "4.1.2",
 		"lodash.isequal": "4.5.0",
 		"xml": "1.0.1"
 	},
 	"devDependencies": {
-		"@types/command-line-args": "5.2.0",
-		"@types/command-line-usage": "5.0.2",
-		"@types/lodash.escaperegexp": "4.1.7",
-		"@types/lodash.isequal": "4.5.6",
-		"@types/node": "18.15.7",
-		"@types/xml": "1.0.8",
-		"@typescript-eslint/eslint-plugin": "5.56.0",
-		"@typescript-eslint/parser": "5.56.0",
-		"eslint": "8.36.0",
+		"@eslint/js": "10.0.1",
+		"@stylistic/eslint-plugin": "5.10.0",
+		"@types/command-line-args": "5.2.3",
+		"@types/command-line-usage": "5.0.4",
+		"@types/lodash.escaperegexp": "4.1.9",
+		"@types/lodash.isequal": "4.5.8",
+		"@types/node": "25.9.3",
+		"@types/xml": "1.0.11",
+		"eslint": "10.4.1",
+		"eslint-plugin-simple-import-sort": "^13.0.0",
+		"jiti": "2.7.0",
 		"ts-mockito": "2.6.1",
-		"typescript": "5.0.2"
+		"typescript": "6.0.3",
+		"typescript-eslint": "8.61.0"
 	},
 	"peerDependencies": {
 		"typescript": ">= 4"

package/src/Assertions/Contains.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that an array contains a given element
@@ -15,13 +15,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.contains(needle, haystack);
  */
-export default function Contains<T>(needle: T, haystack: ReadonlyArray<T>, message?: string) {
+export default function Contains<T>(needle: T, haystack: readonly T[], message?: string) {
 	if (haystack.includes(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected array containing expression, but array did not contain expression",
+		message: message ?? "Expected array containing expression, but array did not contain expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/Count.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that an array contains a certain number of elements
@@ -15,13 +15,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.count(expected, array);
  */
-export default function Count(expected: number, array: ReadonlyArray<any>, message?: string) {
+export default function Count(expected: number, array: readonly unknown[], message?: string) {
 	if (array.length === expected) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || `Expected array with ${expected} elements, but array had ${array.length} elements`,
+		message: message ?? `Expected array with ${expected} elements, but array had ${array.length} elements`,
 		expected: expected,
 		actual: array.length
 	});

package/src/Assertions/Defined.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a value is defined (any value other than `undefined`)
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.defined(expression);
  */
-export default function Defined(expression: any, message?: string) {
+export default function Defined(expression: unknown, message?: string) {
 	if (expression !== undefined) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expression to be defined, but expression is undefined",
+		message: message ?? "Expected expression to be defined, but expression is undefined",
 		expected: "(not undefined expression)",
 		actual: expression
 	});

package/src/Assertions/DoesNotContain.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that an array does not contain a given element
@@ -15,13 +15,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.doesNotContain(needle, haystack);
  */
-export default function DoesNotContain<T>(needle: T, haystack: ReadonlyArray<T>, message?: string) {
+export default function DoesNotContain<T>(needle: T, haystack: readonly T[], message?: string) {
 	if (!haystack.includes(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected array not containing expression, but array contained expression",
+		message: message ?? "Expected array not containing expression, but array contained expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/DoesNotThrow.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that an expression does not throw an error/exception
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.doesNotThrow(() => expression);
  */
-export default function DoesNotThrow(expression: () => any, message?: string) {
+export default function DoesNotThrow(expression: () => unknown, message?: string) {
 	try {
 		expression();
 		return;
 	} catch (exception) {
 		throw new AssertionError({
-			message: message || "Expected expression to not throw exception, but expression did throw exception",
+			message: message ?? "Expected expression to not throw exception, but expression did throw exception",
 			expected: "(no exception)",
 			actual: exception
 		});

package/src/Assertions/Empty.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that an array is empty
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.empty(array);
  */
-export default function Empty(array: ReadonlyArray<any>, message?: string) {
+export default function Empty(array: readonly unknown[], message?: string) {
 	if (array.length === 0) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expression to be empty, but expression was not empty",
+		message: message ?? "Expected expression to be empty, but expression was not empty",
 		expected: [],
 		actual: array
 	});

package/src/Assertions/Equal.ts

@@ -1,4 +1,5 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
+
 import equal from "lodash.isequal";
 
 /**
@@ -16,13 +17,13 @@ import equal from "lodash.isequal";
  * @example
  * this.assert.equal(expected, actual);
  */
-export default function Equal(expected: any, actual: any, message?: string) {
+export default function Equal(expected: unknown, actual: unknown, message?: string) {
 	if (equal(actual, expected)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expressions to be equal, but expressions are not equal",
+		message: message ?? "Expected expressions to be equal, but expressions are not equal",
 		expected: expected,
 		actual: actual,
 	});

package/src/Assertions/False.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a given value is equal to `false`
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.false(expression);
  */
-export default function False(expression: any, message?: string) {
+export default function False(expression: unknown, message?: string) {
 	if (expression === false) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expression to be false, but expression is not false",
+		message: message ?? "Expected expression to be false, but expression is not false",
 		expected: false,
 		actual: expression
 	});

package/src/Assertions/InstanceOf.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a value is an instance of a certain type
@@ -15,13 +15,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.instanceOf(type, object);
  */
-export default function InstanceOf(type: any, expression: any, message?: string) {
+export default function InstanceOf(type: Function, expression: unknown, message?: string) {
 	if (expression instanceof type) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || `Expected expression of type, but was ${typeof expression}`,
+		message: message ?? `Expected expression of type, but was ${typeof expression}`,
 		expected: type.name,
 		actual: typeof expression
 	});

package/src/Assertions/NotEmpty.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that an array is not empty
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.notEmpty(array);
  */
-export default function NotEmpty(array: ReadonlyArray<any>, message?: string) {
+export default function NotEmpty(array: readonly unknown[], message?: string) {
 	if (array.length > 0) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expression to be not empty, but expression was empty",
+		message: message ?? "Expected expression to be not empty, but expression was empty",
 		expected: "(non-empty expression)",
 		actual: array
 	});

package/src/Assertions/NotEqual.ts

@@ -1,4 +1,5 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
+
 import equal from "lodash.isequal";
 
 /**
@@ -16,13 +17,13 @@ import equal from "lodash.isequal";
  * @example
  * this.assert.notEqual(expected, actual);
  */
-export default function NotEqual(expected: any, actual: any, message?: string) {
+export default function NotEqual(expected: unknown, actual: unknown, message?: string) {
 	if (!equal(actual, expected)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expressions to be not equal, but expressions are equal",
+		message: message ?? "Expected expressions to be not equal, but expressions are equal",
 		expected: expected,
 		actual: actual,
 	});

package/src/Assertions/NotNull.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a value is not `null`
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.notNull(expression);
  */
-export default function NotNull(expression: any, message?: string) {
+export default function NotNull(expression: unknown, message?: string) {
 	if (expression !== null) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expression to be not null, but expression is null",
+		message: message ?? "Expected expression to be not null, but expression is null",
 		expected: "(non-null expression)",
 		actual: expression
 	});

package/src/Assertions/Null.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a value is `null`
@@ -14,13 +14,13 @@ import { AssertionError } from "assert";
  * @example
  * this.assert.null(expression);
  */
-export default function Null(expression: any, message?: string) {
+export default function Null(expression: unknown, message?: string) {
 	if (expression === null) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected expression to be null, but expression is not null",
+		message: message ?? "Expected expression to be null, but expression is not null",
 		expected: null,
 		actual: expression
 	});

package/src/Assertions/StringContains.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a string contains a given substring
@@ -16,12 +16,12 @@ import { AssertionError } from "assert";
  * this.assert.stringContains(needle, haystack);
  */
 export default function StringContains(needle: string, haystack: string | null, message?: string) {
-	if (haystack !== undefined && haystack !== null && haystack.indexOf(needle) > -1) {
+	if (haystack?.includes(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected string containing expression, but string did not contain expression",
+		message: message ?? "Expected string containing expression, but string did not contain expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/StringDoesNotContain.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a string does not contain a given substring
@@ -16,12 +16,12 @@ import { AssertionError } from "assert";
  * this.assert.stringDoesNotContain(needle, haystack);
  */
 export default function StringDoesNotContain(needle: string, haystack: string | null, message?: string) {
-	if (haystack === undefined || haystack === null || haystack.indexOf(needle) === -1) {
+	if (!haystack?.includes(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected string not containing expression, but string did contain expression",
+		message: message ?? "Expected string not containing expression, but string did contain expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/StringDoesNotEndWith.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a string does not end with a given substring
@@ -16,14 +16,12 @@ import { AssertionError } from "assert";
  * this.assert.stringDoesNotEndWith(needle, haystack);
  */
 export default function StringDoesNotEndWith(needle: string, haystack: string | null, message?: string) {
-	if (haystack === undefined || haystack === null
-		|| haystack.indexOf(needle) === -1
-		|| haystack.indexOf(needle) !== haystack.length - needle.length) {
+	if (!haystack?.endsWith(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected string containing expression, but string did not contain expression",
+		message: message ?? "Expected string containing expression, but string did not contain expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/StringDoesNotMatch.ts

@@ -0,0 +1,28 @@
+import { AssertionError } from "node:assert";
+
+/**
+ * Asserts that a string does not match a given regular expression
+ *
+ * @remarks
+ * Passes if `haystack` does not pass a `regex` test
+ *
+ * Fails if `haystack` passes a `regex` test
+ *
+ * @param regex the regular expression to test
+ * @param haystack the string to search
+ * @param message (optional) message to display on failure
+ *
+ * @example
+ * this.assert.stringDoesNotMatch(regex, haystack);
+ */
+export default function StringDoesNotMatch(regex: RegExp, haystack?: string | null, message?: string) {
+	if (haystack === undefined || haystack === null || !regex.test(haystack)) {
+		return;
+	}
+
+	throw new AssertionError({
+		message: message ?? "Expected string not pass regular expression test, but string did pass",
+		expected: regex.test(haystack),
+		actual: haystack
+	});
+}

package/src/Assertions/StringDoesNotStartWith.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a string does not begin with a given substring
@@ -16,12 +16,12 @@ import { AssertionError } from "assert";
  * this.assert.stringDoesNotStartWith(needle, haystack);
  */
 export default function StringDoesNotStartWith(needle: string, haystack: string | null, message?: string) {
-	if (haystack === undefined || haystack === null || haystack.indexOf(needle) !== 0) {
+	if (!haystack?.startsWith(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected string containing expression, but string did not contain expression",
+		message: message ?? "Expected string containing expression, but string did not contain expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/StringEndsWith.ts

@@ -1,4 +1,4 @@
-import { AssertionError } from "assert";
+import { AssertionError } from "node:assert";
 
 /**
  * Asserts that a string ends with a given substring
@@ -16,14 +16,12 @@ import { AssertionError } from "assert";
  * this.assert.stringEndsWith(needle, haystack);
  */
 export default function StringEndsWith(needle: string, haystack: string | null, message?: string) {
-	if (haystack !== undefined && haystack !== null
-		&& haystack.indexOf(needle) > -1
-		&& haystack.indexOf(needle) === haystack.length - needle.length) {
+	if (haystack?.endsWith(needle)) {
 		return;
 	}
 
 	throw new AssertionError({
-		message: message || "Expected string containing expression, but string did not contain expression",
+		message: message ?? "Expected string containing expression, but string did not contain expression",
 		expected: needle,
 		actual: haystack
 	});

package/src/Assertions/StringMatches.ts

@@ -0,0 +1,28 @@
+import { AssertionError } from "node:assert";
+
+/**
+ * Asserts that a string matches a given regular expression
+ *
+ * @remarks
+ * Passes if `haystack` matches a `regex` test
+ *
+ * Fails if `haystack` does not match a `regex` test
+ *
+ * @param regex the regular expression to match
+ * @param haystack the string to search
+ * @param message (optional) message to display on failure
+ *
+ * @example
+ * this.assert.stringMatches(regex, haystack);
+ */
+export default function StringMatches(regex: RegExp, haystack?: string | null, message?: string) {
+	if (haystack !== undefined && haystack !== null && regex.test(haystack)) {
+		return;
+	}
+
+	throw new AssertionError({
+		message: message ?? "Expected string to match regular expression, but string did not match",
+		expected: regex,
+		actual: haystack
+	});
+}