Add more and unify tests for absent object cases

- Unify test data for nonexistence of an object/string and collection.
- Introduce more test through adding missing test data to existing tests.
- Improve logic for checking absence of values to match tests.
- Add missing tests for absent value validation.
- Update documentation to include shared test functionality.

tests/unit/application/Common/ScriptingLanguage/ScriptingLanguageFactory.spec.ts

@@ -3,6 +3,7 @@ import { expect } from 'chai';
 import { ScriptingLanguage } from '@/domain/ScriptingLanguage';
 import { ScriptingLanguageFactory } from '@/application/Common/ScriptingLanguage/ScriptingLanguageFactory';
 import { EnumRangeTestRunner } from '@tests/unit/application/Common/EnumRangeTestRunner';
+import { itEachAbsentObjectValue } from '@tests/unit/shared/TestCases/AbsentTests';
 import { ScriptingLanguageFactoryTestRunner } from './ScriptingLanguageFactoryTestRunner';
 
 class ScriptingLanguageConcrete extends ScriptingLanguageFactory<number> {
@@ -16,32 +17,34 @@ describe('ScriptingLanguageFactory', () => {
     describe('validates language', () => {
       // arrange
       const validValue = ScriptingLanguage.batchfile;
-      const getter = () => undefined;
+      const getter = () => 1;
       const sut = new ScriptingLanguageConcrete();
       // act
       const act = (language: ScriptingLanguage) => sut.registerGetter(language, getter);
       // assert
       new EnumRangeTestRunner(act)
         .testOutOfRangeThrows()
-        .testUndefinedValueThrows()
+        .testAbsentValueThrows()
         .testValidValueDoesNotThrow(validValue);
     });
-    it('throw when getter is undefined', () => {
-      // arrange
-      const expectedError = 'undefined getter';
-      const language = ScriptingLanguage.batchfile;
-      const getter = undefined;
-      const sut = new ScriptingLanguageConcrete();
-      // act
-      const act = () => sut.registerGetter(language, getter);
-      // assert
-      expect(act).to.throw(expectedError);
+    describe('describe when getter is absent', () => {
+      itEachAbsentObjectValue((absentValue) => {
+        // arrange
+        const expectedError = 'missing getter';
+        const language = ScriptingLanguage.batchfile;
+        const getter = absentValue;
+        const sut = new ScriptingLanguageConcrete();
+        // act
+        const act = () => sut.registerGetter(language, getter);
+        // assert
+        expect(act).to.throw(expectedError);
+      });
     });
     it('throw when language is already registered', () => {
       // arrange
       const language = ScriptingLanguage.batchfile;
       const expectedError = `${ScriptingLanguage[language]} is already registered`;
-      const getter = () => undefined;
+      const getter = () => 1;
       const sut = new ScriptingLanguageConcrete();
       // act
       sut.registerGetter(language, getter);
@@ -51,9 +54,12 @@ describe('ScriptingLanguageFactory', () => {
     });
   });
   describe('create', () => {
+    // arrange
     const sut = new ScriptingLanguageConcrete();
-    sut.registerGetter(ScriptingLanguage.batchfile, () => undefined);
     const runner = new ScriptingLanguageFactoryTestRunner();
+    // act
+    sut.registerGetter(ScriptingLanguage.batchfile, () => 1);
+    // assert
     runner.testCreateMethod(sut);
   });
 });

tests/unit/application/Common/ScriptingLanguage/ScriptingLanguageFactoryTestRunner.ts

@@ -13,7 +13,7 @@ export class ScriptingLanguageFactoryTestRunner<T> {
   }
 
   public testCreateMethod(sut: IScriptingLanguageFactory<T>) {
-    if (!sut) { throw new Error('undefined sut'); }
+    if (!sut) { throw new Error('missing sut'); }
     testLanguageValidation(sut);
     testExpectedInstanceTypes(sut, this.expectedTypes);
   }
@@ -46,7 +46,7 @@ function testLanguageValidation<T>(sut: IScriptingLanguageFactory<T>) {
     // assert
     new EnumRangeTestRunner(act)
       .testOutOfRangeThrows()
-      .testUndefinedValueThrows()
+      .testAbsentValueThrows()
       .testValidValueDoesNotThrow(validValue);
   });
 }