codeceptjs - npm Package Versions

3.5.11

❤️ Thanks all to those who contributed to make this release! ❤️

🛩️ Features

• feat: other locators from playwright (#4090) - by @KobeNguyenT
  • CodeceptJS - Playwright now supports other locators like
    • React (https://playwright.dev/docs/other-locators#react-locator),
    • Vue (https://playwright.dev/docs/other-locators#vue-locator)

🐛 Bug Fixes

• fix: step object is broken when step arg is a function (#4092) - by @KobeNguyenT
• fix: step object is broken when step arg contains joi object (#4084) - by @KobeNguyenT
• fix(expect helper): custom error message as optional param (#4082) - by @KobeNguyenT
• fix(puppeteer): hide deprecation info (#4075) - by @KobeNguyenT
• fix: seeattributesonelements throws error when attribute doesn't exist (#4073) - by @KobeNguyenT
• fix: typo in agrs (#4077) - by @KobeNguyenT
• fix: retryFailedStep is disabled for non tryTo steps (#4069) - by @KobeNguyenT
• fix(typings): scrollintoview complains scrollintoviewoptions (#4067) - by @KobeNguyenT

📖 Documentation

• fix(docs): some doc blocks are broken (#4076) - by @KobeNguyenT
• fix(docs): expect docs (#4058) - by @KobeNguyenT

3.5.10

❤️ Thanks all to those who contributed to make this release! ❤️

🛩️ Features

• feat: expose WebElement (#4043) - by @KobeNguyenT

Now we expose the WebElements that are returned by the WebHelper and you could make the subsequence actions on them.

// Playwright helper would return the Locator

I.amOnPage('/form/focus_blur_elements');
const webElements = await I.grabWebElements('#button');
webElements[0].click();

• feat(playwright): support HAR replaying (#3990) - by @KobeNguyenT

Replaying from HAR

 // Replay API requests from HAR.
 // Either use a matching response from the HAR,
 // or abort the request if nothing matches.
   I.replayFromHar('./output/har/something.har', { url: "*/**/api/v1/fruits" });
   I.amOnPage('https://demo.playwright.dev/api-mocking');
   I.see('CodeceptJS');
[Parameters]
harFilePath [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) Path to recorded HAR file
opts [object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)? [Options for replaying from HAR](https://playwright.dev/docs/api/class-page#page-route-from-har)

• feat(playwright): support HAR recording (#3986) - by @KobeNguyenT

A HAR file is an HTTP Archive file that contains a record of all the network requests that are made when a page is loaded. 
It contains information about the request and response headers, cookies, content, timings, and more. 
You can use HAR files to mock network requests in your tests. HAR will be saved to output/har. 
More info could be found here https://playwright.dev/docs/api/class-browser#browser-new-context-option-record-har.

...
recordHar: {
    mode: 'minimal', // possible values: 'minimal'|'full'.
    content: 'embed' // possible values:  "omit"|"embed"|"attach".
}
...

• improvement(playwright): support partial string for option (#4016) - by @KobeNguyenT

await I.amOnPage('/form/select');
await I.selectOption('Select your age', '21-');

🐛 Bug Fixes

• fix(playwright): proceedSee could not find the element (#4006) - by @hatufacci
• fix(appium): remove the vendor prefix of 'bstack:options' (#4053) - by @mojtabaalavi
• fix(workers): event improvements (#3953) - by @KobeNguyenT

Emit the new event: event.workers.result.

CodeceptJS also exposes the env var `process.env.RUNS_WITH_WORKERS` when running tests with run-workers command so that you could handle the events better in your plugins/helpers.

const { event } = require('codeceptjs');

module.exports = function() {
    // this event would trigger the  `_publishResultsToTestrail` when running `run-workers` command
  event.dispatcher.on(event.workers.result, async () => {
    await _publishResultsToTestrail();
  });
  
  // this event would not trigger the  `_publishResultsToTestrail` multiple times when running `run-workers` command
  event.dispatcher.on(event.all.result, async () => {
      // when running `run` command, this env var is undefined
    if (!process.env.RUNS_WITH_WORKERS) await _publishResultsToTestrail();
  });
}

• fix: ai html updates (#3962) - by @DavertMik

replaced minify library with a modern and more secure fork. Fixes html-minifier@4.0.0 Regular Expression Denial of Service vulnerability #3829
AI class is implemented as singleton
refactored heal.js plugin to work on edge cases
add configuration params on number of fixes performed by ay heal
improved recorder class to add more verbose log
improved recorder class to ignore some of errors

• fix(appium): closeApp supports both Android/iOS (#4046) - by @KobeNguyenT
• fix: some security vulnerability of some packages (#4045) - by @KobeNguyenT
• fix: seeAttributesOnElements check condition (#4029) - by @KobeNguyenT
• fix: waitForText locator issue (#4039) - by @KobeNguyenT

Fixed this error:

locator.isVisible: Unexpected token "s" while parsing selector ":has-text('Were you able to resolve the resident's issue?') >> nth=0"
      at Playwright.waitForText (node_modules\codeceptjs\lib\helper\Playwright.js:2584:79)

• fix: move to sha256 (#4038) - by @KobeNguyenT
• fix: respect retries from retryfailedstep plugin in helpers (#4028) - by @KobeNguyenT

Currently inside the _before() of helpers for example Playwright, the retries is set there, however, when retryFailedStep plugin is enabled, the retries of recorder is still using the value from _before() not the value from retryFailedStep plugin.

Fix:

- introduce the process.env.FAILED_STEP_RETIRES which could be access everywhere as the helper won't know anything about the plugin.
- set default retries of Playwright to 3 to be on the same page with Puppeteer.

• fix: examples in test title (#4030) - by @KobeNguyenT

When test title doesn't have the data in examples:

Feature: Faker examples

  Scenario Outline: Below are the users
    Examples:
      | user   | role |
      | John  | admin |
      | Tim   | client  |

Faker examples --
    [1]  Starting recording promises
    Timeouts: 
  Below are the users {"user":"John","role":"admin"}
  ✔ OK in 4ms

  Below are the users {"user":"Tim","role":"client"}
  ✔ OK in 1ms

When test title includes the data in examples:


Feature: Faker examples

  Scenario Outline: Below are the users - <user> - <role>
    Examples:
      | user   | role |
      | John  | admin |
      | Tim   | client  |


Faker examples --
    [1]  Starting recording promises
    Timeouts: 
  Below are the users - John - admin 
  ✔ OK in 4ms

  Below are the users - Tim - client 
  ✔ OK in 1ms

• fix: disable retryFailedStep when using with tryTo (#4022) - by @KobeNguyenT
• fix: locator builder returns error when class name contains hyphen (#4024) - by @KobeNguyenT
• fix: seeCssPropertiesOnElements failed when font-weight is a number (#4026) - by @KobeNguyenT
• fix(appium): missing await on some steps of runOnIOS and runOnAndroid (#4018) - by @KobeNguyenT
• fix(cli): no error of failed tests when using retry with scenario only (#4020) - by @KobeNguyenT
• fix: set getPageTimeout to 30s (#4031) - by @KobeNguyenT
• fix(appium): expose switchToContext (#4015) - by @KobeNguyenT
• fix: promise issue (#4013) - by @KobeNguyenT
• fix: seeCssPropertiesOnElements issue with improper condition (#4057) - by @KobeNguyenT

📖 Documentation

• docs: Update clearCookie documentation for Playwright helper (#4005) - by @Hellosager
• docs: improve the example code for autoLogin (#4019) - by @KobeNguyenT