# Error codes: `@ultimat3/testing` Part of [Error codes](Error-Codes): every code `@ultimat3/testing` registers. `x errors explain --json` prints the same row. | Code | Means | Typical cause | Fix | |---|---|---|---| | `X_CASSETTE_MISSING` | a cassette replayed with no recording on disk | cassette() ran in replay mode and /__cassettes__/.json does not exist: the test was never recorded, or the file was renamed | `ULTIMATE_CASSETTE=record bun test ` — with cassette(import.meta.dir, , { record: { hosts: [] } }) | | `X_CASSETTE_RECORD_REFUSED` | a cassette recording was refused | ULTIMATE_CASSETTE=record ran under CI, or the run requested a host outside record.hosts | `cassette(import.meta.dir, , { record: { hosts: [] } })` — add the host, and record locally with CI unset | | `X_CASSETTE_SECRET` | a cassette about to be written holds a secret value | the value of a redacted env key or a declared secret appears in the bytes about to be written (raw, percent-encoded, base64 or base64url); nothing was written | `cassette(import.meta.dir, , { redact: (text) => text.replaceAll(, '[redacted]') })` — then re-record | | `X_CASSETTE_UNUSED` | a cassette entry was never replayed | the code under test no longer makes a request the cassette recorded, so the recording describes a run that does not happen | `ULTIMATE_CASSETTE=record bun test ` — re-record — or delete the entries meta.unused names from the cassette file | | `X_DRILL_FAILED` | a fault drill property did not hold | x drill played a fault against the app and a framework contract the drill states (a coded answer, a bounded request, readiness, recovery, a terminal job, a drained role) was not met; the property and its evidence are printed | `x drill --json` — read the failed property and its evidence, then explain the code that evidence names: x errors explain | | `X_DRILL_SERVICE_MISSING` | a fault drill needs a service that is not there | x drill needs a real Postgres for every drill, and a real Redis or NATS for the drill that faults it: the TEST_* URL is unset, or the app declares no redis cache tier or nats transport to fault | `docker compose -f docker/docker-compose.test.yml up -d --wait` — then: set -a; . docker/test-services.env; set +a | | `X_DRILL_TEARDOWN_FAILED` | a fault drill could not drop its scratch database | x drill could not drop its scratch database: a logical replication slot on it stayed active after its holder was terminated, or the server refused the drop; the database is left on the server | `psql -h -p -U -d postgres -c "select pg_terminate_backend(active_pid) from pg_replication_slots where database = ''" -c 'select pg_sleep(1)' -c 'DROP DATABASE IF EXISTS WITH (FORCE)'` — the error's own fix carries the server and the database | | `X_E2E_A11Y_VIOLATION` | a page fails the accessibility audit | a page in this test has a control, image or heading with no accessible name, no title or lang, or focus inside aria-hidden; the cause lists each element | `name it (visible text, aria-label,