| description | Reference documentation for actions that apply as part for Currents Actions Engine |
|---|
The following actions are supported by the Currents Actions Engine.
Actions that run in the client immediately before test execution.
| Action | Description | Min Version |
|---|---|---|
| skip | Do not run the test at all, same as test.skip(). | v1.9.0 |
{% hint style="info" %} Pre-Test Actions are applied using a Custom Fixture that runs the Currents Actions Engine before each of your tests. {% endhint %}
Actions that run in the client after test execution, but before reporting the results to Currents.
| Action | Description | Min Version |
|---|---|---|
| quarantine | Run the test, but ignore the failures; the results will be sent over to Currents, test status will be skipped. | v1.9.0 |
| add tag | Add tags to the test result. Only affects the current test execution attempt. | v1.15.0 |
{% hint style="info" %} Post-Test Actions can end up evaluated in two places: as a Custom Fixture that runs after each of your tests, and as a Custom Reporter that catches scenarios where the fixture wasn't run, such as errors or timeouts in test teardown. {% endhint %}
Errors that occur in Playwright's beforeAll hook are not supported even if the corresponding test has the skip or quarantine action, resulting in tests still being reported as failed. Actions fixture runs after the beforeAll hook, and is skipped by Playwright if the hook fails. We are looking at solutions to resolve this in a future release.
Errors that occur in other Custom Fixtures may prevent the action from being applied if the failure happens before the Currents Action fixture is loaded. To ensure the action is applied in such cases, the Currents fixture should be loaded before other fixtures. See #combine-currents-fixtures-with-existing-custom-fixtures
The behaviour of #post-test-actions can differ slightly depending on whether the failure was in the test body, or in a fixture/hook.
- quarantined in the per-test fixture → can mark attempt as skipped early, avoiding retries
- failures in after hooks/teardown → may only be quarantined at reporter stage, so retries may already be in progress
- The quarantine option will run the test, but it will be counted only if the result is a pass.
- The skip option does not count toward the test quota.