--- read_when: - Tests uitvoeren of repareren summary: Tests lokaal uitvoeren (vitest) en wanneer je de modi voor forceren/dekking gebruikt title: Tests x-i18n: generated_at: "2026-07-12T09:25:20Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 63806ea72da1579f4aa0b92c14a6d2d3e67990d6c10cb6d9b1b2bb4a63c8e140 source_path: reference/test.md workflow: 16 --- - Volledige testkit (suites, live, Docker): [Testen](/nl/help/testing) - Validatie van updates en Plugin-pakketten: [Updates en Plugins testen](/nl/help/testing-updates-plugins) ## Standaardinstelling voor agents Agentsessies voeren tests en rekenintensieve validatie op afstand uit via Crabbox. Voor vertrouwde code van beheerders wordt standaard Blacksmith Testbox gebruikt. De geconfigureerde Testbox-workflow laadt inloggegevens, dus niet-vertrouwde code van bijdragers of forks moet in plaats daarvan CI voor forks zonder geheimen of een opgeschoonde directe AWS Crabbox gebruiken. Wanneer voor een vertrouwde codetaak waarschijnlijk tests of zwaar bewijsmateriaal nodig zijn, warm dan onmiddellijk vooraf op in een opdrachtensessie op de achtergrond, werk door terwijl deze wordt voorbereid, gebruik de geretourneerde `tbx_...`-id opnieuw, synchroniseer bij elke uitvoering de huidige checkout en stop deze vóór de overdracht: ```bash node scripts/crabbox-wrapper.mjs warmup --provider blacksmith-testbox --keep --timing-json ``` Na het eerste geslaagde hergebruik registreert de wrapper de basis-, afhankelijkheids- en Testbox-workflowvingerafdruk van de lease onder `.crabbox/testbox-leases/`. Bij uitsluitend broncodewijzigingen blijft de voorverwarmde box hergebruikt worden. Een gewijzigde samenvoegbasis, lockfile, pakketbeheerinvoer, wrapper of Testbox-workflow leidt tot een veilige weigering en vereist een nieuwe lease. Bij elke uitvoering wordt de huidige checkout nog steeds gesynchroniseerd. `OPENCLAW_TESTBOX_ALLOW_STALE=1` is uitsluitend bedoeld voor doelbewuste diagnostiek, niet als bewijs voor een release. De onderstaande lokale testopdrachten zijn bedoeld voor menselijke workflows of voor een expliciete terugvaloptie voor agents waarom de gebruiker heeft gevraagd. Onbeschikbaarheid van de externe provider moet worden gemeld; dit geeft geen toestemming om stilzwijgend een brede lokale controle uit te voeren. Warm voor niet-vertrouwde code vooraf op met `--provider aws`. Elke uitvoering moet `CRABBOX_ENV_ALLOW=CI` instellen, `--provider aws --no-hydrate` doorgeven en een nieuwe tijdelijke externe `HOME` gebruiken voordat afhankelijkheden worden geïnstalleerd of tests worden uitgevoerd. Gebruik een nieuw voorverwarmde lease die uitsluitend voor die niet-vertrouwde bron bestemd is; hergebruik nooit een vertrouwde of eerder met inloggegevens geladen lease. Start een geïnstalleerd, vertrouwd Crabbox- binair bestand vanuit een schone, vertrouwde `main`-checkout en haal alleen de externe PR op met `--fresh-pr`; voer de wrapper of configuratie van de niet-vertrouwde checkout nooit lokaal uit. Maak `CRABBOX_AWS_INSTANCE_PROFILE` leeg en weiger veilig tenzij de bepaalde waarde van `aws.instanceProfile` leeg is. Gebruik vóór elke installatie/test vertrouwde hulpmiddelen met absolute paden om een IMDSv2-token te vereisen, aan te tonen dat het eindpunt voor IAM-inloggegevens 404 retourneert en te verifiëren dat de externe uitvoer van `git rev-parse HEAD` gelijk is aan de volledige beoordeelde SHA van de PR-head. Koppel de lease aan die SHA en stop/warm opnieuw op wanneer de head wijzigt. Upload het vertrouwde `scripts/crabbox-untrusted-bootstrap.sh` vanuit een schone `main` naast `--fresh-pr`; dit installeert vastgezette versies van Node/pnpm, verifieert de SHA en de vastgezette pakketbeheerversie, isoleert `HOME`, installeert afhankelijkheden en voert vervolgens de gevraagde test uit. Als de broker niet kan aantonen dat er geen rol is of als er geen externe PR bestaat, gebruik dan CI voor forks zonder geheimen. Gebruik geen `hydrate-github`, `--no-sync` of een Testbox-workflow waarin inloggegevens zijn geladen. Maak alle `CRABBOX_TAILSCALE*`-overschrijvingen leeg, dwing `--network public --tailscale=false` af, wis exit-node-/LAN-vlaggen en vereis dat `crabbox inspect` openbare netwerktoegang zonder Tailscale-status meldt voordat een script wordt geüpload. ## Gebruikelijke lokale volgorde 1. `pnpm test:changed` voor Vitest-bewijs binnen het gewijzigde bereik. 2. `pnpm test ` voor één bestand, map of expliciet doel. 3. `pnpm test` alleen wanneer u bewust de volledige lokale Vitest-suite nodig hebt. In een Codex-worktree of gekoppelde/sparse checkout vermijden agents directe lokale uitvoering van `pnpm test*` / `pnpm check*` / `pnpm crabbox:run`: - Expliciet door de gebruiker gevraagde lokale terugvaloptie voor een klein bestand: `node scripts/run-vitest.mjs `. - Gewijzigde controles of breed bewijs: `node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox ... -- env OPENCLAW_CHECK_CHANGED_REMOTE_CHILD=1 OPENCLAW_CHANGED_LANES_RAW_SYNC=1 corepack pnpm check:changed`, zodat pnpm binnen Testbox wordt uitgevoerd. - De uiteindelijke `exitCode` en timing-JSON van de wrapper vormen het opdrachtresultaat. Een gedelegeerde Blacksmith GitHub Actions-uitvoering kan na een geslaagde SSH-opdracht `cancelled` tonen, omdat de Testbox van buiten de keepalive-actie wordt gestopt; controleer de wrappersamenvatting en opdrachtuitvoer voordat u dit als een fout beschouwt. - `OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree `: houdt de serialisatie van zware controles binnen de huidige worktree in plaats van de gemeenschappelijke Git-map voor opdrachten zoals `pnpm check:changed` en gerichte `pnpm test ...`. Gebruik dit alleen op lokale hosts met hoge capaciteit wanneer u bewust onafhankelijke controles over gekoppelde worktrees uitvoert. ## Kernopdrachten Uitvoeringen van de testwrapper eindigen met een korte samenvatting `[test] passed|failed|skipped ... in ...`; de eigen duurregel van Vitest blijft de detailinformatie per shard. | Opdracht | Functie | | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `pnpm test` | Expliciete bestands-/mapdoelen worden via gerichte Vitest-lanes geleid. Uitvoeringen zonder doel vormen bewijs voor de volledige suite: vaste shardgroepen worden uitgebreid naar leaf-configuraties voor lokale parallelle uitvoering, waarbij de verwachte shardverdeling vóór de start wordt weergegeven. De extensiegroep wordt altijd uitgebreid naar shardconfiguraties per extensie in plaats van één gigantisch root-projectproces. | | `pnpm test:changed` | Goedkope, slimme uitvoering van gewijzigde tests: nauwkeurige doelen uit directe testbewerkingen, aangrenzende `*.test.ts`-bestanden, expliciete brontoewijzingen en de lokale importgrafiek. Brede wijzigingen in configuratie/pakketten worden overgeslagen tenzij ze aan specifieke tests kunnen worden gekoppeld. | | `OPENCLAW_TEST_CHANGED_BROAD=1 pnpm test:changed` | Expliciete brede uitvoering van gewijzigde tests; gebruik dit wanneer een wijziging aan een testharnas, configuratie of pakket moet terugvallen op het bredere gedrag van Vitest voor gewijzigde tests. | | `pnpm test:force` | Maakt de geconfigureerde OpenClaw Gateway-poort vrij (standaard `18789`) en voert vervolgens de volledige suite uit met een geïsoleerde Gateway-poort, zodat servertests niet botsen met een actieve instantie. | | `pnpm test:coverage` | Genereert een informatief V8-dekkingsrapport voor de standaardunitlane (`vitest.unit.config.ts`); er worden geen dekkingsdrempels afgedwongen. | | `pnpm test:coverage:changed` | Alleen unitdekking voor bestanden die sinds `origin/main` zijn gewijzigd. | | `pnpm changed:lanes` | Toont de architectuurlanes die worden geactiveerd door het verschil met `origin/main`. | | `pnpm check:changed` | Delegeert buiten CI standaard naar Crabbox/Testbox en voert vervolgens binnen het externe child-proces de slimme controlepoort voor wijzigingen uit: opmaak plus typecontrole-, lint- en bewakingsopdrachten voor getroffen lanes. Voert Vitest niet uit; gebruik `pnpm test:changed` of `pnpm test ` als testbewijs. | ## Gedeelde teststatus en proceshelpers - `src/test-utils/openclaw-test-state.ts`: gebruik dit vanuit Vitest wanneer een test een geïsoleerde `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, configuratiefixture, werkruimte, agentmap of opslag voor authenticatieprofielen nodig heeft. - `pnpm test:env-mutations:report`: niet-blokkerend rapport van tests/harnassen die `HOME`, `OPENCLAW_STATE_DIR`, `OPENCLAW_CONFIG_PATH`, `OPENCLAW_WORKSPACE_DIR` of verwante omgevingssleutels rechtstreeks wijzigen. Gebruik dit om migratiekandidaten voor de gedeelde helper voor teststatus te vinden. - `test/helpers/openclaw-test-instance.ts`: E2E-tests op procesniveau die op één plek een actieve Gateway, CLI-omgeving, logregistratie en opschoning nodig hebben. - Docker-/Bash-E2E-lanes die `scripts/lib/docker-e2e-image.sh` inladen, kunnen `docker_e2e_test_state_shell_b64