codeceptjs 3.3.7-beta.1 → 3.3.7

package/lib/helper/Playwright.js

@@ -44,6 +44,8 @@ const {
 } = require('./extras/PlaywrightRestartOpts');
 const { createValueEngine, createDisabledEngine } = require('./extras/PlaywrightPropEngine');
 
+const pathSeparator = path.sep;
+
 /**
  * ## Configuration
  *
@@ -52,7 +54,7 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  * @typedef PlaywrightConfig
  * @type {object}
  * @prop {string} url - base url of website to be tested
- * @prop {string} browser - a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
+ * @prop {string} [browser] - a browser to test on, either: `chromium`, `firefox`, `webkit`, `electron`. Default: chromium.
  * @prop {boolean} [show=false] - show browser window.
  * @prop {string|boolean} [restart=false] - restart strategy between tests. Possible values:
  *   * 'context' or **false** - restarts [browser context](https://playwright.dev/docs/api/class-browsercontext) but keeps running browser. Recommended by Playwright team to keep tests isolated.
@@ -80,8 +82,11 @@ const { createValueEngine, createDisabledEngine } = require('./extras/Playwright
  * @prop {string} [locale] - locale string. Example: 'en-GB', 'de-DE', 'fr-FR', ...
  * @prop {boolean} [manualStart] - do not start browser before a test, start it manually inside a helper with `this.helpers["Playwright"]._startBrowser()`.
  * @prop {object} [chromium] - pass additional chromium options
+ * @prop {object} [firefox] - pass additional firefox options
  * @prop {object} [electron] - (pass additional electron options
  * @prop {any} [channel] - (While Playwright can operate against the stock Google Chrome and Microsoft Edge browsers available on the machine. In particular, current Playwright version will support Stable and Beta channels of these browsers. See [Google Chrome & Microsoft Edge](https://playwright.dev/docs/browsers/#google-chrome--microsoft-edge).
+ * @prop {string[]} [ignoreLog] - An array with console message types that are not logged to debug log. Default value is `['warning', 'log']`. E.g. you can set `[]` to log all messages. See all possible [values](https://playwright.dev/docs/api/class-consolemessage#console-message-type).
+ * @prop {boolean} [ignoreHTTPSErrors] - Allows access to untrustworthy pages, e.g. to a page with an expired certificate. Default value is `false`
  */
 const config = {};
 
@@ -448,7 +453,7 @@ class Playwright extends Helper {
       const existingPages = await this.browserContext.pages();
       mainPage = existingPages[0] || await this.browserContext.newPage();
     }
-    targetCreatedHandler.call(this, mainPage);
+    await targetCreatedHandler.call(this, mainPage);
 
     await this._setPage(mainPage);
 
