When is an arbitrary timeout actually appropriate?

They are only correct when testing actual timing behavior, such as verifying a debounce or throttle interval, and should always be documented with a 'why' comment.

What is condition-based waiting?

It is a testing pattern that waits for a specific state or event to occur instead of using a fixed time delay, making tests faster and more reliable.

How does this skill help with flaky tests?

It identifies 'sleep' or 'timeout' calls that cause race conditions and refactors them into 'waitFor' logic that polls for actual success conditions.

Does it work with React?

Yes, it includes specific patterns and best practices for React Testing Library's built-in asynchronous utilities like findByRole and waitFor.

Why should I avoid arbitrary timeouts?

Fixed delays make tests unnecessarily slow on fast machines and prone to failure on slower machines or under heavy CI load where processes take longer.

Condition-Based Waiting

Name: Condition-Based Waiting
Author: timequity

bytimequity

安全与测试

Replaces arbitrary test timeouts with intelligent condition polling to eliminate flaky test behavior and race conditions.

关于

The Condition-Based Waiting skill empowers Claude to identify and refactor unreliable tests that rely on arbitrary delays like setTimeout or sleep. By implementing a robust polling pattern, it ensures tests wait for specific conditions—such as state changes, event triggers, or file availability—rather than guessing execution time. This approach significantly improves CI/CD stability, reduces false negatives, and ensures tests run as fast as possible on high-performance machines while remaining resilient under heavy load.

主要功能

Detects and replaces hard-coded setTimeout and sleep calls in test suites
Implements intelligent polling logic with configurable timeouts and intervals
Integrates seamlessly with React Testing Library utilities like findBy and waitFor
0 GitHub stars
Provides specialized patterns for waiting on events, state changes, and file system updates
Standardizes error handling with descriptive timeout messages for better debugging

使用场景

Eliminating flaky tests in CI/CD environments that fail inconsistently due to timing issues
Migrating legacy test suites from hard-coded delays to modern asynchronous patterns
Refactoring complex integration tests that involve multiple asynchronous state transitions

关于

主要功能

Detects and replaces hard-coded setTimeout and sleep calls in test suites
Implements intelligent polling logic with configurable timeouts and intervals
Integrates seamlessly with React Testing Library utilities like findBy and waitFor
0 GitHub stars
Provides specialized patterns for waiting on events, state changes, and file system updates
Standardizes error handling with descriptive timeout messages for better debugging

使用场景

Eliminating flaky tests in CI/CD environments that fail inconsistently due to timing issues
Migrating legacy test suites from hard-coded delays to modern asynchronous patterns
Refactoring complex integration tests that involve multiple asynchronous state transitions