Bull (Task Queue for Node.js)

What is Bull and why is it needed?

Bull is one of the most popular libraries for managing job queues in the Node.js environment. It is built on top of Redis and allows you to efficiently process background tasks, distribute load among workers, and manage execution priorities. If your application needs to perform resource-intensive operations (sending email, generating PDF, image processing, data parsing) asynchronously without blocking the main request flow, Bull is the ideal solution.

Installation

To install Bull, you will need a pre-running Redis server. The library itself is installed via npm:

npm install bull

Also, make sure Redis is available at localhost:6379 or specify your own connection parameters.

Main Features

• Creating a queue — simply initialize an object with a queue name.
• Adding jobs — you can pass any JavaScript objects as job data.
• Processors — a function that executes for each job.
• Retries — automatic retry on errors.
• Delays — deferred job execution.
• Priorities — high-priority jobs are processed first.
• Events — you can listen for completion, error, and progress events.
• Pause/Resume — temporarily stop the queue.

Code Example in JavaScript (Node.js)

A simple queue example for sending email:

const Queue = require('bull');

// Create a queueconst emailQueue = new Queue('email', 'redis://127.0.0.1:6379');

// Add a jobemailQueue.add({  to: 'user@example.com',  subject: 'Hello!',  body: 'This is a test email'}, {  attempts: 3, // up to 3 attempts on error  delay: 5000   // delay by 5 seconds});

// Job processoremailQueue.process(async (job) => {  console.log('Sending email to:', job.data.to);  // Here call your email sending function  // await sendEmail(job.data);  console.log('Email sent successfully');  return Promise.resolve();});

// Event on successemailQueue.on('completed', (job) => {  console.log(`Job ${job.id} completed`);});

// Event on erroremailQueue.on('failed', (job, err) => {  console.error(`Job ${job.id} failed: ${err.message}`);});

When to use Bull

Bull is recommended for use in the following scenarios:

• Background tasks — sending notifications, newsletters, generating reports.
• Media processing — image resizing, video conversion.
• Web scraping — collecting data in the background without blocking the API.
• Integrations with external services — data synchronization, calling third-party APIs.
• Distributed processing — running multiple workers on different servers.

Thanks to the use of Redis, the Bull queue is fault-tolerant: if a worker crashes, the job will not be lost and will be executed by another process. This makes the library a reliable choice for production systems.