@aj-shadow/actorjs-documentation-text 0.0.0-aj-beta.221

package/Documentation/actor-api/Document-global-verification-data.txt

@@ -0,0 +1,624 @@
+# **Verification Data API**
+[[API-STATUS=STABLE, ]]
+[[DOC-STATUS=PARTLY, ]]
+
+## **Description**
+
+An [[REF=Actor, ABS_Actor]] can read, generate and format [[REF=, ABS_Verification_Data]]. Verifications can be done in all states, but it is typically done in the [[REF=, ABS_Actor_State_Execution]] ***run**.
+
+The implementation of the [[REF=, ABS_Verification_Data]] API starts in [[REF=, CODE_Verification_Value]], [[REF=, CODE_Verification_Mandatory]] or [[REF=, CODE_Verification_Optional]].
+[[ANCHOR={"id":"3092475c-5b5d-4680-a59f-c4c9c3055817","visible":true}]]
+
+## **API Methods**
++ **[VERIFY_VALUE](#VERIFY_VALUE)**
++ **[VERIFY_CONTENT_VALUE](#VERIFY_CONTENT_VALUE)** `ToDo`
++ **[VERIFY_OPTIONAL](#VERIFY_OPTIONAL)**
++ **[*VERIFY_CONTENT_OPTIONAL](#*VERIFY_CONTENT_OPTIONAL)** `ToDo`
++ **[VERIFY_MANDATORY](#VERIFY_MANDATORY)**
++ **[*VERIFY_CONTENT_MANDATORY](#*VERIFY_CONTENT_MANDATORY)** `ToDo`
+
+***
+[[ANCHOR={"id":"VERIFY_VALUE","visible":true}]]
+### **VERIFY_VALUE**
+```
+VERIFY_VALUE(expectedValue, actualValue[, description[, operation]])
+```
+Verifies an actual value against a hard-coded expected value.
+
+#### **Method Description**
+```table
+Config(classHeading: )
+
+|Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+|Name         |Type                                                                                                                                                                                                                                                                                                                   |Description                                                                                                                                                              |
+|expectedValue|[[REF=,MDN_string]]&#160;&#124;&#160;[[REF=,MDN_strings]]&#160;&#124;&#160;[[REF=,MDN_arraystrings]]<br>[[REF=,MDN_number]]&#160;&#124;&#160;[[REF=,MDN_numbers]]&#160;&#124;&#160;[[REF=,MDN_arraynumbers]]<br>[[REF=,MDN_boolean]]&#160;&#124;&#160;[[REF=,MDN_booleans]]&#160;&#124;&#160;[[REF=,MDN_arraybooleans]]|Value against which actual value is verified.                                                                                                                            |
+|actualValue  |[[REF=,MDN_string]]&#160;&#124;&#160;[[REF=,MDN_strings]]&#160;&#124;&#160;[[REF=,MDN_arraystrings]]<br>[[REF=,MDN_number]]&#160;&#124;&#160;[[REF=,MDN_numbers]]&#160;&#124;&#160;[[REF=,MDN_arraynumbers]]<br>[[REF=,MDN_boolean]]&#160;&#124;&#160;[[REF=,MDN_booleans]]&#160;&#124;&#160;[[REF=,MDN_arraybooleans]]|Value verified against expected value.                                                                                                                                   |
+|description  |[[REF=,MDN_string]]                                                                                                                                                                                                                                                                                                    |Optional description of the verification.                                                                                                                                |
+|operation    |[[REF=,MDN_Operator]]                                                                                                                                                                                                                                                                                                  |A relational or an equality operator (default: '===') used when comparing expected value to actual value. For non-primitive types, comparison is done element by element.|
+```
+The verification will throw an exception if it fails.
+
+#### **Example using VERIFY_VALUE with primitive types**
+```tc
+
+```
+
+```javascript
+
+
+
+
+
+*run() {                               // A
+  VERIFY_VALUE('Hello', 'Hello');      // Success
+  VERIFY_VALUE('Hi', 'Hello');         // Failure
+}
+
+*run() {                               // B
+  VERIFY_VALUE(32, 32);                // Success
+  VERIFY_VALUE(31, 32);                // Failure
+}
+
+*run() {                               // C
+  VERIFY_VALUE(true, true);            // Success
+  VERIFY_VALUE(2 > 1, true);           // Success
+  VERIFY_VALUE(false, true);           // Failure
+}
+
+*run() {                               // D
+  VERIFY_VALUE('1', 1, '', '==');      // Success
+  VERIFY_VALUE(0, 1, '', '<');         // Success
+  VERIFY_VALUE(2, 1, '', '<');         // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_VALUE with primitive types**
++ [DocActorApiVerifyValueASuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueASuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueAFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueAFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueBSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueBSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueBFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueBFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueCSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueCSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueCFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueCFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueDSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueDSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueDFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueDFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+
+#### **Example using VERIFY_VALUE with arrays**
+```tc
+
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                                // J
+  VERIFY_VALUE(['Hello', 'Hi'], ['Hello', 'Hi']);       // Success
+  VERIFY_VALUE(['Hi', 'Hello'], ['Hello', 'Hi']);       // Failure
+}
+
+*run() {                                                // K
+  VERIFY_VALUE([31.1, 32.2], [31.1, 32.2]);             // Success
+  VERIFY_VALUE([31.1, 32.0], [31.1, 32.2]);             // Failure
+}
+
+*run() {                                                // L
+  VERIFY_VALUE([true, false], [true, false]);           // Success
+  VERIFY_VALUE([2 > 1, 2 > 3], [true, false]);          // Success
+  VERIFY_VALUE([2 > 1, 3 > 2], [true, false]);          // Failure
+}
+
+*run() {                                                // M
+  VERIFY_VALUE(['1.1', '2.2'], [1.1, 2.2], '', '==');   // Success
+  VERIFY_VALUE([1.0, 2.1], [1.1, 2.2], '', '<');        // Success
+  VERIFY_VALUE([1.1, 2.1], [1.1, 2.2], '', '<');        // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_VALUE with arrays**
++ [DocActorApiVerifyValueJSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueJSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueJFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueJFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueKSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueKSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueKFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueKFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueLSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueLSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueLFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueLFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueMSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueMSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueMFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueMFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
+<br>
+
+#### **Example using VERIFY_VALUE with arrays of arrays**
+```tc
+
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                                                                    // S
+  VERIFY_VALUE([['Hello', 'Hi'], ['Bye', 'Later']], [['Hello', 'Hi'], ['Bye', 'Later']]);   // Success
+  VERIFY_VALUE([['Hi', 'Hi'], ['Bye', 'Later']], [['Hello', 'Hi'], ['Bye', 'Later']]);      // Failure
+}
+
+*run() {                                                                                    // T
+  VERIFY_VALUE([[1, 2], [3, 4]], [[1, 2], [3, 4]]);                                         // Success
+  VERIFY_VALUE([[3, 4], [1, 2]], [[1, 2], [3, 4]]);                                         // Failure
+}
+
+*run() {                                                                                    // U
+  VERIFY_VALUE([[false, false], [false, false]], [[false, false], [false, false]]);         // Success
+  VERIFY_VALUE([[3 < 2, 2 < 1], [3 == 2, 2 == 1]], [[false, false], [false, false]]);       // Success
+  VERIFY_VALUE([[3 > 2, 2 > 1], [3 != 2, '1' == 1]], [[false, false], [false, false]]);     // Failure
+}
+
+*run() {                                                                                    // V
+  VERIFY_VALUE([['1.1', '2.2'], ['3.3', '4.4']], [[1.1, 2.2], [3.3, 4.4]], '', '==');       // Success
+  VERIFY_VALUE([['1.0', '2.1'], ['3.2', '4.3']], [[1.1, 2.2], [3.3, 4.4]], '', '<');        // Success
+  VERIFY_VALUE([[1.2, 2.3], [3.4, 4.4]], [[1.1, 2.2], [3.3, 4.4]], '', '>');                // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_VALUE with arrays of arrays**
++ [DocActorApiVerifyValueSSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueSSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueSFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueSFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueTSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueTSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueTFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueTFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueUSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueUSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueUFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueUFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyValueVSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyValueVSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyValueVFailure](/../test-cases/Actor/Doc/DocActorApiVerifyValueVFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
+
+***
+[[ANCHOR={"id":"VERIFY_OPTIONAL","visible":true}]]
+### **VERIFY_OPTIONAL**
+```
+VERIFY_OPTIONAL(expectedKey, actualValue[, index1[, index2]])
+```
+Verifies an actual value against an expected value. If no expected value is found, no actual verification is done, but the verification is deemed successful.
+
+#### **Method Description**
+```table
+Config(classHeading: )
+
+|Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+|Name       |Type                                                                                                                                                                                                                                                                                                                   |Description                                                                                                |
+|expectedKey|[[REF=,MDN_string]]                                                                                                                                                                                                                                                                                                    |String used in a [[REF=, ABS_Test_Data_Table_Lookup]] to find ***expected value***.                        |
+|actualValue|[[REF=,MDN_string]]&#160;&#124;&#160;[[REF=,MDN_strings]]&#160;&#124;&#160;[[REF=,MDN_arraystrings]]<br>[[REF=,MDN_number]]&#160;&#124;&#160;[[REF=,MDN_numbers]]&#160;&#124;&#160;[[REF=,MDN_arraynumbers]]<br>[[REF=,MDN_boolean]]&#160;&#124;&#160;[[REF=,MDN_booleans]]&#160;&#124;&#160;[[REF=,MDN_arraybooleans]]|Value verified against ***expected value*** (or a subset thereof).                                         |
+|index1     |[[REF=,MDN_number]]                                                                                                                                                                                                                                                                                                    |Points to an element (a primitive type or an array) in ***expected value*** to verify actual value against.|
+|index2     |[[REF=,MDN_number]]                                                                                                                                                                                                                                                                                                    |Points to an element in an array given  by ***index1*** to verify actual value against.                    |
+```
+The verification will throw an exception if it fails.
+
+#### **Example using VERIFY_OPTIONAL with primitive types**
+```tc
+|VerificationTestCase                        |
+|key     |value|operation|type   |description|
+|demoKey1|Hello|         |       |           |
+|demoKey2|Hi   |         |       |           |
+|demoKey3|33.3 |==       |number |           |
+|demoKey4|22.2 |>        |number |           |
+|demoKey5|44.4 |         |number |           |
+|demoKey6|44.4 |==       |       |           |
+|demoKey7|false|         |boolean|           |
+|demoKey8|true |         |boolean|           |
+|        |     |         |       |           |
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                   // A
+  VERIFY_OPTIONAL('demoKey1', 'Hello');    // Success
+  VERIFY_OPTIONAL('demoKeyX', 'Hello');    // Success
+  VERIFY_OPTIONAL('demoKey2', 'Hello');    // Failure
+}
+
+*run() {                                   // B
+  VERIFY_OPTIONAL('demoKey3', '33.3');     // Success
+  VERIFY_OPTIONAL('demoKeyX', '33.3');     // Success
+  VERIFY_OPTIONAL('demoKey4', '33.3');     // Failure
+}
+
+*run() {                                   // C
+  VERIFY_OPTIONAL('demoKey5', 44.4);       // Success
+  VERIFY_OPTIONAL('demoKey6', 44.4);       // Success
+  VERIFY_OPTIONAL('demoKeyX', 44.4);       // Success
+  VERIFY_OPTIONAL('demoKey3', 44.4);       // Failure
+}
+
+*run() {                                   // D
+  VERIFY_OPTIONAL('demoKey7', false);      // Success
+  VERIFY_OPTIONAL('demoKeyX', false);      // Success
+  VERIFY_OPTIONAL('demoKey8', false);      // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_OPTIONAL with primitive types**
++ [DocActorApiVerifyOptionalASuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalASuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalAFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalAFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalBSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalBSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalBFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalBFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalCSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalCSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalCFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalCFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalDSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalDSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalDFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalDFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+
+#### **Example using VERIFY_OPTIONAL with arrays**
+```tc
+|VerificationTestCase                                      |
+|key       |value          |operation|type     |description|
+|demoKey1  |["Hello", "Hi"]|         |[string] |           |
+|demoKey2[]|Hello          |         |         |           |
+|demoKey2[]|Hi             |         |         |           |
+|demoKey3  |[1, 2]         |         |[number] |           |
+|demoKey4[]|1              |         |number   |           |
+|demoKey4[]|2              |         |number   |           |
+|demoKey5  |[3, 4]         |>        |[number] |           |
+|demoKey6  |[3, 4]         |<        |[number] |           |
+|demoKey7  |[true, false]  |         |[boolean]|           |
+|demoKey8[]|true           |         |boolean  |           |
+|demoKey8[]|false          |         |boolean  |           |
+|          |               |         |         |           |
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                        // J
+  VERIFY_OPTIONAL('demoKey1', ['Hello', 'Hi']); // Success
+  VERIFY_OPTIONAL('demoKey2', ['Hello', 'Hi']); // Success
+  VERIFY_OPTIONAL('demoKeyX', ['Hello', 'Hi']); // Success
+  VERIFY_OPTIONAL('demoKey1', ['Hi', 'Hello']); // Failure
+}
+
+*run() {                                        // K
+  VERIFY_OPTIONAL('demoKey3', [1, 2]);          // Success
+  VERIFY_OPTIONAL('demoKey4', [1, 2]);          // Success
+  VERIFY_OPTIONAL('demoKey5', [1, 2]);          // Success
+  VERIFY_OPTIONAL('demoKeyX', [1, 2]);          // Success
+  VERIFY_OPTIONAL('demoKey6', [1, 2]);          // Failure
+}
+
+*run() {                                        // L
+  VERIFY_OPTIONAL('demoKey7', [true, false]);   // Success
+  VERIFY_OPTIONAL('demoKey8', [true, false]);   // Success
+  VERIFY_OPTIONAL('demoKeyX', [true, false]);   // Success
+  VERIFY_OPTIONAL('demoKey8', [true, true]);    // Failure
+}
+
+*run() {                                        // M
+  VERIFY_OPTIONAL('demoKey1', 'Hello', 0);      // Success
+  VERIFY_OPTIONAL('demoKey2', 'Hi', 1);         // Success
+  VERIFY_OPTIONAL('demoKey3', 1, 0);            // Success
+  VERIFY_OPTIONAL('demoKey5', 2, 1);            // Success
+  VERIFY_OPTIONAL('demoKey7', true, 0);         // Success
+  VERIFY_OPTIONAL('demoKey8', true, 1);	        // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_OPTIONAL with arrays**
++ [DocActorApiVerifyOptionalJSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalJSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalJFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalJFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalKSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalKSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalKFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalKFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalLSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalLSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalLFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalLFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalMSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalMSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalMFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalMFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+#### **Example using VERIFY_OPTIONAL with arrays of arrays**
+```tc
+|VerificationTestCase                                                            |
+|key       |value                              |operation|type       |description|
+|demoKey1  |[["Hello", "Hi"], ["Bye", "Later"]]|         |[[string]] |           |
+|demoKey2[]|["Hello", "Hi"]                    |         |[string]   |           |
+|demoKey2[]|["Bye", "Later"]                   |         |[string]   |           |
+|demoKey3  |[[1, 2], [5, 6]]                   |         |[[number]] |           |
+|demoKey4[]|[1, 2]                             |         |[number]   |           |
+|demoKey4[]|[5, 6]                             |         |[number]   |           |
+|demoKey5  |[[3, 4], [7, 8]]                   |>        |[[number]] |           |
+|demoKey6[]|[3, 4]                             |<        |[number]   |           |
+|demoKey6[]|[7, 8]                             |>        |[number]   |           |
+|demoKey7  |[[true, true], [false, false]]     |         |[[boolean]]|           |
+|demoKey8[]|[true, true]                       |         |[boolean]  |           |
+|demoKey8[]|[false, false]                     |         |[boolean]  |           |
+|          |                                   |         |           |           |
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                                             // S
+  VERIFY_OPTIONAL('demoKey1', [['Hello', 'Hi'], ['Bye', 'Later']]);  // Success
+  VERIFY_OPTIONAL('demoKey2', [['Hello', 'Hi'], ['Bye', 'Later']]);  // Success
+  VERIFY_OPTIONAL('demoKeyX', [['Hello', 'Hi'], ['Bye', 'Later']]);  // Success
+  VERIFY_OPTIONAL('demoKey1', [['Hello', 'Hi'], ['Later', 'Bye']]);  // Failure
+}
+
+*run() {                                                             // T
+  VERIFY_OPTIONAL('demoKey3', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_OPTIONAL('demoKey4', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_OPTIONAL('demoKey5', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_OPTIONAL('demoKey6', [[5, 6], [1, 2]]);                     // Success
+  VERIFY_OPTIONAL('demoKeyX', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_OPTIONAL('demoKey4', [[1, 2], [4, 6]]);                     // Failure
+}
+
+*run() {                                                             // U
+  VERIFY_OPTIONAL('demoKey7', [[true, true], [false, false]]);       // Success
+  VERIFY_OPTIONAL('demoKey8', [[true, true], [false, false]]);       // Success
+  VERIFY_OPTIONAL('demoKeyX', [[true, true], [false, false]]);       // Success
+  VERIFY_OPTIONAL('demoKey7', [[true, false], [true, false]]);       // Failure
+}
+
+*run() {                                                             // V
+  VERIFY_OPTIONAL('demoKey1', ['Hello', 'Hi'], 0);                   // Success
+  VERIFY_OPTIONAL('demoKey2', 'Bye', 1, 0);                          // Success
+  VERIFY_OPTIONAL('demoKey3', [1, 2], 0);                            // Success
+  VERIFY_OPTIONAL('demoKey4', 6, 1, 1);                              // Success
+  VERIFY_OPTIONAL('demoKey7', [true, true], 0);                      // Success
+  VERIFY_OPTIONAL('demoKey8', true, 0, 1);                           // Success
+  VERIFY_OPTIONAL('demoKey1', 'Later', 2, 2);                        // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_OPTIONAL with arrays of arrays**
++ [DocActorApiVerifyOptionalSSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalSSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalSFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalSFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalTSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalTSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalTFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalTFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalUSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalUSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalUFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalUFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyOptionalVSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalVSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyOptionalVFailure](/../test-cases/Actor/Doc/DocActorApiVerifyOptionalVFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+***
+[[ANCHOR={"id":"VERIFY_MANDATORY","visible":true}]]
+### **VERIFY_MANDATORY**
+```
+VERIFY_MANDATORY(expectedKey, actualValue[, index1[, index2]])
+```
+Verifies an actual value against an expected value. If no expected value is found, the verification is deemed to fail.
+
+#### **Method Description**
+```table
+Config(classHeading: )
+
+|Parameters                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+|Name       |Type                                                                                                                                                                                                                                                                                                                   |Description                                                                                                |
+|expectedKey|[[REF=,MDN_string]]                                                                                                                                                                                                                                                                                                    |String used in a [[REF=, ABS_Test_Data_Table_Lookup]] to find ***expected value***.                        |
+|actualValue|[[REF=,MDN_string]]&#160;&#124;&#160;[[REF=,MDN_strings]]&#160;&#124;&#160;[[REF=,MDN_arraystrings]]<br>[[REF=,MDN_number]]&#160;&#124;&#160;[[REF=,MDN_numbers]]&#160;&#124;&#160;[[REF=,MDN_arraynumbers]]<br>[[REF=,MDN_boolean]]&#160;&#124;&#160;[[REF=,MDN_booleans]]&#160;&#124;&#160;[[REF=,MDN_arraybooleans]]|Value verified against ***expected value*** (or a subset thereof).                                          |
+|index1     |[[REF=,MDN_number]]                                                                                                                                                                                                                                                                                                    |Points to an element (a primitive type or an array) in ***expected value*** to verify actual value against.|
+|index2     |[[REF=,MDN_number]]                                                                                                                                                                                                                                                                                                    |Points to an element in an array given  by ***index1*** to verify actual value against.                    |
+```
+The verification will throw an exception if it fails.
+
+#### **Example using VERIFY_MANDATORY with primitive types**
+```tc
+|VerificationTestCase                        |
+|key     |value|operation|type   |description|
+|demoKey1|Hello|         |       |           |
+|demoKey2|Hi   |         |       |           |
+|demoKey3|33.3 |==       |number |           |
+|demoKey4|22.2 |>        |number |           |
+|demoKey5|44.4 |         |number |           |
+|demoKey6|44.4 |==       |       |           |
+|demoKey7|false|         |boolean|           |
+|demoKey8|true |         |boolean|           |
+|        |     |         |       |           |
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                   // A
+  VERIFY_MANDATORY('demoKey1', 'Hello');   // Success
+  VERIFY_MANDATORY('demoKey2', 'Hello');   // Failure
+}
+
+*run() {                                   // B
+  VERIFY_MANDATORY('demoKey3', '33.3');    // Success
+  VERIFY_MANDATORY('demoKey4', '33.3');    // Failure
+}
+
+*run() {                                   // C
+  VERIFY_MANDATORY('demoKey5', 44.4);      // Success
+  VERIFY_MANDATORY('demoKey6', 44.4);      // Success
+  VERIFY_MANDATORY('demoKeyX', 44.4);      // Failure
+}
+
+*run() {                                   // D
+  VERIFY_MANDATORY('demoKey7', false);     // Success
+  VERIFY_MANDATORY('demoKey8', false);     // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_MANDATORY with primitive types**
++ [DocActorApiVerifyMandatoryASuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryASuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryAFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryAFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryBSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryBSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryBFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryBFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryCSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryCSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryCFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryCFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryDSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryDSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryDFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryDFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+
+#### **Example using VERIFY_MANDATORY with arrays**
+```tc
+|VerificationTestCase                                      |
+|key       |value          |operation|type     |description|
+|demoKey1  |["Hello", "Hi"]|         |[string] |           |
+|demoKey2[]|Hello          |         |         |           |
+|demoKey2[]|Hi             |         |         |           |
+|demoKey3  |[1, 2]         |         |[number] |           |
+|demoKey4[]|1              |         |number   |           |
+|demoKey4[]|2              |         |number   |           |
+|demoKey5  |[3, 4]         |>        |[number] |           |
+|demoKey6  |[3, 4]         |<        |[number] |           |
+|demoKey7  |[true, false]  |         |[boolean]|           |
+|demoKey8[]|true           |         |boolean  |           |
+|demoKey8[]|false          |         |boolean  |           |
+|          |               |         |         |           |
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                          // J
+  VERIFY_MANDATORY('demoKey1', ['Hello', 'Hi']);  // Success
+  VERIFY_MANDATORY('demoKey2', ['Hello', 'Hi']);  // Success
+  VERIFY_MANDATORY('demoKeyX', ['Hello', 'Hi']);  // Failure
+}
+
+*run() {                                          // K
+  VERIFY_MANDATORY('demoKey3', [1, 2]);           // Success
+  VERIFY_MANDATORY('demoKey4', [1, 2]);           // Success
+  VERIFY_MANDATORY('demoKey5', [1, 2]);           // Success
+  VERIFY_MANDATORY('demoKey6', [1, 2]);           // Failure
+}
+
+*run() {                                          // L
+  VERIFY_MANDATORY('demoKey7', [true, false]);    // Success
+  VERIFY_MANDATORY('demoKey8', [true, false]);    // Success
+  VERIFY_MANDATORY('demoKey8', [true, true]);     // Failure
+}
+
+*run() {                                          // M
+  VERIFY_MANDATORY('demoKey1', 'Hi', 1);          // Success
+  VERIFY_MANDATORY('demoKey2', 'Hello', 0);       // Success
+  VERIFY_MANDATORY('demoKey3', 2, 1);             // Success
+  VERIFY_MANDATORY('demoKey4', 1, 0);             // Success
+  VERIFY_MANDATORY('demoKey8', false, 1);         // Success
+  VERIFY_MANDATORY('demoKey8', false, 0);         // Failure
+
+}
+
+```
+
+#### **Test Cases using VERIFY_MANDATORY with arrays**
++ [DocActorApiVerifyMandatoryJSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryJSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryJFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryJFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryKSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryKSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryKFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryKFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryLSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryLSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryLFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryLFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryMSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryMSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryMFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryMFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+#### **Example using VERIFY_MANDATORY with arrays of arrays**
+```tc
+|VerificationTestCase                                                            |
+|key       |value                              |operation|type       |description|
+|demoKey1  |[["Hello", "Hi"], ["Bye", "Later"]]|         |[[string]] |           |
+|demoKey2[]|["Hello", "Hi"]                    |         |[string]   |           |
+|demoKey2[]|["Bye", "Later"]                   |         |[string]   |           |
+|demoKey3  |[[1, 2], [5, 6]]                   |         |[[number]] |           |
+|demoKey4[]|[1, 2]                             |         |[number]   |           |
+|demoKey4[]|[5, 6]                             |         |[number]   |           |
+|demoKey5  |[[3, 4], [7, 8]]                   |>        |[[number]] |           |
+|demoKey6[]|[3, 4]                             |<        |[number]   |           |
+|demoKey6[]|[7, 8]                             |>        |[number]   |           |
+|demoKey7  |[[true, true], [false, false]]     |         |[[boolean]]|           |
+|demoKey8[]|[true, true]                       |         |[boolean]  |           |
+|demoKey8[]|[false, false]                     |         |[boolean]  |           |
+|          |                                   |         |           |           |
+```
+
+```javascript
+
+
+
+
+
+
+*run() {                                                              // S
+  VERIFY_MANDATORY('demoKey1', [['Hello', 'Hi'], ['Bye', 'Later']]);  // Success
+  VERIFY_MANDATORY('demoKey2', [['Hello', 'Hi'], ['Bye', 'Later']]);  // Success
+  VERIFY_MANDATORY('demoKeyX', [['Hello', 'Hi'], ['Bye', 'Later']]);  // Failure
+}
+
+*run() {                                                              // T
+  VERIFY_MANDATORY('demoKey3', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_MANDATORY('demoKey4', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_MANDATORY('demoKey5', [[1, 2], [5, 6]]);                     // Success
+  VERIFY_MANDATORY('demoKey6', [[5, 6], [1, 2]]);                     // Success
+  VERIFY_MANDATORY('demoKey6', [[1, 2], [5, 6]]);                     // Failure
+}
+
+*run() {                                                              // U
+  VERIFY_MANDATORY('demoKey7', [[true, true], [false, false]]);       // Success
+  VERIFY_MANDATORY('demoKey8', [[true, true], [false, false]]);       // Success
+  VERIFY_MANDATORY('demoKey8', [[true, false], [true, false]]);       // Failure
+}
+
+*run() {                                                              // V
+  VERIFY_MANDATORY('demoKey1', 'Later', 1, 1);                        // Success
+  VERIFY_MANDATORY('demoKey2', ['Hello', 'Hi'], 0);                   // Success
+  VERIFY_MANDATORY('demoKey3', 1, 0, 0);                              // Success
+  VERIFY_MANDATORY('demoKey4', [5, 6], 1);                            // Success
+  VERIFY_MANDATORY('demoKey7', false, 1, 1);                          // Success
+  VERIFY_MANDATORY('demoKey8', [false, false], 1);                    // Success
+  VERIFY_MANDATORY('demoKey2', 'Later', 2, 2);                        // Failure
+}
+
+```
+
+#### **Test Cases using VERIFY_MANDATORY with arrays of arrays**
++ [DocActorApiVerifyMandatorySSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatorySSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatorySFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatorySFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryTSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryTSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryTFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryTFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryUSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryUSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryUFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryUFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]
++ [DocActorApiVerifyMandatoryVSuccess](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryVSuccess) &nbsp;&nbsp;&nbsp; [[IE=// Success]]
++ [DocActorApiVerifyMandatoryVFailure](/../test-cases/Actor/Doc/DocActorApiVerifyMandatoryVFailure) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; [[IE=// Failure]]  
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+

package/Documentation/connection-worker-api/Document-global-logger.txt

@@ -0,0 +1,3 @@
+# **CONNECTION WORKER API - LOGGER**
+[[API-STATUS=EXPERIMENTAL, ]]
+[[DOC-STATUS=NOT-YET, ]]