Add docs for assertEqual and assertNotEqual commands

Author: ryanpato

SUMMARY.md

@@ -87,6 +87,8 @@
   * [assertTrue](api-reference/commands/asserttrue.md)
   * [assertWithAI](api-reference/commands/assertwithai.md)
   * [assertNoDefectsWithAi](api-reference/commands/assertnodefectswithai.md)
+  * [assertEqual](api-reference/commands/assertequal.md)
+  * [assertNotEqual](api-reference/commands/assertnotequal.md)
   * [back](api-reference/commands/back.md)
   * [clearKeychain](api-reference/commands/clearkeychain.md)
   * [clearState](api-reference/commands/clearstate.md)

api-reference/commands/assertequal.md

@@ -0,0 +1,106 @@
+---
+description: Assert that two values are equal in Maestro flows.
+---
+
+# assertEqual
+
+Asserts that two values are equal after JavaScript evaluation:
+
+```yaml
+- assertEqual:
+    value1: ${actualValue}
+    value2: "expected"
+```
+
+This command compares `value1` and `value2` as strings after evaluating any JavaScript expressions. If the values are not equal, the assertion fails with a clear error message showing both values.
+
+### Basic usage
+
+Compare a variable to an expected value:
+
+```yaml
+- assertEqual:
+    value1: ${output.username}
+    value2: "john_doe"
+```
+
+Compare two JavaScript expressions:
+
+```yaml
+- assertEqual:
+    value1: ${2 + 2}
+    value2: ${8 - 4}
+```
+
+Compare text copied from the UI:
+
+```yaml
+- copyTextFrom: 
+    id: "price-label"
+- assertEqual:
+    value1: ${maestro.copiedText}
+    value2: "$19.99"
+```
+
+### With label and optional
+
+Add a descriptive label or make the assertion optional:
+
+```yaml
+- assertEqual:
+    value1: ${output.status}
+    value2: "success"
+    label: "Verify API returned success status"
+    optional: true
+```
+
+### Use in conditions
+
+`assertEqual` can be used in `runFlow` and `repeat` conditions:
+
+```yaml
+- runFlow:
+    when:
+      equal:
+        value1: ${platform}
+        value2: "ios"
+    commands:
+      - tapOn: "iOS-specific button"
+```
+
+```yaml
+- repeat:
+    while:
+      equal:
+        value1: ${output.loading}
+        value2: "true"
+    commands:
+      - waitForAnimationToEnd
+```
+
+### Considerations
+
+`assertNotEqual` compares values as strings after JavaScript evaluation:
+
+- **Numbers are normalized**: `${1}` and `${1.0}` both evaluate to `"1"` and will match
+- **Booleans become strings**: `${true}` evaluates to `"true"`
+
+This means `${true}` and `${1}` are not considered equal — they evaluate to `"true"` and `"1"` respectively. If you need JavaScript type coercion (where `1 == true`), use `assertTrue`:
+
+```yaml
+- assertTrue: ${1 == true}
+```
+
+### Related commands
+
+{% content-ref url="assertnotequal.md" %}
+[assertnotequal.md](assertnotequal.md)
+{% endcontent-ref %}
+
+{% content-ref url="asserttrue.md" %}
+[asserttrue.md](asserttrue.md)
+{% endcontent-ref %}
+
+{% content-ref url="assertvisible.md" %}
+[assertvisible.md](assertvisible.md)
+{% endcontent-ref %}

api-reference/commands/assertnotequal.md

@@ -0,0 +1,101 @@
+---
+description: Assert that two values are not equal in Maestro flows.
+---
+
+# assertNotEqual
+
+Asserts that two values are not equal after JavaScript evaluation:
+
+```yaml
+- assertNotEqual:
+    value1: "foo"
+    value2: "bar"
+```
+
+This command compares `value1` and `value2` as strings after evaluating any JavaScript expressions. If the values are equal, the assertion fails.
+
+### Basic usage
+
+Ensure a value is not a specific string:
+
+```yaml
+- assertNotEqual:
+    value1: ${output.status}
+    value2: "error"
+```
+
+Verify UI text has changed:
+
+```yaml
+- copyTextFrom:
+    id: "counter"
+- evalScript: ${output.initialCount = maestro.copiedText}
+- tapOn: "Increment"
+- copyTextFrom:
+    id: "counter"
+- assertNotEqual:
+    value1: ${maestro.copiedText}
+    value2: ${output.initialCount}
+    label: "Counter should have changed"
+```
+
+### With label and optional
+
+```yaml
+- assertNotEqual:
+    value1: ${output.userId}
+    value2: ""
+    label: "User ID should not be empty"
+    optional: true
+```
+
+### Use in conditions
+
+`assertNotEqual` can be used in `runFlow` and `repeat` conditions:
+
+```yaml
+- runFlow:
+    when:
+      notEqual:
+        value1: ${output.status}
+        value2: "disabled"
+    commands:
+      - tapOn: "Submit"
+```
+
+```yaml
+- repeat:
+    while:
+      notEqual:
+        value1: ${output.loading}
+        value2: "false"
+    commands:
+      - waitForAnimationToEnd
+```
+
+### Considerations
+
+`assertNotEqual` compares values as strings after JavaScript evaluation:
+
+- **Numbers are normalized**: `${1}` and `${1.0}` both evaluate to `"1"` and will match
+- **Booleans become strings**: `${true}` evaluates to `"true"`
+
+This means `${true}` and `${1}` are not considered equal — they evaluate to `"true"` and `"1"` respectively. If you need JavaScript type coercion (where `1 == true`), use `assertTrue`:
+
+```yaml
+- assertTrue: ${1 == true}
+```
+
+### Related commands
+
+{% content-ref url="assertequal.md" %}
+[assertequal.md](assertequal.md)
+{% endcontent-ref %}
+
+{% content-ref url="asserttrue.md" %}
+[asserttrue.md](asserttrue.md)
+{% endcontent-ref %}
+
+{% content-ref url="assertnotvisible.md" %}
+[assertnotvisible.md](assertnotvisible.md)
+{% endcontent-ref %}

api-reference/commands/asserttrue.md

@@ -36,3 +36,7 @@ You can also use it to immediately fail the test:
 {% content-ref url="assertnotvisible.md" %}
 [assertnotvisible.md](assertnotvisible.md)
 {% endcontent-ref %}
+
+{% content-ref url="assertequal.md" %}
+[assertequal.md](assertequal.md)
+{% endcontent-ref %}