codeceptjs 2.1.3 → 2.2.1

package/lib/helper/WebDriverIO.js

@@ -533,7 +533,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/amOnPage }}
+   * {{> amOnPage }}
    * Appium: support only web testing
    */
   amOnPage(url) {
@@ -541,7 +541,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/click }}
+   * {{> click }}
    * Appium: support
    */
   async click(locator, context = null) {
@@ -558,7 +558,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/doubleClick }}
+   * {{> doubleClick }}
    * Appium: support only web testing
    */
   async doubleClick(locator, context = null) {
@@ -577,7 +577,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/rightClick }}
+   * {{> rightClick }}
    * Appium: support, but in apps works as usual click
    */
   async rightClick(locator) {
@@ -594,7 +594,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/fillField }}
+   * {{> fillField }}
    * Appium: support
    */
   async fillField(field, value) {
@@ -605,7 +605,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/appendField }}
+   * {{> appendField }}
    * Appium: support, but it's clear a field before insert in apps
    */
   async appendField(field, value) {
@@ -617,7 +617,7 @@ class WebDriverIO extends Helper {
 
 
   /**
-   * {{> ../webapi/clearField}}
+   * {{> clearField}}
    * Appium: support
    */
   async clearField(field) {
@@ -629,7 +629,7 @@ class WebDriverIO extends Helper {
 
 
   /**
-   * {{> ../webapi/selectOption}}
+   * {{> selectOption}}
    */
   async selectOption(select, option) {
     const res = await findFields.call(this, select);
@@ -660,7 +660,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/attachFile }}
+   * {{> attachFile }}
    * Appium: not tested
    */
   async attachFile(locator, pathToFile) {
@@ -677,7 +677,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/checkOption }}
+   * {{> checkOption }}
    * Appium: not tested
    */
   async checkOption(field, context = null) {
@@ -695,7 +695,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/uncheckOption }}
+   * {{> uncheckOption }}
    * Appium: not tested
    */
   async uncheckOption(field, context = null) {
@@ -713,7 +713,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabTextFrom }}
+   * {{> grabTextFrom }}
    * Appium: support
    */
   async grabTextFrom(locator) {
@@ -725,7 +725,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabHTMLFrom }}
+   * {{> grabHTMLFrom }}
    * Appium: support only web testing
    */
   async grabHTMLFrom(locator) {
@@ -735,7 +735,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabValueFrom }}
+   * {{> grabValueFrom }}
    * Appium: support only web testing
    */
   async grabValueFrom(locator) {
@@ -746,7 +746,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabCssPropertyFrom }}
+   * {{> grabCssPropertyFrom }}
    */
   async grabCssPropertyFrom(locator, cssProperty) {
     const res = await this._locate(locator, true);
@@ -755,7 +755,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabAttributeFrom }}
+   * {{> grabAttributeFrom }}
    * Appium: can be used for apps only with several values ("contentDescription", "text", "className", "resourceId")
    */
   async grabAttributeFrom(locator, attr) {
@@ -765,7 +765,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeInTitle }}
+   * {{> seeInTitle }}
    * Appium: support only web testing
    */
   async seeInTitle(text) {
@@ -788,7 +788,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeInTitle }}
+   * {{> dontSeeInTitle }}
    * Appium: support only web testing
    */
   async dontSeeInTitle(text) {
@@ -797,7 +797,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabTitle }}
+   * {{> grabTitle }}
    * Appium: support only web testing
    */
   async grabTitle() {
@@ -807,7 +807,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/see }}
+   * {{> see }}
    * Appium: support with context in apps
    */
   async see(text, context = null) {
@@ -829,7 +829,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSee }}
+   * {{> dontSee }}
    * Appium: support with context in apps
    */
   async dontSee(text, context = null) {
@@ -837,7 +837,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeInField }}
+   * {{> seeInField }}
    * Appium: support only web testing
    */
   async seeInField(field, value) {
@@ -845,7 +845,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeInField }}
+   * {{> dontSeeInField }}
    * Appium: support only web testing
    */
   async dontSeeInField(field, value) {
@@ -853,7 +853,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeCheckboxIsChecked }}
+   * {{> seeCheckboxIsChecked }}
    * Appium: not tested
    */
   async seeCheckboxIsChecked(field) {
@@ -861,7 +861,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeCheckboxIsChecked }}
+   * {{> dontSeeCheckboxIsChecked }}
    * Appium: not tested
    */
   async dontSeeCheckboxIsChecked(field) {
@@ -869,7 +869,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeElement }}
+   * {{> seeElement }}
    * Appium: support
    */
   async seeElement(locator) {
@@ -883,7 +883,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeElement}}
+   * {{> dontSeeElement}}
    * Appium: support
    */
   async dontSeeElement(locator) {
@@ -896,7 +896,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeElementInDOM }}
+   * {{> seeElementInDOM }}
    * Appium: support
    */
   async seeElementInDOM(locator) {
@@ -905,7 +905,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeElementInDOM }}
+   * {{> dontSeeElementInDOM }}
    * Appium: support
    */
   async dontSeeElementInDOM(locator) {
@@ -914,7 +914,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeInSource }}
+   * {{> seeInSource }}
    * Appium: support
    */
   async seeInSource(text) {
@@ -923,7 +923,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabSource }}
+   * {{> grabSource }}
    * Appium: support
    */
   async grabSource() {
@@ -943,7 +943,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabCurrentUrl }}
+   * {{> grabCurrentUrl }}
    */
   async grabCurrentUrl() {
     const res = await this.browser.url();
@@ -957,7 +957,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeInSource }}
+   * {{> dontSeeInSource }}
    * Appium: support
    */
   async dontSeeInSource(text) {
@@ -983,7 +983,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeNumberOfVisibleElements }}
+   * {{> seeNumberOfVisibleElements }}
    */
   async seeNumberOfVisibleElements(locator, num) {
     const res = await this.grabNumberOfVisibleElements(locator);
@@ -991,7 +991,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeCssPropertiesOnElements }}
+   * {{> seeCssPropertiesOnElements }}
    */
   async seeCssPropertiesOnElements(locator, cssProperties) {
     const res = await this._locate(locator);
@@ -1026,7 +1026,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeAttributesOnElements }}
+   * {{> seeAttributesOnElements }}
    */
   async seeAttributesOnElements(locator, attributes) {
     const res = await this._locate(locator);
@@ -1053,7 +1053,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabNumberOfVisibleElements }}
+   * {{> grabNumberOfVisibleElements }}
    */
   async grabNumberOfVisibleElements(locator) {
     const res = await this._locate(locator);
@@ -1065,7 +1065,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeInCurrentUrl }}
+   * {{> seeInCurrentUrl }}
    * Appium: support only web testing
    */
   async seeInCurrentUrl(url) {
@@ -1074,7 +1074,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeInCurrentUrl }}
+   * {{> dontSeeInCurrentUrl }}
    * Appium: support only web testing
    */
   async dontSeeInCurrentUrl(url) {
@@ -1083,7 +1083,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeCurrentUrlEquals }}
+   * {{> seeCurrentUrlEquals }}
    * Appium: support only web testing
    */
   async seeCurrentUrlEquals(url) {
@@ -1092,7 +1092,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeCurrentUrlEquals }}
+   * {{> dontSeeCurrentUrlEquals }}
    * Appium: support only web testing
    */
   async dontSeeCurrentUrlEquals(url) {
@@ -1101,7 +1101,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/executeScript }}
+   * {{> executeScript }}
    * Appium: support only web testing
    *
    * Wraps [execute](http://webdriver.io/api/protocol/execute.html) command.
@@ -1111,7 +1111,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/executeAsyncScript }}
+   * {{> executeAsyncScript }}
    * Appium: support only web testing
    */
   executeAsyncScript(fn) {
@@ -1133,7 +1133,7 @@ class WebDriverIO extends Helper {
    */
 
   /**
-   * {{> ../webapi/scrollTo }}
+   * {{> scrollTo }}
    * Appium: support only web testing
    */
   async scrollTo(locator, offsetX = 0, offsetY = 0) {
@@ -1165,7 +1165,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/moveCursorTo}}
+   * {{> moveCursorTo}}
    * Appium: support only web testing
    */
   async moveCursorTo(locator, offsetX = 0, offsetY = 0) {
@@ -1199,7 +1199,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/saveScreenshot}}
+   * {{> saveScreenshot}}
    * Appium: support
    */
   async saveScreenshot(fileName, fullPage = false) {
@@ -1228,7 +1228,7 @@ class WebDriverIO extends Helper {
 
 
   /**
-   * {{> ../webapi/setCookie}}
+   * {{> setCookie}}
    * Appium: support only web testing
    *
    * Uses Selenium's JSON [cookie
@@ -1239,7 +1239,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/clearCookie}}
+   * {{> clearCookie}}
    * Appium: support only web testing
    */
   async clearCookie(cookie) {
@@ -1247,7 +1247,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/seeCookie}}
+   * {{> seeCookie}}
    * Appium: support only web testing
    */
   async seeCookie(name) {
@@ -1256,7 +1256,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dontSeeCookie}}
+   * {{> dontSeeCookie}}
    * Appium: support only web testing
    */
   async dontSeeCookie(name) {
@@ -1265,7 +1265,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabCookie}}
+   * {{> grabCookie}}
    * Appium: support only web testing
    */
   async grabCookie(name) {
@@ -1325,8 +1325,8 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/pressKey }}
-   * {{> ../webapi/_keys }}
+   * {{> pressKey }}
+   * {{> _keys }}
    *
    * To make combinations with modifier and mouse clicks (like Ctrl+Click) press a modifier, click, then release it.
    * Appium: support, but clear field before pressing in apps:
@@ -1349,7 +1349,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/resizeWindow }}
+   * {{> resizeWindow }}
    * Appium: not tested in web, in apps doesn't work
    */
   async resizeWindow(width, height) {
@@ -1370,7 +1370,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/dragAndDrop }}
+   * {{> dragAndDrop }}
    * Appium: not tested
    */
   async dragAndDrop(srcElement, destElement) {
@@ -1429,7 +1429,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/wait }}
+   * {{> wait }}
    * Appium: support
    */
   async wait(sec) {
@@ -1437,7 +1437,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForEnabled }}
+   * {{> waitForEnabled }}
    * Appium: support
    */
   async waitForEnabled(locator, sec = null) {
@@ -1457,7 +1457,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForElement }}
+   * {{> waitForElement }}
    * Appium: support
    */
   async waitForElement(locator, sec = null) {
@@ -1477,7 +1477,7 @@ class WebDriverIO extends Helper {
 
 
   /**
-   * {{> ../webapi/waitInUrl }}
+   * {{> waitInUrl }}
    */
   async waitInUrl(urlPart, sec = null) {
     const client = this.browser;
@@ -1499,7 +1499,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitUrlEquals }}
+   * {{> waitUrlEquals }}
    */
   async waitUrlEquals(urlPart, sec = null) {
     const aSec = sec || this.options.waitForTimeout;
@@ -1523,7 +1523,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForText }}
+   * {{> waitForText }}
    * Appium: support
    */
   async waitForText(text, sec = null, context = null) {
@@ -1544,7 +1544,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForValue }}
+   * {{> waitForValue }}
    */
   async waitForValue(field, value, sec = null) {
     const client = this.browser;
@@ -1564,7 +1564,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForVisible }}
+   * {{> waitForVisible }}
    * Appium: support
    */
   async waitForVisible(locator, sec = null) {
@@ -1581,7 +1581,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitNumberOfVisibleElements }}
+   * {{> waitNumberOfVisibleElements }}
    */
   async waitNumberOfVisibleElements(locator, num, sec = null) {
     const aSec = sec || this.options.waitForTimeout;
@@ -1596,7 +1596,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForInvisible }}
+   * {{> waitForInvisible }}
    * Appium: support
    */
   async waitForInvisible(locator, sec = null) {
@@ -1613,7 +1613,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitToHide }}
+   * {{> waitToHide }}
    * Appium: support
    */
   async waitToHide(locator, sec = null) {
@@ -1626,7 +1626,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForDetached }}
+   * {{> waitForDetached }}
    * Appium: support
    */
   async waitForDetached(locator, sec = null) {
@@ -1641,7 +1641,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitForFunction }}
+   * {{> waitForFunction }}
    * Appium: support
    */
   async waitForFunction(fn, argsOrSec = null, sec = null) {
@@ -1660,7 +1660,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/waitUntil }}
+   * {{> waitUntil }}
    * @param interval (optional) time in seconds between condition checks.
    * * *Appium*: supported
    */
