# RedisQueue.(constructor) · @imqueue/core

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

Creates a queue handle. No connection is opened here — call [RedisQueue.start()](https://imqueue.org/api/core/latest/core.redisqueue.start/), or [RedisQueue.send()](https://imqueue.org/api/core/latest/core.redisqueue.send/), which starts the queue implicitly.

**Signature:**

```typescript
constructor(
    name: string, options?: Partial<IMQOptions>, mode?: IMQMode);
```

## Parameters


| Parameter | Type | Description |
| --- | --- | --- |
| name | string | queue name; the underlying Redis list key becomes `<prefix>:<name>` |
| options | Partial<[IMQOptions](https://imqueue.org/api/core/latest/core.imqoptions/)> | _(Optional)_ partial options merged over [DEFAULT\_IMQ\_OPTIONS](https://imqueue.org/api/core/latest/core.default_imq_options/) |
| mode | [IMQMode](https://imqueue.org/api/core/latest/core.imqmode/) | _(Optional)_ whether this handle produces, consumes, or both; defaults to [IMQMode.BOTH](https://imqueue.org/api/core/latest/core.imqmode/) |


## Remarks

The constructor performs no I/O. It resolves the effective options, selects the serializer pair from [IMQOptions.useGzip](https://imqueue.org/api/core/latest/core.imqoptions.usegzip/) once, and derives the `host:port` key under which the shared connections are stored — so changing `useGzip`, `host` or `port` on `options` afterwards has no effect.