codeceptjs 3.5.9 → 3.5.11

package/docs/build/Expect.js

@@ -20,7 +20,7 @@ chai.use(require('chai-match-pattern'));
  *{
  *   helpers: {
  *     Playwright: {...},
- *     ExpectHelper: {},
+ *     Expect: {},
  *   }
  *}
  * ```
@@ -32,7 +32,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValue
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectEqual(actualValue, expectedValue, customErrorMsg = '') {
     // @ts-ignore
@@ -44,7 +44,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValue
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectNotEqual(actualValue, expectedValue, customErrorMsg = '') {
     // @ts-ignore
@@ -56,7 +56,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValue
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
 
      */
   expectDeepEqual(actualValue, expectedValue, customErrorMsg = '') {
@@ -69,7 +69,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValue
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectNotDeepEqual(actualValue, expectedValue, customErrorMsg = '') {
     // @ts-ignore
@@ -81,7 +81,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValueToContain
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectContain(actualValue, expectedValueToContain, customErrorMsg = '') {
     // @ts-ignore
@@ -95,7 +95,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValueToNotContain
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectNotContain(
     actualValue,
@@ -113,7 +113,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValueToStartWith
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectStartsWith(actualValue, expectedValueToStartWith, customErrorMsg = '') {
     // @ts-ignore
@@ -127,7 +127,7 @@ class ExpectHelper {
      *
      * @param {*} actualValue
      * @param {*} expectedValueToNotStartWith
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectNotStartsWith(
     actualValue,
@@ -144,7 +144,7 @@ class ExpectHelper {
   /**
      * @param {*} actualValue
      * @param {*} expectedValueToEndWith
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectEndsWith(actualValue, expectedValueToEndWith, customErrorMsg = '') {
     // @ts-ignore
@@ -157,7 +157,7 @@ class ExpectHelper {
   /**
      * @param {*} actualValue
      * @param {*} expectedValueToNotEndWith
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectNotEndsWith(
     actualValue,
@@ -174,7 +174,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} jsonSchema
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectJsonSchema(targetData, jsonSchema, customErrorMsg = '') {
     // @ts-ignore
@@ -186,7 +186,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} jsonSchema
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      * @param {*} ajvOptions Pass AJV options
      */
   expectJsonSchemaUsingAJV(
@@ -204,7 +204,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} propertyName
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectHasProperty(targetData, propertyName, customErrorMsg = '') {
     // @ts-ignore
@@ -215,7 +215,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} propertyName
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectHasAProperty(targetData, propertyName, customErrorMsg = '') {
     // @ts-ignore
@@ -226,7 +226,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} type
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectToBeA(targetData, type, customErrorMsg = '') {
     // @ts-ignore
@@ -237,7 +237,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} type
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectToBeAn(targetData, type, customErrorMsg = '') {
     // @ts-ignore
@@ -248,7 +248,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} regex
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectMatchRegex(targetData, regex, customErrorMsg = '') {
     // @ts-ignore
@@ -259,7 +259,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} length
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectLengthOf(targetData, length, customErrorMsg = '') {
     // @ts-ignore
@@ -269,7 +269,7 @@ class ExpectHelper {
 
   /**
      * @param {*} targetData
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectEmpty(targetData, customErrorMsg = '') {
     // @ts-ignore
@@ -279,7 +279,7 @@ class ExpectHelper {
 
   /**
      * @param {*} targetData
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectTrue(targetData, customErrorMsg = '') {
     // @ts-ignore
@@ -289,7 +289,7 @@ class ExpectHelper {
 
   /**
      * @param {*} targetData
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectFalse(targetData, customErrorMsg = '') {
     // @ts-ignore
@@ -299,8 +299,8 @@ class ExpectHelper {
 
   /**
      * @param {*} targetData
-     * @param {*} aboveThan number | Date
-     * @param {*} customErrorMsg
+     * @param {*} aboveThan
+     * @param {*} [customErrorMsg]
      */
   expectAbove(targetData, aboveThan, customErrorMsg = '') {
     // @ts-ignore
@@ -310,8 +310,8 @@ class ExpectHelper {
 
   /**
      * @param {*} targetData
-     * @param {*} belowThan number | Date
-     * @param {*} customErrorMsg
+     * @param {*} belowThan
+     * @param {*} [customErrorMsg]
      */
   expectBelow(targetData, belowThan, customErrorMsg = '') {
     // @ts-ignore
@@ -322,7 +322,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} lengthAboveThan
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectLengthAboveThan(targetData, lengthAboveThan, customErrorMsg = '') {
     // @ts-ignore
@@ -335,7 +335,7 @@ class ExpectHelper {
   /**
      * @param {*} targetData
      * @param {*} lengthBelowThan
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectLengthBelowThan(targetData, lengthBelowThan, customErrorMsg = '') {
     // @ts-ignore
@@ -348,7 +348,7 @@ class ExpectHelper {
   /**
      * @param {*} actualValue
      * @param {*} expectedValue
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectEqualIgnoreCase(actualValue, expectedValue, customErrorMsg = '') {
     // @ts-ignore
@@ -362,7 +362,7 @@ class ExpectHelper {
      * expects members of two arrays are deeply equal
      * @param {*} actualValue
      * @param {*} expectedValue
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectDeepMembers(actualValue, expectedValue, customErrorMsg = '') {
     // @ts-ignore
@@ -376,7 +376,7 @@ class ExpectHelper {
      * expects an array to be a superset of another array
      * @param {*} superset
      * @param {*} set
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectDeepIncludeMembers(superset, set, customErrorMsg = '') {
     // @ts-ignore
@@ -391,7 +391,7 @@ class ExpectHelper {
      * @param {*} actualValue
      * @param {*} expectedValue
      * @param {*} fieldsToExclude
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectDeepEqualExcluding(
     actualValue,
@@ -410,7 +410,7 @@ class ExpectHelper {
      * expects a JSON object matches a provided pattern
      * @param {*} actualValue
      * @param {*} expectedPattern
-     * @param {*} customErrorMsg
+     * @param {*} [customErrorMsg]
      */
   expectMatchesPattern(actualValue, expectedPattern, customErrorMsg = '') {
     // @ts-ignore

package/docs/build/Nightmare.js

@@ -563,7 +563,7 @@ class Nightmare extends Helper {
    * I.see('Register', {css: 'form.register'}); // use strict locator
    * ```
    * @param {string} text expected on page.
