Fix class evaluation context of expected expression evaluation method

Author: t-ski

package-lock.json

@@ -121,10 +121,10 @@ export abstract class Test<T = unknown> {
 				let expected: T;
 				try {
 					expected = await new Promisification<T>(
-						this.evalExpectedExpression.apply(null, await this.promisifyExpression(...expectedExpression))
+						this.evalExpectedExpression(...(await this.promisifyExpression(...expectedExpression)))
 					).resolve();
 				} catch (err: unknown) {
-					throw new FormatError(err, "Cannot consume expected value", this.sourcePosition);
+					throw new FormatError(err, "Cannot consume expected value:", this.sourcePosition);
 				}
 
 				this.difference = this.getDifference(actual, expected);

packages/testing/src/Test.ts

@@ -45,7 +45,8 @@ export class Printer {
 				return Printer.colorStr(value, 34);
 			}
 			if (/^("|').*\1$/.test(value)) {
-				return Printer.colorStr(value, 35);
+				const strValue = /\\n/.test(value) ? `\n${value.slice(1, -1).replace(/\\n/g, "\n")}` : value;
+				return Printer.colorStr(strValue, 35);
 			}
 			if (/^\d*(\.\d+)?$/.test(value)) {
 				return Printer.colorStr(value, 36);

packages/testing/src/cli/Printer.ts

@@ -124,7 +124,9 @@ async function runSuite(): Promise<IResults> {
 			if (!(err instanceof Error)) {
 				console.error(
 					`\n\x1b[31mTest suite interrupted by unexpected error${
-						["string", "number", "boolean"].includes(typeof err) ? `:\n\n${(err as number).toString()}` : ""
+						["string", "number", "boolean"].includes(typeof err)
+							? (err as string | number | boolean).toString()
+							: JSON.stringify(err)
 					}\x1b[0m`
 				);
 

packages/testing/src/cli/cli.ts

@@ -1,5 +1,5 @@
 {
-    "unit": "@rapidjs.org/testing-unit",
+    "cli": "@rapidjs.org/testing-cli",
     "http": "@rapidjs.org/testing-http",
-    "dom": "@rapidjs.org/testing-dom"
+    "unit": "@rapidjs.org/testing-unit"
 }

packages/testing/src/cli/suites.json

@@ -6,14 +6,17 @@ rJS Testing <alias> testing suite (`<Suite>Test`): …
 
 ### Expressions
 
-(#### Actual)
+#### Actual
 
 ``` ts
 .actual(expression: any)
-.expected(expression: any)
 ```
 
-(#### Expected)
+#### Expected
+
+``` ts
+.expected(expression: any)
+```
 
 ### Value-based Assertion
 

packages/testing/template/README.md

@@ -10,22 +10,23 @@ export class CustomTest extends Test<IObject> {
 	public static readonly suiteTitle: string = "Custom";
 	public static readonly suiteColor: [number, number, number] = [ 255, 255, 0 ];
 
-    constructor(title: string) {
-    	super(title);
-    }
-	
-    protected async evalActualExpression(obj: IObject): Promise<IObject> {
-    	return Object.fromEntries(
-			Object.entries(obj)
-			.map((entry: [ string, unknown ]) => [ entry[0].toLowerCase(), entry[1] ])
-		) as IObject;
-	}
-
-    protected isEqual(actual: IObject, expected: IObject): boolean {
-		return !Object.keys(this.filterComparedValues(actual, expected).actual).length;
+    protected evalActualExpression(arg1: string, arg2: boolean): IObject {
+		// HINT:
+		// evalActualExpression() and analog. evalExpectedExpression() are
+		// ought to compile a value sharing a common type. he evaluation can
+		// base on an arbitrary amount of heterogeneous arguments.
+		// E.g.: Obtaining an HTTP response based on endpoint information.
+    	return {
+			arg1, arg2
+		}
 	}
 
-	protected filterComparedValues(actual: IObject, expected: IObject) {
+	protected getDifference(actual: IObject, expected: IObject) {
+		// HINT:
+		// Filter the previously evaluated test expression values for
+		// differences in respect to the test purpose.
+		// E.g.: Filtering explicitly provided HTTP response properties on
+		//		 the actaul HTTP response that differ.
 		return {
 			actual: actual,
 			expected: expected