@@ -1671,7 +1671,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/switchTo }}
+   * {{> switchTo }}
    * Appium: support only web testing
    */
   async switchTo(locator) {
@@ -1761,7 +1761,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabNumberOfOpenTabs }}
+   * {{> grabNumberOfOpenTabs }}
    */
   async grabNumberOfOpenTabs() {
     const pages = await this.browser.getTabIds();
@@ -1769,7 +1769,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/refreshPage }}
+   * {{> refreshPage }}
    */
   async refreshPage() {
     const client = this.browser;
@@ -1777,7 +1777,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/scrollPageToTop }}
+   * {{> scrollPageToTop }}
    */
   scrollPageToTop() {
     const client = this.browser;
@@ -1789,7 +1789,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/scrollPageToBottom }}
+   * {{> scrollPageToBottom }}
    */
   scrollPageToBottom() {
     const client = this.browser;
@@ -1806,7 +1806,7 @@ class WebDriverIO extends Helper {
   }
 
   /**
-   * {{> ../webapi/grabPageScrollPosition}}
+   * {{> grabPageScrollPosition}}
    */
   async grabPageScrollPosition() {
     /* eslint-disable comma-dangle */

package/lib/helper/clientscripts/nightmare.js

@@ -139,5 +139,13 @@ if (!window.codeceptjs) {
     return element.dispatchEvent(event);
   };
 
+  codeceptjs.unCheckEl = function (el) {
+    const element = this.fetchElement(el);
+    const event = document.createEvent('HTMLEvents');
+    element.checked = false;
+    event.initEvent('change', true, true);
+    return element.dispatchEvent(event);
+  };
+
   window.codeceptjs = codeceptjs;
 }

package/lib/helper/extras/React.js

@@ -0,0 +1,55 @@
+const fs = require('fs');
+
+let resqScript;
+
+module.exports = async function findReact(matcher, locator) {
+  if (!resqScript) resqScript = fs.readFileSync(require.resolve('resq'));
+  await matcher.executionContext().evaluate(resqScript.toString());
+  await matcher.executionContext().evaluate(() => window.resq.waitToLoadReact());
+  const arrayHandle = await matcher.executionContext().evaluateHandle((selector, props, state, reactElement) => {
+    let elements = window.resq.resq$$(selector);
+    if (Object.keys(props).length) {
+      elements = elements.byProps(props);
+    }
+    if (Object.keys(state).length) {
+      elements = elements.byState(state);
+    }
+
+    if (!elements.length) {
+      return [];
+    }
+
+    // resq returns an array of HTMLElements if the React component is a fragment
+    // this avoids having nested arrays of nodes which the driver does not understand
+    // [[div, div], [div, div]] => [div, div, div, div]
+    let nodes = [];
+
+    elements.forEach((element) => {
+      let { node, isFragment } = element;
+
+      if (!node) {
+        isFragment = true;
+        node = element.children;
+      }
+
+      if (isFragment) {
+        nodes = nodes.concat(node);
+      } else {
+        nodes.push(node);
+      }
+    });
+
+    return [...nodes];
+  }, locator.react, locator.props || {}, locator.state || {}, locator.children || {}, matcher);
+
+  const properties = await arrayHandle.getProperties();
+  await arrayHandle.dispose();
+  const result = [];
+  for (const property of properties.values()) {
+    const elementHandle = property.asElement();
+    if (elementHandle) { result.push(elementHandle); }
+  }
+
+
+  return result;
+};