# ClusteredRedisQueue.once() method · @imqueue/core

Source: https://imqueue.org/api/core/latest/core.clusteredredisqueue.once/
Published: 2026-08-04
Author: @imqueue maintainers (https://github.com/imqueue)
Package: @imqueue/core 3.3.2 — generated reference, not hand-written

Registers a one-shot listener on every server's queue and on the internal template.

**Signature:**

```typescript
once(...args: any[]): this;
```

## Parameters


| Parameter | Type | Description |
| --- | --- | --- |
| args | any\[\] | the arguments `EventEmitter.once` accepts |


**Returns:**

this

this queue instance

## Remarks

Because registration is replicated per server, this arms one independent one-shot listener per server — so the callback may run once for each server in the cluster rather than once overall, and more as servers join. Use [ClusteredRedisQueue.on()](https://imqueue.org/api/core/latest/core.clusteredredisqueue.on/) plus explicit de-registration if you need at-most-once semantics.