IMQOptions.watcherCheckDelay property

Interval in milliseconds of the periodic watcher check.

Signature:

watcherCheckDelay?: number;

Default Value

5000

Remarks

Each tick re-elects a watcher owner if none exists and, on worker-capable instances, releases due delayed messages — acting as the fallback when Redis keyspace notifications are unavailable. That makes this value the worst-case extra latency for a delayed message. Setting it to 0 disables both behaviours.

It also paces the watcher's maintenance sweep, which recovers the messages of workers that have died and drives the IMQOptions.cleanup pass — so this, not IMQOptions.safeDeliveryTtl, is the worst-case latency for a crashed worker's message coming back. With the check disabled the sweep falls back to safeDeliveryTtl, which on a large budget is very slow; leave it on if safe delivery matters.

Read this page as plain markdown — no HTML, no navigation. For pasting into an LLM, or for an agent to fetch.