Skip to content

Commit 11b3be4

Browse files
committed
docs: warn that waiting parents are blocked for as long as a debounced run is pushed back
With no ceiling, a continuously triggered key holds its run indefinitely, and triggerAndWait parents block on that run's waitpoint for the whole time, holding their concurrency with it.
1 parent fba36a1 commit 11b3be4

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

docs/triggering.mdx

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -886,7 +886,9 @@ The `debounce` option accepts:
886886
There is no time limit on step 2. While triggers keep arriving on the same key, the run keeps
887887
being pushed back and never executes. A key triggered every 10 seconds with a `delay` of `"30s"`
888888
runs 30 seconds after the triggers stop, however long that takes. Set `maxDelay` whenever the
889-
work needs to happen eventually.
889+
work needs to happen eventually. This matters most with `triggerAndWait`: every parent waiting
890+
on a debounced run stays blocked, and holds its concurrency, for as long as the run keeps being
891+
pushed back.
890892
</Warning>
891893

892894
**Limiting total delay with `maxDelay`:**

0 commit comments

Comments
 (0)