3.0.1

Here's a quick update to our very sizable release 3.0.0, as we’re getting back on track to a biweekly schedule. Plenty of good stuff in the works, but for now, enjoy the following changes.

🚀 What’s new?

Version 3.0.0 came with lots of improvements in terms of legibility and stability as we continue to improve our codebase. We’ve also introduced a whole new spec: footer.spec! In this version:

• magentoAdmin.page has been split to better adhere to the ‘separation of concerns’ principle, as well as improve legibility.
• We’ve snuck in some code for an upcoming release: the APIClient utility! Like we said, we’re always working on improving the stability of our testing suite, and improved speed from utilizing an API over repeating the same steps should massively improve the suite as a whole. We’re not quite ready to switch over just yet, but eager users can check it out!

As mentioned, most of the biggest changes come from the recent release 3.0.0, so we encourage you to check out the release notes for that version, along with the changelog for more details.

Happy testing! 🎭🧪

3.0.0

What's Changed

• Fix typo so command can be copied and pasted. by @Vinai in #172
• Update CHANGELOG.md by @shayfaber in #174
• Added footer tests for subscribing to the newsletter and currency switcher, added a notification uility by @LS-Myron in #175
• Update to make sure tests run successfully by @shayfaber in #176
• Update README.md and changed translate-json.js to a class file by @LS-Myron in #178
• Update install.js to a class file by @LS-Myron in #179
• Fixed issues in install.js by @LS-Myron in #180
• Fixed github workflow by @shayfaber in #181
• Fixed typos by @shayfaber in #182
• Update magentoAdmin.spec by @shayfaber in #183
• Update mainmenu-, account.spec and product.page by @shayfaber in #184
• Update code by @shayfaber in #185
• Update magentoAdmin.page for coupon code test by @shayfaber in #186
• Fixed magentoAdmin.page configuration by @shayfaber in #187

New Contributors

• @Vinai made their first contribution in #172

Full Changelog: 2.2.0...3.0.0

2.2.0

Added

• Added a console.log utility tool to prevent having to use ‘console.log’.

Changed

• Rewritten setup.spec.ts for better legibility. Setup will also now check if elements are present and active (e.g. coupon codes), and no longer writes to .env.
• Improved the capability of the magewire loading utility to better handle various states of the magewire loading element
• Improved using @ tags for example @utils, @poms and more for ease of customization and maintainability.
• Updated README to reflect new updates.

Removed

• Removed setup toggles to avoid the use of .only() as this can easily lead to mistakes. Use ‘grep’ instead.

Fixed

• Fixed various ‘false negatives’ where tests would fail due to poor hydration methods. Among these is the country selection and the state selection field, which changes based on the selected country.
• Fixed ‘race condition’ in the change_quantity_in_cart test which sometimes caused the quantity to not be properly updated.
• Minor fixes for ‘multimatch’ selector errors

2.1.0-alpha

Added

• Added and configured path aliases in tsconfig.json and Playwright setup to support unified imports from both tests and base-tests directories.
• Introduced centralized index files for configuration and utilities to enable simplified imports.

Changed

• Improved TypeScript path alias usage across the project for cleaner and more maintainable imports.
• Replaced relative path traversals with specific path aliases (@utils, @poms, @config) to enhance developer experience and reduce errors.
• Updated all affected files to conform with the new import structure.
• Enhanced override mechanisms for better modularity and clarity in the codebase.
• Updated setup.spec to ensure compatibility and structure.

Fixed

• Resolved compatibility issues with IDE tooling and runtime environments to prevent import-related problems.

Impact

• Cleaner import statements throughout the codebase.
• Improved code maintainability and easier onboarding for new developers.
• Reduced likelihood of import path errors during development and CI runs.

2.0.1-alpha

Release notes

All notable changes to this project in this release will be documented in this file. See changelog.md for a full overview of all changes per release. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.1-alpha] - 2025-07-02

Fixes

• Fixed error in the order of install script in package.json which meant that the setup of .env didn't work.
• Fixed trailing comma that can cause unnecessary issues in certain linters.

2.0.0-alpha

Release notes

All notable changes to this project in this release will be documented in this file. See changelog.md for a full overview of all changes per release. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.0.0-alpha] - 2025-07-02

The initial NPM Package release!

Due to a difference in releases between the GitHub version and the npm package, we've now marked both as version 2.0.0-alpha to signify their merger and to avoid confusion in the future.

Added

• Build scripts to help set up the testing suite through the npm package!
• Configuration helper files that make customization easier by automatically picking the correct import of JSON files.
• Custom files in 'tests' folder will now automatically be used if corresponding spec file is also placed in test folder.
• Notification Validator: A utility for validating Magento frontend messages during testing (e.g. "Add to Cart" success message).
• Environment Variable Utility: Centralized handling of environment variables for consistent configuration across test environments.
• Magewire Utility: Helper functions to interact with Magewire components in tests.
• New tests:
  • search.spec.ts
  • product.spec.ts
  • orderhistory.spec.ts
  • healthcheck.spec.ts
  • compare.spec.ts
  • category.spec.ts

Changed

• The elgentos testing suite is now a npm package for maintainability: link to testing suite npm package.
• Removed test toggles to avoid issues where the suite would fail without giving a helpful message.
• Added 'smoke' tags to healthcheck tests to better adhere to industry standards.
• 'Fixtures' folder is now 'poms'.
• Split the magento admin page files and frontend page files in the renamed 'poms' folder.
• .env attributes renamed, and defaults will be suggested during installation.
• Divided the steps in setup.spec.ts to make them easier to read.
• Moved and renamed config files
• Readme files

Fixes

• Various fixes for stability, better adherence to the DRY-principle and separation of concerns.

1.0.0-alpha

Changelog

All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.0-alpha] - 2025-01-29

The initial Alpha Release!

Added

• Setup script to make it easier for users to prepare Magento 2 admin section.
• Test cases for key features such as creating an account, ordering a product, adding a coupon code, and more.
• Element identifiers, input values, and outcome markers added in JSON files to make customization easier.
• Example GitHub Actions workflow to show how easily our tool can be integrated into the CI/CD pipeline.