What is @cloudflare/vitest-pool-workers?

It is a specialized Vitest pool that allows your tests to run directly within the Cloudflare Workers runtime environment for high-fidelity local testing.

Why is waitOnExecutionContext necessary in Worker tests?

It ensures that any background tasks initiated via 'ctx.waitUntil()' are fully completed before the test evaluation finishes, preventing false positives.

Does this support testing Durable Objects?

Yes, it provides patterns for interacting with Durable Object stubs and verifying state persistence across multiple fetch calls.

How do I access bindings like D1 or KV in my tests?

Use the 'cloudflare:test' module to import the 'env' object, which provides access to real bindings configured in your wrangler file with isolated storage per test.

What are the requirements for the latest 2025 testing setup?

You need Node.js 18 or higher, Vitest 2.1.8+, and the @cloudflare/vitest-pool-workers 0.7.2+ package to use the latest features.

Cloudflare Workers Testing

Name: Cloudflare Workers Testing
Author: secondsky

bysecondsky

•

Security & Testing

Implements comprehensive unit and integration testing for Cloudflare Workers using Vitest and the official workers pool for high-fidelity simulation.

This skill equips Claude with specialized knowledge to architect and maintain robust testing suites for Cloudflare Workers. It focuses on the latest testing patterns using Vitest and @cloudflare/vitest-pool-workers, enabling accurate simulation of the edge runtime. By providing standardized guidance for mocking bindings like D1, KV, R2, and Durable Objects, this skill ensures that developers can catch edge-specific errors, manage isolated storage states, and verify complex execution contexts before deployment.

Key Features

01Automated coverage reporting and 2025-ready migration patterns

02Isolated storage mocking for D1, KV, R2, and Durable Objects

0321 GitHub stars

04Standardized setup for Vitest with @cloudflare/vitest-pool-workers integration

05Execution context management for testing background tasks and waitUntil()

06High-fidelity simulation of the Cloudflare edge runtime via Miniflare

Use Cases

01Migrating legacy Worker tests to the modern cloudflare:test module

02Debugging complex binding errors and isolation issues in integration tests

03Establishing a production-ready testing framework for new edge applications

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add secondsky/claude-skills cloudflare-workers-testing

For use in Claude.ai and ChatGPT

Download Skill