workers-integration-testing

Automate end-to-end Cloudflare Workers tests with real runtimes and bindings.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/jonmumm/skills --skill workers-integration-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workers-integration-testing
Source: https://github.com/jonmumm/skills/tree/main/workers-integration-testing
Command: npx skills add https://github.com/jonmumm/skills --skill workers-integration-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Cloudflare Workers require reliable end-to-end testing against the actual runtime to catch integration issues that unit tests miss, including binding configurations and HTTP behavior.

Core Features & Use Cases

  • Validate HTTP endpoints, middleware order, and response correctness by running tests against the real Workers runtime.
  • Verify interactions with bindings (D1, KV, R2, Durable Objects, Hyperdrive) and ensure data persists as expected.
  • Support testing workflows in nightshift, swarm, and ralph-tdd loops to maintain robust API services.

Quick Start

Install dependencies and run the integration test suite using pnpm test:integration with the provided vitest config.

Frequently Asked Questions about workers-integration-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run end-to-end integration tests for Cloudflare Workers with real bindings?

Run end-to-end integration tests for Cloudflare Workers by configuring vitest-pool-workers and cloudflare:test with a dedicated vitest.integration.config.mts, which seeds bindings and enables isolatedStorage to validate HTTP routes and data persistence.

Can I test D1, KV, R2, and Durable Object bindings in a Cloudflare Workers test suite?

Yes, you can test D1, KV, R2, Durable Object, and Hyperdrive binding interactions by running tests against the real Workers runtime to ensure data persists and catch production misconfigurations that unit tests miss.

What is the best way to validate HTTP routes and middleware chains in Cloudflare Workers?

The best way to validate HTTP routes and middleware chains is to automate end-to-end testing against the actual Workers runtime, checking response correctness and middleware order to catch integration issues early.

How do I set up Miniflare and Vitest for Cloudflare Workers integration testing?

Set up Vitest and Miniflare for Cloudflare Workers integration testing by installing vitest-pool-workers, configuring cloudflare:test, and creating a vitest.integration.config.mts file that seeds bindings and enables isolatedStorage.

Why do my Cloudflare Workers unit tests miss binding configuration and HTTP behavior errors?

Unit tests miss binding configuration and HTTP behavior errors because they do not run against the actual Cloudflare Workers runtime, whereas end-to-end integration tests validate real binding interactions and middleware chains to catch production misconfigurations.

Does end-to-end testing with Vitest support testing workflows in TDD loops and nightshift environments?

Yes, end-to-end testing with Vitest supports testing workflows in nightshift, swarm, and ralph-tdd loops to maintain robust API services by validating HTTP endpoints and binding interactions against the real runtime.