How does condition polling improve test speed?

Fixed sleeps always wait the full duration. Condition polling checks the state frequently and continues the test the moment the condition is met, often saving several seconds per test.

Why should I avoid using setTimeout or sleep in my tests?

Arbitrary timeouts are timing guesses. They often pass on local machines but fail in slower CI environments or under load, leading to inconsistent 'flaky' results.

When is an arbitrary timeout actually appropriate?

Only when testing actual timing behavior, such as verifying a debounce interval or throttle. In these cases, you should first wait for a triggering condition and then document exactly why the timeout is necessary.

What happens if the condition is never met?

The implementation includes a mandatory timeout duration (defaulting to 5000ms) that throws a clear, descriptive error to prevent the test from hanging indefinitely.

Condition-Based Waiting

Name: Condition-Based Waiting
Author: franroa

byfranroa

0•

安全与测试

Eliminates flaky tests by replacing arbitrary timeouts with smart condition polling for actual state changes.

Condition-Based Waiting is a specialized Claude Code skill designed to solve the common problem of flaky tests caused by timing dependencies and race conditions. Instead of relying on arbitrary delays like setTimeout or sleep—which often fail in CI environments or under heavy load—this skill implements a robust polling pattern. It provides guidance on waiting for actual events, state changes, or file system updates, ensuring your test suite is both faster and more reliable. By applying these patterns, developers can achieve 100% pass rates and significantly reduce execution time by avoiding unnecessary idle periods.

主要功能

01Optimized polling intervals to maintain performance without wasting CPU

02Implements smart timeout logic with descriptive error reporting

03Replaces unstable sleep/setTimeout calls with predictable polling

040 GitHub stars

05Specific patterns for event counts, state transitions, and file existence

06Domain-specific helpers for complex asynchronous assertions

使用场景

01Fixing inconsistent test failures in CI/CD pipelines caused by environment speed variability

02Testing asynchronous operations such as file system writes or network responses

03Optimizing test suite execution time by exiting wait loops immediately upon success

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add franroa/chezmoi condition-based-waiting

For use in Claude.ai and ChatGPT

Download Skill