@cuppet/core 1.0.11 → 1.0.13

package/README.md

@@ -137,6 +137,12 @@ Make sure to install these in your project:
 yarn install @cucumber/cucumber config
 ```
 
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on how to submit pull requests and our development workflow.
+
+For detailed development setup and publishing information, check out our [Development Guide](developmentGuide.md).
+
 ## License
 
 ISC

package/features/app/stepDefinitions/pageElements.js

@@ -41,6 +41,11 @@ Then('I should see {string} in {string} region', async function (text, region) {
     await utils.seeTextInRegion(this.page, resolvedText, region);
 });
 
+Then('I should not see {string} in {string} region', async function (text, region) {
+    const resolvedText = this.mlStrings[text] ?? text;
+    await utils.notSeeTextInRegion(this.page, resolvedText, region);
+});
+
 Then('I should see the element with selector {string}', async function (cssSelector) {
     const selector = this.commonFields[cssSelector] ?? cssSelector;
     await utils.seeElement(this.page, selector);
@@ -49,9 +54,13 @@ Then('I should see the element with selector {string} in the DOM', async functio
     const selector = this.commonFields[cssSelector] ?? cssSelector;
     await utils.seeElement(this.page, selector, false);
 });
+Then('I should not see the element with selector {string} in the DOM', async function (cssSelector) {
+    const selector = this.commonFields[cssSelector] ?? cssSelector;
+    await utils.notSeeElement(this.page, selector, false);
+});
 Then('I should not see the element with selector {string}', async function (cssSelector) {
     const selector = this.commonFields[cssSelector] ?? cssSelector;
-    await utils.notSeeElement(this.page, selector);
+    await utils.notSeeElement(this.page, selector, true);
 });
 Then('I wait for element {string} to disappear within {string} seconds', async function (cssSelector, time) {
     const selector = this.commonFields[cssSelector] ?? cssSelector;

package/features/app/world.js

@@ -25,4 +25,4 @@ class World {
 setWorldConstructor(World);
 
 // Export the World class for use in the main repository
-module.exports = { World };
+module.exports = { World };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cuppet/core",
-    "version": "1.0.11",
+    "version": "1.0.13",
     "description": "Core testing framework components for Cuppet - BDD framework based on Cucumber and Puppeteer",
     "main": "index.js",
     "files": [

package/src/elementInteraction.js

@@ -311,13 +311,15 @@ module.exports = {
     },
 
     /**
-     * Element should not exist in the page DOM.
+     * Verify whether element is visible or not.
+     * Depending on VisibleInDOM boolean will check if it is only hidden or not present in the DOM.
      * @param {Page} page
      * @param selector
+     * @param VisibleInDOM
      * @param time
      * @returns {Promise<void>}
      */
-    notSeeElement: async function (page, selector, time = 5000) {
+    notSeeElement: async function (page, selector, VisibleInDOM, time = 5000) {
         const options = {
             hidden: true,
             timeout: time, // Maximum time to wait in milliseconds (default: 30000)
@@ -328,8 +330,8 @@ module.exports = {
         } catch {
             throw new Error('Element is visible!');
         }
-        if (isElementInPage) {
-            throw new Error(`${selector} is hidden but can be found in the page source!`);
+        if (!VisibleInDOM && isElementInPage) {
+            throw new Error(`${selector} is hidden but can be found in the page source (DOM)!`);
         }
     },
 
@@ -411,6 +413,31 @@ module.exports = {
         }
     },
 
+    /**
+     * Validate that text is not visible in specific region (another element).
+     * To be used when multiple renders of the same text are shown on the page.
+     * @param {Page} page
+     * @param text
+     * @param region
+     * @param time
+     * @returns {Promise<void>}
+     */
+    notSeeTextInRegion: async function (page, text, region, time = 3000) {
+        const regionClass = await helper.getRegion(page, region);
+        const selector = 'xpath/' + `//*[contains(@class,'${regionClass}') and .//text()[contains(.,"${text}")]]`;
+        const options = {
+            visible: true, // With true flag it will fail only if the element is in the dom and visible
+            timeout: time, // Maximum time to wait in milliseconds (default is 30s which is a lot for a negative step)
+        };
+        try {
+            await page.waitForSelector(selector, options);
+            throw new Error(`Text ${text} is visible in ${regionClass}!`);
+        } catch {
+            // Element not visible - that's the expected result
+            return;
+        }
+    },
+
     /**
      * Hover element based on text content (useful for text inside spans, paragraphs etc. like menu links)
      * @param {Page} page