-   * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
+   * @param {?string | object} [context=null] (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -581,7 +581,7 @@ class Nightmare extends Helper {
    * ```
    * 
    * @param {string} text which is not present.
-   * @param {CodeceptJS.LocatorOrString} [context] (optional) element located by CSS|XPath|strict locator in which to perfrom search.
+   * @param {string | object} [context] (optional) element located by CSS|XPath|strict locator in which to perfrom search.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -596,7 +596,7 @@ class Nightmare extends Helper {
    * ```js
    * I.seeElement('#modal');
    * ```
-   * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
+   * @param {string | object} locator located by CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -615,7 +615,7 @@ class Nightmare extends Helper {
    * I.dontSeeElement('.modal'); // modal is not shown
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|Strict locator.
+   * @param {string | object} locator located by CSS|XPath|Strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -635,7 +635,7 @@ class Nightmare extends Helper {
    * ```js
    * I.seeElementInDOM('#modal');
    * ```
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -652,7 +652,7 @@ class Nightmare extends Helper {
    * I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or not
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|Strict locator.
+   * @param {string | object} locator located by CSS|XPath|Strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -702,7 +702,7 @@ class Nightmare extends Helper {
    * I.seeNumberOfElements('#submitBtn', 1);
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} num number of elements.
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -720,7 +720,7 @@ class Nightmare extends Helper {
    * I.seeNumberOfVisibleElements('.buttons', 3);
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} num number of elements.
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -738,7 +738,7 @@ class Nightmare extends Helper {
    * let numOfElements = await I.grabNumberOfVisibleElements('p');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
+   * @param {string | object} locator located by CSS|XPath|strict locator.
    * @returns {Promise<number>} number of visible elements
    */
   async grabNumberOfVisibleElements(locator) {
@@ -775,8 +775,8 @@ class Nightmare extends Helper {
    * I.click({css: 'nav a.login'});
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
-   * @param {?CodeceptJS.LocatorOrString | null} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+   * @param {string | object} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+   * @param {?string | object | null} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -798,8 +798,8 @@ class Nightmare extends Helper {
    * I.doubleClick('.btn.edit');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
-   * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
+   * @param {string | object} locator clickable link or button located by text, or any element located by CSS|XPath|strict locator.
+   * @param {?string | object} [context=null] (optional, `null` by default) element to search in CSS|XPath|Strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -822,8 +822,8 @@ class Nightmare extends Helper {
    * I.rightClick('Click me', '.context');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator clickable element located by CSS|XPath|strict locator.
-   * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS|XPath|strict locator.
+   * @param {string | object} locator clickable element located by CSS|XPath|strict locator.
+   * @param {?string | object} [context=null] (optional, `null` by default) element located by CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -843,7 +843,7 @@ class Nightmare extends Helper {
    * I.moveCursorTo('#submit', 5,5);
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
+   * @param {string | object} locator located by CSS|XPath|strict locator.
    * @param {number} [offsetX=0] (optional, `0` by default) X-axis offset.
    * @param {number} [offsetY=0] (optional, `0` by default) Y-axis offset.
    * @returns {void} automatically synchronized promise through #recorder
@@ -955,8 +955,8 @@ class Nightmare extends Helper {
    * I.checkOption('I Agree to Terms and Conditions');
    * I.checkOption('agree', '//form');
    * ```
-   * @param {CodeceptJS.LocatorOrString} field checkbox located by label | name | CSS | XPath | strict locator.
-   * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS | XPath | strict locator.
+   * @param {string | object} field checkbox located by label | name | CSS | XPath | strict locator.
+   * @param {?string | object} [context=null] (optional, `null` by default) element located by CSS | XPath | strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -978,8 +978,8 @@ class Nightmare extends Helper {
    * I.uncheckOption('I Agree to Terms and Conditions');
    * I.uncheckOption('agree', '//form');
    * ```
-   * @param {CodeceptJS.LocatorOrString} field checkbox located by label | name | CSS | XPath | strict locator.
-   * @param {?CodeceptJS.LocatorOrString} [context=null] (optional, `null` by default) element located by CSS | XPath | strict locator.
+   * @param {string | object} field checkbox located by label | name | CSS | XPath | strict locator.
+   * @param {?string | object} [context=null] (optional, `null` by default) element located by CSS | XPath | strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1004,8 +1004,8 @@ class Nightmare extends Helper {
    * // or by strict locator
    * I.fillField({css: 'form#login input[name=username]'}, 'John');
    * ```
-   * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {CodeceptJS.StringOrSecret} value text value to fill.
+   * @param {string | object} field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} value text value to fill.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1024,7 +1024,7 @@ class Nightmare extends Helper {
    * I.clearField('user[email]');
    * I.clearField('#email');
    * ```
-   * @param {LocatorOrString} editable field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} editable field located by label|name|CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder.
    * 
    */
@@ -1041,7 +1041,7 @@ class Nightmare extends Helper {
    * // typing secret
    * I.appendField('password', secret('123456'));
    * ```
-   * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator
+   * @param {string | object} field located by label|name|CSS|XPath|strict locator
    * @param {string} value text value to append.
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1063,8 +1063,8 @@ class Nightmare extends Helper {
    * I.seeInField('form input[type=hidden]','hidden_value');
    * I.seeInField('#searchform input','Search');
    * ```
-   * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {CodeceptJS.StringOrSecret} value value to check.
+   * @param {string | object} field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} value value to check.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1082,8 +1082,8 @@ class Nightmare extends Helper {
    * I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
-   * @param {CodeceptJS.StringOrSecret} value value to check.
+   * @param {string | object} field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} value value to check.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1129,7 +1129,7 @@ class Nightmare extends Helper {
    * I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} field located by label|name|CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1146,7 +1146,7 @@ class Nightmare extends Helper {
    * I.dontSeeCheckboxIsChecked('agree'); // located by name
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} field located by label|name|CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1164,7 +1164,7 @@ class Nightmare extends Helper {
    * I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} locator field located by label|name|CSS|XPath|strict locator.
    * @param {string} pathToFile local file path relative to codecept.conf.ts or codecept.conf.js config file.
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1193,7 +1193,7 @@ class Nightmare extends Helper {
    * let pins = await I.grabTextFromAll('#pin li');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @returns {Promise<string[]>} attribute value
    * 
    */
@@ -1217,7 +1217,7 @@ class Nightmare extends Helper {
    * ```
    * If multiple elements found returns first element.
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @returns {Promise<string>} attribute value
    * 
    */
@@ -1240,7 +1240,7 @@ class Nightmare extends Helper {
    * ```js
    * let inputs = await I.grabValueFromAll('//form/input');
    * ```
-   * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} locator field located by label|name|CSS|XPath|strict locator.
    * @returns {Promise<string[]>} attribute value
    * 
    */
@@ -1264,7 +1264,7 @@ class Nightmare extends Helper {
    * ```js
    * let email = await I.grabValueFrom('input[name=email]');
    * ```
-   * @param {CodeceptJS.LocatorOrString} locator field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} locator field located by label|name|CSS|XPath|strict locator.
    * @returns {Promise<string>} attribute value
    * 
    */
@@ -1286,7 +1286,7 @@ class Nightmare extends Helper {
    * ```js
    * let hints = await I.grabAttributeFromAll('.tooltip', 'title');
    * ```
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {string} attr attribute name.
    * @returns {Promise<string[]>} attribute value
    * 
@@ -1312,7 +1312,7 @@ class Nightmare extends Helper {
    * ```js
    * let hint = await I.grabAttributeFrom('#tooltip', 'title');
    * ```
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {string} attr attribute name.
    * @returns {Promise<string>} attribute value
    * 
@@ -1338,7 +1338,7 @@ class Nightmare extends Helper {
    * let postHTMLs = await I.grabHTMLFromAll('.post');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} element located by CSS|XPath|strict locator.
+   * @param {string | object} element located by CSS|XPath|strict locator.
    * @returns {Promise<string[]>} HTML code for an element
    * 
    */
@@ -1365,7 +1365,7 @@ class Nightmare extends Helper {
    * let postHTML = await I.grabHTMLFrom('#post');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} element located by CSS|XPath|strict locator.
+   * @param {string | object} element located by CSS|XPath|strict locator.
    * @returns {Promise<string>} HTML code for an element
    * 
    */
@@ -1390,7 +1390,7 @@ class Nightmare extends Helper {
    * const value = await I.grabCssPropertyFrom('h3', 'font-weight');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {string} cssProperty CSS property name.
    * @returns {Promise<string>} CSS value
    * 
@@ -1439,7 +1439,7 @@ class Nightmare extends Helper {
    * ```js
    * I.selectOption('Which OS do you use?', ['Android', 'iOS']);
    * ```
-   * @param {LocatorOrString} select field located by label|name|CSS|XPath|strict locator.
+   * @param {string | object} select field located by label|name|CSS|XPath|strict locator.
    * @param {string|Array<*>} option visible text or value of option.
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1645,7 +1645,7 @@ class Nightmare extends Helper {
    * 
    * @param {string }text to wait for.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
-   * @param {CodeceptJS.LocatorOrString} [context] (optional) element located by CSS|XPath|strict locator.
+   * @param {string | object} [context] (optional) element located by CSS|XPath|strict locator.
    * @returns {void} automatically synchronized promise through #recorder
    * 
    */
@@ -1674,7 +1674,7 @@ class Nightmare extends Helper {
    * I.waitForVisible('#popup');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1702,7 +1702,7 @@ class Nightmare extends Helper {
    * I.waitToHide('#popup');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1719,7 +1719,7 @@ class Nightmare extends Helper {
    * I.waitForInvisible('#popup');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1748,7 +1748,7 @@ class Nightmare extends Helper {
    * I.waitForElement('.btn.continue', 5); // wait for 5 secs
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec] (optional, `1` by default) time in seconds to wait
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1779,7 +1779,7 @@ class Nightmare extends Helper {
    * I.waitForDetached('#popup');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {number} [sec=1] (optional, `1` by default) time in seconds to wait
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1825,7 +1825,7 @@ class Nightmare extends Helper {
    * I.saveElementScreenshot(`#submit`,'debug.png');
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {string} fileName file name to save.
    * @returns {void} automatically synchronized promise through #recorder
    * 
@@ -1866,7 +1866,7 @@ class Nightmare extends Helper {
    * const width = await I.grabElementBoundingRect('h3', 'width');
    * // width == 527
    * ```
-   * @param {LocatorOrString} locator element located by CSS|XPath|strict locator.
+   * @param {string | object} locator element located by CSS|XPath|strict locator.
    * @param {string=} elementSize x, y, width or height of the given element.
    * @returns {Promise<DOMRect>|Promise<number>} Element bounding rectangle
    * 
@@ -1939,7 +1939,7 @@ class Nightmare extends Helper {
    * I.scrollTo('#submit', 5, 5);
    * ```
    * 
-   * @param {CodeceptJS.LocatorOrString} locator located by CSS|XPath|strict locator.
+   * @param {string | object} locator located by CSS|XPath|strict locator.
    * @param {number} [offsetX=0] (optional, `0` by default) X-axis offset.
    * @param {number} [offsetY=0] (optional, `0` by default) Y-axis offset.
    * @returns {void} automatically synchronized promise through #recorder