condition-based-waiting

Flaky tests often guess at timing with arbitrary delays. This creates race conditions where tests pass on fast machines but fail under load or in CI.

Core principle: Wait for the actual condition you care about, not a guess about how long it takes.

| Wait for event | waitFor(() => events.find(e => e.type === 'DONE')) | | Wait for state | waitFor(() => machine.state === 'ready') | | Wait for count | waitFor(() => items.length >= 5) | | Wait for file | waitFor(() => fs.existsSync(path)) | | Complex condition | waitFor(() => obj.ready && obj.value > 10) |

يُستخدم عندما تحتوي الاختبارات على ظروف سباق، أو تبعيات توقيت، أو سلوك نجاح/فشل غير متناسق - يستبدل المهلات العشوائية باستقصاء الحالة لانتظار تغييرات الحالة الفعلية، مما يزيل الاختبارات غير المستقرة من تخمينات التوقيت المصدر: microck/ordinary-claude-skills.