Merge pull request #1353 from amanchopra1905/stage

kane ai assertion feature

Author: surishubham

assets/images/kane-ai/features/assertion/img1.png

@@ -0,0 +1,84 @@
+---
+id: kane-ai-assertions
+title: KaneAI - Assertions
+hide_title: false
+sidebar_label: Assertions
+description: Learn how to define and apply soft and hard assertions on your test code executed via KaneAI
+keywords:
+  - lambdatest automation
+  - lambdatest kaneai
+  - kaneai assertions
+  - kaneai hard assertion
+  - kaneai soft assertion
+url: https://www.lambdatest.com/support/docs/kane-ai-assertions/
+site_name: LambdaTest
+slug: kane-ai-assertions/
+---
+
+<script type="application/ld+json"
+      dangerouslySetInnerHTML={{ __html: JSON.stringify({
+       "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        "itemListElement": [{
+          "@type": "ListItem",
+          "position": 1,
+          "name": "Home",
+          "item": "https://www.lambdatest.com"
+        },{
+          "@type": "ListItem",
+          "position": 2,
+          "name": "Support",
+          "item": "https://www.lambdatest.com/support/docs/"
+        },{
+          "@type": "ListItem",
+          "position": 3,
+          "name": "KaneAI Assertions",
+          "item": "https://www.lambdatest.com/support/docs/kane-ai-assertions/"
+        }]
+      })
+    }}
+></script>
+The Assertion Feature in KaneAI enhances test execution control by transitioning from soft assertions (which allow tests to proceed despite failures) to hard assertions, where test execution stops immediately upon failure. This feature ensures that failures are logged with detailed remarks, providing better debugging insights. However, users retain flexibility by marking specific assertions as soft, allowing test execution to continue selectively.
+
+## Key Features
+- **Hard Assertions :** Test execution halts immediately upon assertion failure, marking the test as failed.
+- **Soft Assertions :** Specific assertions can be marked as soft, allowing test execution to continue despite failures.
+- **Detailed Failure Logging :** Every failed assertion logs comprehensive failure remarks for better debugging.
+- **Improved Test Control :** Users can customize assertion behavior based on test requirements.
+
+## Step-by-Step Guide
+
+### Step 1: Initiate a Test Session
+- Log in to your LambdaTest account.
+- Click on Create a Web / App Test to start a new session within Kane AI.
+
+<img loading="lazy" src={require('../assets/images/kane-ai/features/assertion/img1.png').default} alt="kaneai" className="doc_img"/>
+
+### Step 2: Perform an Assertion test
+- Create an assertion step and KaneAI will perform a visual query to detect if the specified test is valid or not.
+- If the assertion passes, it is marked as **Assertion True**.
+- If the assertion fails it will be marked as **Assertion Failed**.
+
+<img loading="lazy" src={require('../assets/images/kane-ai/features/assertion/img2.png').default} alt="kaneai" className="doc_img"/>
+
+### Step 3: Configure Hard Assertion
+- Click on the assertion step where the test failed.
+- Toggle the button to enable or disable the **Hard assertion**:
+- If enabled, test execution stops immediately on failure.
+- If disabled, the test continues execution despite the failure.
+- Save the configuration and proceed.
+
+<img loading="lazy" src={require('../assets/images/kane-ai/features/assertion/img3.png').default} alt="kaneai" className="doc_img"/>
+
+### Step 4: Review and Execute the test
+- Navigate to the Test Manager to view the summary of executed tests.
+- Review the steps performed, and click on the **save** button.
+- Navigate to the **Code** tab, your code is generated to run on HyperExecute.
+- Click on the button **Run on HyperExecute**.
+
+<img loading="lazy" src={require('../assets/images/kane-ai/features/assertion/img4.png').default} alt="kaneai" className="doc_img"/>
+
+### Step 5: Monitor the Test Execution
+- Veriy your test results in the logs as shown below:
+
+<img loading="lazy" src={require('../assets/images/kane-ai/features/assertion/img5.png').default} alt="kaneai" className="doc_img"/>

assets/images/kane-ai/features/assertion/img2.png

@@ -1106,7 +1106,10 @@ module.exports = {
             ]
           },
           "kane-ai-modules",
-          "kane-ai-secrets"
+          "kane-ai-secrets",
+          "kaneai-upload-and-download-files",
+          "kaneai-modules-versions-and-enhancement",
+          "kane-ai-assertions"
         ],
       },
       {
@@ -1116,8 +1119,6 @@ module.exports = {
         items: [
           "kane-ai-command-guide",
           "kane-ai-web-test-writing-guidelines",
-          "kaneai-upload-and-download-files",
-          "kaneai-modules-versions-and-enhancement"
         ],
       },
       {