JavaScript with RabbitMQ and LavinMQ

We recommend amqp-client.js. It reconnects automatically, recovers your consumers after a reconnect, and has no dependencies. It runs in Node.js, Bun, Deno and the browser.

npm install @cloudamqp/amqp-client

Publish and consume

These files use Node.js 24.2 or later. Set "type": "module" in package.json, and set BROKER_URL to the AMQP URL from your instance’s details page in the CloudAMQP console. Without it, the examples connect to a local broker.

Save the connection helper as amqp.js:

import { AMQPSession } from "@cloudamqp/amqp-client"

// The session reconnects automatically and recovers consumers
export function connect() {
  return AMQPSession.connect(process.env.BROKER_URL || "amqp://guest:guest@localhost")
}

Save the publisher as publisher.js:

import { connect } from "./amqp.js"

// Resolves once the broker has confirmed the message
export async function publish(session, queueName, message) {
  const queue = await session.queue(queueName, { durable: true })
  await queue.publish(message, { deliveryMode: 2 })
  console.log(` [x] Sent '${message}'`)
}

if (import.meta.main) {
  const session = await connect()
  await publish(session, "hello", "Hello world!")
  await session.stop()
}

Save the consumer as worker.js in the same directory:

import { connect } from "./amqp.js"

// The message is acked when the callback returns, and requeued if it throws
export async function consume(session, queueName, handler) {
  const queue = await session.queue(queueName, { durable: true })
  return queue.subscribe({ prefetch: 10 }, async (msg) => {
    await handler(msg.bodyString() ?? "")
  })
}

if (import.meta.main) {
  const session = await connect()
  await consume(session, "hello", (message) => console.log(` [x] Received '${message}'`))
  console.log(" [*] Waiting for messages. To exit press CTRL+C")
  process.on("SIGINT", async () => {
    await session.stop()
  })
}

Run node worker.js in one terminal and node publisher.js in another.

A runnable example is in javascript/amqp-client in cloudamqp/examples. The same example in TypeScript is on the TypeScript page.

Good to know

  • Connect with the URL. AMQPSession.connect(url), where the URL is the one on your instance’s details page in the CloudAMQP console. With amqps:// the server certificate is verified.
  • Use AMQPSession, the high-level API. It reconnects with exponential backoff and recovers subscriptions; AMQPClient is the low-level API that doesn’t.
  • Make handlers idempotent, because a message can be delivered again after a reconnect.
  • Set a prefetch limit when you subscribe, so a consumer doesn’t buffer more messages than it can handle.
  • In the browser, use a wss:// URL; the client then connects over WebSockets. See AMQP over WebSockets.

See the API documentation for codecs, RPC and the low-level API.

Other JavaScript libraries

  • amqplib, a widely used Node.js client without automatic reconnection
Was this page helpful?

Thanks for your feedback!