# RedisQueue.queueLength() method · @imqueue/core

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

Returns the number of messages currently waiting in this queue's main list.

**Signature:**

```typescript
queueLength(): Promise<number>;
```
**Returns:**

Promise<number>

count of messages waiting to be consumed

## Remarks

Delayed messages that are not yet due, and messages currently leased to a worker under [IMQOptions.safeDelivery](https://imqueue.org/api/core/latest/core.imqoptions.safedelivery/), are not counted — so this is not the amount of outstanding work. Returns `0` when the queue has no writer connection, which makes "disconnected" indistinguishable from "empty"; it never throws.