When should I still use a standard setTimeout in tests?

Only use arbitrary timeouts when you are testing actual timing behaviors, such as verifying that a debounce or throttle interval is functioning as expected.

What is the main benefit of condition-based waiting?

The primary benefit is the elimination of flakiness caused by timing guesses. It ensures tests wait exactly as long as necessary for a state to change, rather than relying on arbitrary sleep intervals.

Does this work with all JavaScript testing frameworks?

Yes, the patterns provided are generic and can be implemented in any environment, including Jest, Vitest, Playwright, Mocha, or Cypress.

Can this skill help with tests that fail specifically in CI pipelines?

Yes, it is specifically designed to solve the 'works on my machine' problem where CI environments are slower or more resource-constrained than local development machines.

Condition-Based Waiting

Name: Condition-Based Waiting
Author: franroa

byfranroa

0•

安全与测试

Eliminates flaky tests and race conditions by replacing arbitrary timeouts with smart, asynchronous condition polling.

Condition-Based Waiting is a specialized Claude Code skill designed to improve test reliability by replacing fragile 'guess-and-wait' patterns like setTimeout and sleep with robust polling logic. It provides domain-specific patterns and implementation guidance for waiting on actual state changes, events, or file system updates, ensuring tests pass consistently across different environments and CI pipelines. By waiting for the actual condition rather than a time interval, it reduces test execution time and eliminates common race conditions that cause inconsistent pass/fail behavior.

主要功能

01Replaces arbitrary sleep and timeout calls with dynamic condition polling

02Includes built-in timeout protections with descriptive error reporting

03Eliminates race conditions in asynchronous unit and integration tests

04Optimizes test execution speed by proceeding immediately once conditions are met

050 GitHub stars

06Provides reusable patterns for events, state changes, and file system checks

使用场景

01Synchronizing test assertions with asynchronous state transitions and event emitters

02Managing timing dependencies in complex integration tests involving file systems or network requests

03Fixing flaky tests that pass on local machines but fail under load in CI environments

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