Summary of Changes

Refactoring of the Cypress test for SEF to replace the dependency on the Joomla command line client tool with Cypress custom commands.

With the SefPlugin.cy.js Cypress test, the Joomla command line client tool was added to the Joomla System Tests for the first time. This is an additional complexity and dependency. Especially if the test environment is containerised and Cypress container has no PHP installed. And PHP version needs to be 8.1 and additional modules like php-simplexml are needed. And with the Docker access rights, configuration.php must be opened for writing (chmod 644). And then there is the locally running Cypress GUI to be configured...

Therefore switched from using the Joomla command line client tool to using the existing config_setParameter Cypress custom command. The original creator of 44253 could not know as it is not documented (will be solved with another PR #44660, together with the description for configuring the now required enable mod_rewrite and AllowOverride All).

Since sometimes the first SEF test failed when the entire Joomla System Tests was performed after refactoring, the following was implemented:

• The operations of the writeRelativeFile Cypress task are wrapped in a Promise to ensure that they are only resolved when everything is done
• The config_setParameter Cypress custom command to return a Cypress chainable
• Chaining has been used everywhere in SefPlugin.cy.js

The Cypress best practice of using beforeEach is used to ensure that the tests can be run independently (this is still needed for other places in the Joomla system tests - another PR).

As a small side effect the SEF test spec with 9 tests runs faster, e.g. 3 instead of 18 seconds before.

Testing Instructions

1. Tested with own target Joomla 5.2-dev three times the single test spec on:

• Intel macOS 15.2 using Apache/MariaDB
• Apple Silicon macOS 15.2 using Apache/MariaDB
• Windows 11 24H2 using Laragon/Apache/MySQL

npx cypress run --spec tests/System/integration/plugins/system/sef/SefPlugin.cy.js

And once the overall test suite:

npm run cypress:run

2. Tested with JBT in creating Joomla 5.2-dev instance with this PR:

scripts/create 52 joomla-cms-44656

Three times the single test spec on:

• Intel macOS 15.2
• Apple Silicon macOS 15.2
• Windows 11 24H2 WSL2 Ubuntu

scripts/test system plugins/system/sef/SefPlugin.cy.js

And once the overall test suite:

scripts/test system

Actual result BEFORE applying this Pull Request

Joomla System Tests require Joomla command line client

Expected result AFTER applying this Pull Request

Joomla System Tests doesn't require Joomla command line client

Link to documentations

Please select:

• Documentation link for docs.joomla.org:

• No documentation changes for docs.joomla.org needed

• Pull Request link for manual.joomla.org:

• No documentation changes for manual.joomla.org needed

• Related PR for adopting Joomla System Tests GitHub will follow