PushOptions.ttl property

Milliseconds after which this job stops being re-scheduled, counted from the moment it is pushed.

Signature:

ttl?: number;

Remarks

This bounds retrying, not delivery, and the difference is observable. The deadline is only consulted after a handler has run: an expired job is still handed to the handler and still runs, and expiry then suppresses the re-scheduling it would otherwise have got. So a job that keeps failing stops being retried once its TTL has passed, but a job delivered late is not silently discarded — it runs once more first.

Omit it and the job is retried for as long as its handler keeps asking.

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