Testing – astrojs-wp-integration

Testing

This package uses integration-first testing against a real local WordPress instance.

Actions overview How action factories map auth and error handling in integration tests.

Auth bridge JWT bridge behavior and action auth wiring covered by integration tests.

Caching How route caching, cache hints, and invalidation actions are exercised end to end.

Post actions Examples of action behavior validated through Astro RPC endpoints.

Test Projects

• integration: Loader runtime, action RPC, auth bridge, meta, ACF, ability coverage, and route-caching coverage through the shared Astro fixture.
• static-build: Real astro build validation for static loader content collections.

The shared Astro fixture in tests/fixtures/astro-site/ includes both:

• src/content.config.ts for build-time collections used by static loader coverage.
• src/live.config.ts for runtime collections used by getLiveCollection() and getLiveEntry() SSR coverage.

Local Workflow

Start local WordPress first:

npm run wp:start
npm run wp:status

wp-env is configured with automatic port selection. If 8888 is unavailable, run npm run wp:status to see the active local WordPress URL and ports.

Run tests:

npm run test:integration
npm run test:build
# or run both projects
npm test

Stop or reset local WordPress:

npm run wp:stop
npm run wp:clean

Auth Bridge Coverage

Auth bridge behavior is covered by the integration project against wp-env.

• Action integration tests call real /_actions/* endpoints from the shared fixture in tests/fixtures/astro-site/.
• tests/setup/global-setup.ts provisions auth fixtures (application password, JWT, cookie+nonce) before integration suites run.
• Live loader runtime tests call real Astro pages in the same fixture to verify defineLiveCollection() wiring, schema validation, and SSR rendering for posts, pages, categories, and CPT content.
• Route-caching tests build the same fixture with @astrojs/node, start the standalone server entry, and verify cache hints plus the packaged invalidation actions end to end.