release 3.7.5

[kobenguyent]

3.7.5

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

✨ Features

• feat: Add configurable sensitive data masking with custom patterns (feat: Add configurable sensitive data masking with custom patterns #5109)

Backward Compatible Boolean Configuration

// codecept.conf.js
exports.config = {
  maskSensitiveData: true, // Uses built-in patterns for common sensitive data
  // ... other config
}

Advanced Custom Patterns Configuration

// codecept.conf.js
exports.config = {
  maskSensitiveData: {
    enabled: true,
    patterns: [
      {
        name: 'Email',
        regex: /(\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b)/gi,
        mask: '[MASKED_EMAIL]'
      },
      {
        name: 'Credit Card',
        regex: /\b(?:\d{4}[- ]?){3}\d{4}\b/g,
        mask: '[MASKED_CARD]'
      },
      {
        name: 'Phone Number',
        regex: /(\+?1[-.\s]?)?\(?([0-9]{3})\)?[-.\s]?([0-9]{3})[-.\s]?([0-9]{4})/g,
        mask: '[MASKED_PHONE]'
      }
    ]
  },
  // ... other config
}

## Example Output

With the above configuration, sensitive data is automatically masked:

**Before:**

Given I have user email "[email protected]"
And I have credit card "4111 1111 1111 1111"
And I have phone number "+1-555-123-4567"


**After:**

Given I have user email "[MASKED_EMAIL]"
And I have credit card "[MASKED_CARD]"
And I have phone number "[MASKED_PHONE]"

• feat(playwright): Add Custom Strategy Locators support (Add Custom Strategy Locators support to Playwright helper #5090)

exports.config = {
  helpers: {
    Playwright: {
      url: 'http://localhost',
      browser: 'chromium',
      customLocatorStrategies: {
        byRole: (selector, root) => {
          return root.querySelector(`[role="${selector}"]`);
        },
        byTestId: (selector, root) => {
          return root.querySelector(`[data-testid="${selector}"]`);
        },
        byDataQa: (selector, root) => {
          const elements = root.querySelectorAll(`[data-qa="${selector}"]`);
          return Array.from(elements); // Return array for multiple elements
        }
      }
    }
  }
}

And used in tests with the same syntax as other locator types:

I.click({byRole: 'button'});           // Find by role attribute
I.see('Welcome', {byTestId: 'title'}); // Find by data-testid
I.fillField({byDataQa: 'email'}, '[email protected]');

• feat(reporter): Enable HTML reporter by default in new projects (Enable HTML reporter by default in new CodeceptJS projects with comprehensive system information #5105)

plugins: {
  htmlReporter: {
    enabled: true
  }
}

• feat(cli): make test file hyperlink clickable (feat(cli): make test file path hyperlink #5078) - by @kobenguyent
  

• feat: Introduce CodeceptJS WebElement Class to mirror helpers’ element instance (Introduce CodeceptJS WebElement Class to mirror chosen helpers' element instance #5091)

Unified API Methods

• Element Properties: getText(), getAttribute(), getProperty(), getInnerHTML(), getValue()
• Element State: isVisible(), isEnabled(), exists(), getBoundingBox()
• Element Interactions: click(), type()
• Child Element Search: $() and $$() methods for finding sub-elements
• Native Access: getNativeElement() and getHelper() for advanced operations

Updated Helper Methods

• grabWebElement() and grabWebElements() now return WebElement instances instead of native elements
• Added missing grabWebElement() method to WebDriver and Puppeteer helpers
• Maintains backward compatibility through getNativeElement() method

// Works consistently across all helpers
const element = await I.grabWebElement('#button');
const text = await element.getText();
const childElements = await element.$$('.child');
await element.click();

// Element searching within elements
const form = await I.grabWebElement('#contact-form');
const nameInput = await form.$('#name');
await nameInput.type('John Doe');

• feat: support feature.only like Scenario.only ([WIP] [FR] - Support feature.only like Scenario.only #5087)
  Example:

  Feature.only('Checkout Flow', () => {
    Scenario('complete order', ({ I }) => {
      // test steps here
    });
  });

---

🐛 Bug Fixes

• fix(utils): resolve command injection vulnerability in emptyFolder (fix(utils): resolve command injection vulnerability in emptyFolder (3.x) #5190) - by @mhassan1
• bugfix: prevent WebDriver error without Bidi protocol (bugfix: prevent this error when running WebDriver without Bidi protocol: 'Error: Failed to execute WebDriver Bidi command "sessionSubscribe"' #5095) - by @ngraf
• fix(playwright): relaunch browser correctly with restart: 'session' in run-workers --by pool (fix(playwright): relaunch browser correctly with restart: 'session' in run-workers --by pool #5118) - by @Samuel-StO
• fix: JSONResponse helper to preserve original onResponse behavior (Fix: JSONResponse helper to preserve original onResponse behavior (Fixes #5042) #5106) - by @myprivaterepo
• fix: use platformName for mobile click detection (Android touchClick bug) (fix: use platformName for mobile click detection instead of isW3C (Android touchClick bug) #5107) - by @mirao
• fix: Properly stop network traffic recording (Bugfix: Properly stop network traffic recording  #5127) - by @Samuel-StO
• fix: mocha retries losing CodeceptJS-specific properties (Fix mocha retries losing CodeceptJS-specific properties (opts, tags, meta, etc.) #5099)
• fix: missing codeceptjs/effects types (fix: missing module 'codeceptjs/effects' #5094) - by @kobenguyent
• fix: tryTo steps appearing in test failure traces (Fix tryTo steps appearing in test failure traces #5088)
• fix: JUnit XML test case name inconsistency with retries (Fix JUnit XML test case name inconsistency when using scenario retries #5082)
• fix: waitForText timeout regression in Playwright helper (Fix waitForText timeout regression in Playwright helper #5093)
• fix(Playwright): I.waitForText() caused unexpected delay ([WIP] Playwright: I.waitForText() causes unexpected delay equal to waitForTimeout value at the end of test suite #5077)
• fix: I.seeResponseContainsJson not working ([WIP] 3.7.3 I.seeResponseContainsJson not working #5081)

[thomashohn]

@kobenguyent Looks good to me - this one looks weird "test file hyperlink clickable" and won't work