@@ -477,8 +482,6 @@ class Playwright extends Helper {
 
     // close other sessions
     try {
-      if (!this.browser.contexts) return this.browser;
-
       const contexts = await this.browser.contexts();
       const currentContext = contexts[0];
       if (currentContext && (this.options.keepCookies || this.options.keepBrowserState)) {
@@ -515,12 +518,13 @@ class Playwright extends Helper {
           browserContext = browser.context();
           page = await browser.firstWindow();
         } else {
-          browserContext = await this.browser.newContext(config);
+          browserContext = await this.browser.newContext(Object.assign(this.options, config));
           page = await browserContext.newPage();
         }
 
-        targetCreatedHandler.call(this, page);
-        this._setPage(page);
+        if (this.options.trace) await browserContext.tracing.start({ screenshots: true, snapshots: true });
+        await targetCreatedHandler.call(this, page);
+        await this._setPage(page);
         // Create a new page inside context.
         return browserContext;
       },
@@ -734,6 +738,19 @@ class Playwright extends Helper {
     });
 
     this.isRunning = true;
+    return this.browser;
+  }
+
+  /**
+   * Create a new browser context with a page. \
+   * Usually it should be run from a custom helper after call of `_startBrowser()`
+   * @param {object} [contextOptions] See https://playwright.dev/docs/api/class-browser#browser-new-context
+   */
+  async _createContextPage(contextOptions) {
+    this.browserContext = await this.browser.newContext(contextOptions);
+    const page = await this.browserContext.newPage();
+    targetCreatedHandler.call(this, page);
+    await this._setPage(page);
   }
 
   _getType() {
@@ -802,8 +819,8 @@ class Playwright extends Helper {
     if (this.isElectron) {
       throw new Error('Cannot open pages inside an Electron container');
     }
-    if (!(/^\w+\:\/\//.test(url))) {
-      url = this.options.url + url;
+    if (!(/^\w+\:(\/\/|.+)/.test(url))) {
+      url = this.options.url + (url.startsWith('/') ? url : `/${url}`);
     }
 
     if (this.options.basicAuth && (this.isAuthenticated !== true)) {
@@ -876,7 +893,7 @@ class Playwright extends Helper {
    */
   async moveCursorTo(locator, offsetX = 0, offsetY = 0) {
     const els = await this._locate(locator);
-    assertElementExists(els);
+    assertElementExists(els, locator);
 
     // Use manual mouse.move instead of .hover() so the offset can be added to the coordinates
     const { x, y } = await clickablePoint(els[0]);
@@ -903,6 +920,26 @@ class Playwright extends Helper {
     return this.page.dragAndDrop(buildLocatorString(src), buildLocatorString(dst), options);
   }
 
+  /**
+   * Restart browser with a new context and a new page
+   *
+   * ```js
+   * // Restart browser and use a new timezone
+   * I.restartBrowser({ timezoneId: 'America/Phoenix' });
+   * // Open URL in a new page in changed timezone
+   * I.amOnPage('/');
+   * // Restart browser, allow reading/copying of text from/into clipboard in Chrome
+   * I.restartBrowser({ permissions: ['clipboard-read', 'clipboard-write'] });
+   * ```
+   *
+   * @param {object} [contextOptions] [Options for browser context](https://playwright.dev/docs/api/class-browser#browser-new-context) when starting new browser
+   */
+  async restartBrowser(contextOptions) {
+    await this._stopBrowser();
+    await this._startBrowser();
+    await this._createContextPage(contextOptions);
+  }
+
   /**
    * {{> refreshPage }}
    */
@@ -1075,7 +1112,7 @@ class Playwright extends Helper {
     if (!page) {
       throw new Error(`There is no ability to switch to next tab with offset ${num}`);
     }
-    targetCreatedHandler.call(this, page);
+    await targetCreatedHandler.call(this, page);
     await this._setPage(page);
     return this._waitForAction();
   }
@@ -1159,7 +1196,7 @@ class Playwright extends Helper {
       throw new Error('Cannot open new tabs inside an Electron container');
     }
     const page = await this.browserContext.newPage(options);
-    targetCreatedHandler.call(this, page);
+    await targetCreatedHandler.call(this, page);
     await this._setPage(page);
     return this._waitForAction();
   }
@@ -1209,7 +1246,7 @@ class Playwright extends Helper {
   }
 
   /**
-   * Handles a file download.Aa file name is required to save the file on disk.
+   * Handles a file download. A file name is required to save the file on disk.
    * Files are saved to "output" directory.
    *
    * Should be used with [FileSystem helper](https://codecept.io/helpers/FileSystem) to check that file were downloaded correctly.
@@ -1218,17 +1255,19 @@ class Playwright extends Helper {
    * I.handleDownloads('downloads/avatar.jpg');
    * I.click('Download Avatar');
    * I.amInPath('output/downloads');
-   * I.waitForFile('downloads/avatar.jpg', 5);
+   * I.waitForFile('avatar.jpg', 5);
    *
    * ```
    *
    * @param {string} [fileName] set filename for downloaded file
    * @return {Promise<void>}
    */
-  async handleDownloads(fileName = 'downloads') {
+  async handleDownloads(fileName) {
     this.page.waitForEvent('download').then(async (download) => {
       const filePath = await download.path();
-      const downloadPath = path.join(global.output_dir, fileName || path.basename(filePath));
+      fileName = fileName || `downloads/${path.basename(filePath)}`;
+
+      const downloadPath = path.join(global.output_dir, fileName);
       if (!fs.existsSync(path.dirname(downloadPath))) {
         fs.mkdirSync(path.dirname(downloadPath), '0777');
       }
@@ -1471,7 +1510,7 @@ class Playwright extends Helper {
       throw new Error(`File at ${file} can not be found on local system`);
     }
     const els = await findFields.call(this, locator);
-    assertElementExists(els, 'Field');
+    assertElementExists(els, locator, 'Field');
     await els[0].setInputFiles(file);
     return this._waitForAction();
   }
@@ -1625,7 +1664,7 @@ class Playwright extends Helper {
    */
   async seeNumberOfElements(locator, num) {
     const elements = await this._locate(locator);
-    return equals(`expected number of elements (${locator}) is ${num}, but found ${elements.length}`).assert(elements.length, num);
+    return equals(`expected number of elements (${(new Locator(locator))}) is ${num}, but found ${elements.length}`).assert(elements.length, num);
   }
 
   /**
@@ -1635,7 +1674,7 @@ class Playwright extends Helper {
    */
   async seeNumberOfVisibleElements(locator, num) {
     const res = await this.grabNumberOfVisibleElements(locator);
-    return equals(`expected number of visible elements (${locator}) is ${num}, but found ${res}`).assert(res, num);
+    return equals(`expected number of visible elements (${(new Locator(locator))}) is ${num}, but found ${res}`).assert(res, num);
   }
 
   /**
@@ -1709,6 +1748,7 @@ class Playwright extends Helper {
    *
    * @param {string|function} fn function to be executed in browser context.
    * @param {any} [arg] optional argument to pass to the function
+   * @returns {Promise<any>}
    */
   async executeScript(fn, arg) {
     let context = this.page;
@@ -1856,7 +1896,7 @@ class Playwright extends Helper {
       }
       return true;
     });
-    return equals(`all elements (${locator}) to have CSS property ${JSON.stringify(cssProperties)}`).assert(chunked.length, elemAmount);
+    return equals(`all elements (${(new Locator(locator))}) to have CSS property ${JSON.stringify(cssProperties)}`).assert(chunked.length, elemAmount);
   }
 
   /**
@@ -1885,7 +1925,7 @@ class Playwright extends Helper {
       }
       return true;
     });
-    return equals(`all elements (${locator}) to have attributes ${JSON.stringify(attributes)}`).assert(chunked.length, elemAmount);
+    return equals(`all elements (${(new Locator(locator))}) to have attributes ${JSON.stringify(attributes)}`).assert(chunked.length, elemAmount);
   }
 
   /**
@@ -1949,7 +1989,7 @@ class Playwright extends Helper {
     assertElementExists(res, locator);
     if (res.length > 1) this.debug(`[Elements] Using first element out of ${res.length}`);
     const elem = res[0];
-    this.debug(`Screenshot of ${locator} element has been saved to ${outputFile}`);
+    this.debug(`Screenshot of ${(new Locator(locator))} element has been saved to ${outputFile}`);
     return elem.screenshot({ path: outputFile, type: 'png' });
   }
 
@@ -2032,29 +2072,28 @@ class Playwright extends Helper {
     }
 
     if (this.options.recordVideo && this.page && this.page.video()) {
-      const videoPath = `${global.output_dir}/videos/${clearString(test.title)}.failed.webm`;
-      test.artifacts.video = await this.page.video().path();
-      fs.rename(test.artifacts.video, videoPath, (() => {
-        test.artifacts.video = videoPath;
-      }));
+      test.artifacts.video = await saveVideoForPage(this.page, `${test.title}.failed`);
+      for (const sessionName in this.sessionPages) {
+        test.artifacts[`video_${sessionName}`] = await saveVideoForPage(this.sessionPages[sessionName], `${test.title}_${sessionName}.failed`);
+      }
     }
 
     if (this.options.trace) {
-      const path = `${`${global.output_dir}/trace/${clearString(test.title)}`.slice(0, 251)}.zip`;
-      await this.browserContext.tracing.stop({ path });
-      test.artifacts.trace = path;
+      test.artifacts.trace = await saveTraceForContext(this.browserContext, `${test.title}.failed`);
+      for (const sessionName in this.sessionPages) {
+        if (!this.sessionPages[sessionName].context) continue;
+        test.artifacts[`trace_${sessionName}`] = await saveTraceForContext(this.sessionPages[sessionName].context(), `${test.title}_${sessionName}.failed`);
+      }
     }
   }
 
   async _passed(test) {
     if (this.options.recordVideo && this.page && this.page.video()) {
-      const videoPath = `${global.output_dir}/videos/${clearString(test.title)}.passed.webm`;
-
       if (this.options.keepVideoForPassedTests) {
-        test.artifacts.video = await this.page.video().path();
-        fs.rename(test.artifacts.video, videoPath, (() => {
-          test.artifacts.video = videoPath;
-        }));
+        test.artifacts.video = await saveVideoForPage(this.page, `${test.title}.passed`);
+        for (const sessionName of Object.keys(this.sessionPages)) {
+          test.artifacts[`video_${sessionName}`] = await saveVideoForPage(this.sessionPages[sessionName], `${test.title}_${sessionName}.passed`);
+        }
       } else {
         this.page.video().delete().catch(e => {});
       }
@@ -2062,9 +2101,13 @@ class Playwright extends Helper {
 
     if (this.options.trace) {
       if (this.options.keepTraceForPassedTests) {
-        const path = `${global.output_dir}/trace/${clearString(test.title)}.zip`;
-        await this.browserContext.tracing.stop({ path });
-        test.artifacts.trace = path;
+        if (this.options.trace) {
+          test.artifacts.trace = await saveTraceForContext(this.browserContext, `${test.title}.passed`);
+          for (const sessionName in this.sessionPages) {
+            if (!this.sessionPages[sessionName].context) continue;
+            test.artifacts[`trace_${sessionName}`] = await saveTraceForContext(this.sessionPages[sessionName].context(), `${test.title}_${sessionName}.passed`);
+          }
+        }
       } else {
         await this.browserContext.tracing.stop();
       }
@@ -2785,7 +2828,7 @@ async function targetCreatedHandler(page) {
   page.on('load', () => {
     page.$('body')
       .catch(() => null)
-      .then(async context => {
+      .then(async () => {
         if (this.context && this.context._type === 'Frame') {
           // we are inside iframe?
           const frameEl = await this.context.frameElement();
@@ -2810,7 +2853,7 @@ async function targetCreatedHandler(page) {
     try {
       await page.setViewportSize(parseWindowSize(this.options.windowSize));
     } catch (err) {
-      // target can be already closed, ignoring...
+      this.debug('Target can be already closed, ignoring...');
     }
   }
 }
@@ -2935,3 +2978,21 @@ async function refreshContextSession() {
     });
   }
 }
+
+async function saveVideoForPage(page, name) {
+  if (!page.video()) return null;
+  const fileName = `${global.output_dir}${pathSeparator}videos${pathSeparator}${Date.now()}_${clearString(name).slice(0, 245)}.webm`;
+  page.video().saveAs(fileName).then(() => {
+    if (!page) return;
+    page.video().delete().catch(e => {});
+  });
+  return fileName;
+}
+
+async function saveTraceForContext(context, name) {
+  if (!context) return;
+  if (!context.tracing) return;
+  const fileName = `${`${global.output_dir}${pathSeparator}trace${pathSeparator}${Date.now()}_${clearString(name)}`.slice(0, 245)}.zip`;
+  await context.tracing.stop({ path: fileName });
+  return fileName;
+}

package/lib/helper/Protractor.js

@@ -153,7 +153,7 @@ class Protractor extends Helper {
     if (config.proxy) config.capabilities.proxy = config.proxy;
     if (config.browser) config.capabilities.browserName = config.browser;
 
-    config.waitForTimeout /= 1000; // convert to seconds
+    config.waitForTimeoutInSeconds = config.waitForTimeout / 1000; // convert to seconds
     return config;
   }
 
@@ -722,7 +722,7 @@ class Protractor extends Helper {
    */
   async grabTextFrom(locator) {
     const texts = await this.grabTextFromAll(locator);
-    assertElementExists(texts);
+    assertElementExists(texts, locator);
     if (texts.length > 1) {
       this.debugSection('GrabText', `Using first element out of ${texts.length}`);
     }
@@ -748,7 +748,7 @@ class Protractor extends Helper {
    */
   async grabHTMLFrom(locator) {
     const html = await this.grabHTMLFromAll(locator);
-    assertElementExists(html);
+    assertElementExists(html, locator);
     if (html.length > 1) {
       this.debugSection('GrabHTMl', `Using first element out of ${html.length}`);
     }
@@ -920,7 +920,7 @@ class Protractor extends Helper {
    */
   async seeNumberOfElements(locator, num) {
     const elements = await this._locate(locator);
-    return equals(`expected number of elements (${locator}) is ${num}, but found ${elements.length}`).assert(elements.length, num);
+    return equals(`expected number of elements (${(new Locator(locator))}) is ${num}, but found ${elements.length}`).assert(elements.length, num);
   }
 
   /**
@@ -928,7 +928,7 @@ class Protractor extends Helper {
    */
   async seeNumberOfVisibleElements(locator, num) {
     const res = await this.grabNumberOfVisibleElements(locator);
-    return equals(`expected number of visible elements (${locator}) is ${num}, but found ${res}`).assert(res, num);
+    return equals(`expected number of visible elements (${(new Locator(locator))}) is ${num}, but found ${res}`).assert(res, num);
   }
 
   /**
@@ -968,7 +968,7 @@ class Protractor extends Helper {
         missingAttributes.push(...missing);
       }
     }
-    return equals(`all elements (${locator}) to have CSS property ${JSON.stringify(cssProperties)}`).assert(missingAttributes.length, 0);
+    return equals(`all elements (${(new Locator(locator))}) to have CSS property ${JSON.stringify(cssProperties)}`).assert(missingAttributes.length, 0);
   }
 
   /**
@@ -995,7 +995,7 @@ class Protractor extends Helper {
       }
     }
 
-    return equals(`all elements (${locator}) to have attributes ${JSON.stringify(attributes)}`).assert(missingAttributes.length, 0);
+    return equals(`all elements (${(new Locator(locator))}) to have attributes ${JSON.stringify(attributes)}`).assert(missingAttributes.length, 0);
   }
 
   /**
@@ -1060,7 +1060,7 @@ class Protractor extends Helper {
     assertElementExists(res, locator);
     if (res.length > 1) this.debug(`[Elements] Using first element out of ${res.length}`);
     const elem = res[0];
-    this.debug(`Screenshot of ${locator} element has been saved to ${outputFile}`);
+    this.debug(`Screenshot of ${(new Locator(locator))} element has been saved to ${outputFile}`);
     const png = await elem.takeScreenshot();
     return writeFile(png, outputFile);
   }
@@ -1200,8 +1200,8 @@ class Protractor extends Helper {
   async dragAndDrop(srcElement, destElement) {
     const srcEl = await this._locate(srcElement, true);
     const destEl = await this._locate(destElement, true);
-    assertElementExists(srcEl);
-    assertElementExists(destEl);
+    assertElementExists(srcEl, srcElement);
+    assertElementExists(destEl, destElement);
     return this.browser
       .actions()
       .dragAndDrop(srcEl[0], destEl[0])
@@ -1348,7 +1348,7 @@ class Protractor extends Helper {
    * {{> waitForElement }}
    */
   async waitForElement(locator, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const el = global.element(guessLocator(locator) || global.by.css(locator));
     return this.browser.wait(EC.presenceOf(el), aSec * 1000);
   }
@@ -1364,7 +1364,7 @@ class Protractor extends Helper {
    * {{> waitForDetached }}
    */
   async waitForDetached(locator, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const el = global.element(guessLocator(locator) || global.by.css(locator));
     return this.browser.wait(EC.not(EC.presenceOf(el)), aSec * 1000).catch((err) => {
       if (err.message && err.message.indexOf('Wait timed out after') > -1) {
@@ -1381,7 +1381,7 @@ class Protractor extends Helper {
    * ```
    */
   async waitForClickable(locator, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const el = global.element(guessLocator(locator) || global.by.css(locator));
     return this.browser.wait(EC.elementToBeClickable(el), aSec * 1000);
   }
@@ -1390,7 +1390,7 @@ class Protractor extends Helper {
    * {{> waitForVisible }}
    */
   async waitForVisible(locator, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const el = global.element(guessLocator(locator) || global.by.css(locator));
     return this.browser.wait(EC.visibilityOf(el), aSec * 1000);
   }
@@ -1406,7 +1406,7 @@ class Protractor extends Helper {
    * {{> waitForInvisible }}
    */
   async waitForInvisible(locator, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const el = global.element(guessLocator(locator) || global.by.css(locator));
     return this.browser.wait(EC.invisibilityOf(el), aSec * 1000);
   }
@@ -1431,12 +1431,12 @@ class Protractor extends Helper {
       };
     }
 
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const guessLoc = guessLocator(locator) || global.by.css(locator);
 
     return this.browser.wait(visibilityCountOf(guessLoc, num), aSec * 1000)
       .catch(() => {
-        throw Error(`The number of elements (${locator}) is not ${num} after ${aSec} sec`);
+        throw Error(`The number of elements (${(new Locator(locator))}) is not ${num} after ${aSec} sec`);
       });
   }
 
@@ -1444,12 +1444,12 @@ class Protractor extends Helper {
    * {{> waitForEnabled }}
    */
   async waitForEnabled(locator, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const el = global.element(guessLocator(locator) || global.by.css(locator));
 
     return this.browser.wait(EC.elementToBeClickable(el), aSec * 1000)
       .catch(() => {
-        throw Error(`element (${locator}) still not enabled after ${aSec} sec`);
+        throw Error(`element (${(new Locator(locator))}) still not enabled after ${aSec} sec`);
       });
   }
 
@@ -1457,7 +1457,7 @@ class Protractor extends Helper {
    * {{> waitForValue }}
    */
   async waitForValue(field, value, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
 
     const valueToBeInElementValue = (loc) => {
       return async () => {
@@ -1490,7 +1490,7 @@ class Protractor extends Helper {
       }
     }
 
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     return this.browser.wait(() => this.browser.executeScript.call(this.browser, fn, ...args), aSec * 1000);
   }
 
@@ -1498,7 +1498,7 @@ class Protractor extends Helper {
    * {{> waitInUrl }}
    */
   async waitInUrl(urlPart, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const waitTimeout = aSec * 1000;
 
     return this.browser.wait(EC.urlContains(urlPart), waitTimeout)
@@ -1516,7 +1516,7 @@ class Protractor extends Helper {
    * {{> waitUrlEquals }}
    */
   async waitUrlEquals(urlPart, sec = null) {
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     const waitTimeout = aSec * 1000;
     const baseUrl = this.options.url;
     if (urlPart.indexOf('http') < 0) {
@@ -1542,7 +1542,7 @@ class Protractor extends Helper {
       context = this.context;
     }
     const el = global.element(guessLocator(context) || global.by.css(context));
-    const aSec = sec || this.options.waitForTimeout;
+    const aSec = sec || this.options.waitForTimeoutInSeconds;
     return this.browser.wait(EC.textToBePresentInElement(el, text), aSec * 1000);
   }
 
@@ -1583,7 +1583,7 @@ class Protractor extends Helper {
     if (locator) {
       const res = await this._locate(locator, true);
       if (!res || res.length === 0) {
-        return truth(`elements of ${locator}`, 'to be seen').assert(false);
+        return truth(`elements of ${(new Locator(locator))}`, 'to be seen').assert(false);
       }
       const elem = res[0];
       const location = await elem.getLocation();

package/lib/helper/Puppeteer.js

@@ -696,7 +696,7 @@ class Puppeteer extends Helper {
    */
   async moveCursorTo(locator, offsetX = 0, offsetY = 0) {
     const els = await this._locate(locator);
-    assertElementExists(els);
+    assertElementExists(els, locator);
 
     // Use manual mouse.move instead of .hover() so the offset can be added to the coordinates
     const { x, y } = await getClickablePoint(els[0]);
@@ -1336,7 +1336,7 @@ class Puppeteer extends Helper {
       throw new Error(`File at ${file} can not be found on local system`);
     }
     const els = await findFields.call(this, locator);
-    assertElementExists(els, 'Field');
+    assertElementExists(els, locator, 'Field');
     await els[0].uploadFile(file);
     return this._waitForAction();
   }
@@ -1491,7 +1491,7 @@ class Puppeteer extends Helper {
    */
   async seeNumberOfElements(locator, num) {
     const elements = await this._locate(locator);
-    return equals(`expected number of elements (${locator}) is ${num}, but found ${elements.length}`).assert(elements.length, num);
+    return equals(`expected number of elements (${(new Locator(locator))}) is ${num}, but found ${elements.length}`).assert(elements.length, num);
   }
 
   /**
@@ -1501,7 +1501,7 @@ class Puppeteer extends Helper {
    */
   async seeNumberOfVisibleElements(locator, num) {
     const res = await this.grabNumberOfVisibleElements(locator);
-    return equals(`expected number of visible elements (${locator}) is ${num}, but found ${res}`).assert(res, num);
+    return equals(`expected number of visible elements (${(new Locator(locator))}) is ${num}, but found ${res}`).assert(res, num);
   }
 
   /**
@@ -1725,7 +1725,7 @@ class Puppeteer extends Helper {
       }
       return true;
     });
-    return equals(`all elements (${locator}) to have CSS property ${JSON.stringify(cssProperties)}`).assert(chunked.length, elemAmount);
+    return equals(`all elements (${(new Locator(locator))}) to have CSS property ${JSON.stringify(cssProperties)}`).assert(chunked.length, elemAmount);
   }
 
   /**
@@ -1756,7 +1756,7 @@ class Puppeteer extends Helper {
       }
       return true;
     });
-    return equals(`all elements (${locator}) to have attributes ${JSON.stringify(attributes)}`).assert(chunked.length, elemAmount);
+    return equals(`all elements (${(new Locator(locator))}) to have attributes ${JSON.stringify(attributes)}`).assert(chunked.length, elemAmount);
   }
 
   /**
@@ -1819,7 +1819,7 @@ class Puppeteer extends Helper {
     assertElementExists(res, locator);
     if (res.length > 1) this.debug(`[Elements] Using first element out of ${res.length}`);
     const elem = res[0];
-    this.debug(`Screenshot of ${locator} element has been saved to ${outputFile}`);
+    this.debug(`Screenshot of ${(new Locator(locator))} element has been saved to ${outputFile}`);
     return elem.screenshot({ path: outputFile, type: 'png' });
   }