Microq is a simple but reliable message queue built on mongodb.

$ npm install microq

Notice microq needs async/await support. So use node.js 8.x please

const microq = require('microq');
const queue = microq(connectionUrl);

const job = await queue.enqueue('foo', { data: 'hello' });

const microq = require('microq');
const queue = microq(connectionUrl);

queue.start({
  foo(params, job) => {
    // Work on job data passed in params ({ data: 'hello' })
    // To fail, throw an error
    // To succeed return something, even undefined is accepted:)
  }
}, { interval: 500 });

Notice microq uses the debug (https://www.npmjs.com/package/debug) with prefix microq. So if you need some log output turn debug on.

Microq supports workers to use async/await or to return Promises. A worker may throw an exception to fail. The queue will NOT shut down if a worker fails.

Worker function should return a promise or should be defined as async functions.

async foo(params, job) => {
  await something();

  await somthingOther();

  // ...
  return;
}

In case the worker queue is started with option parallel set to false this allows the worker queue to wait until the job finishes and to set the status of the job correctly.

Creates a new queue connected to a mongodb database specified by connectionUrl. You can optionally pass connection options to mongodb.

Enqueues a job with name jobName and optional params passed to the worker.

Options

• priority - defines the dequeue priority. jobs with higher priority are dequeued first.

Returns a promise resolving to the persisted job

Starts the queue with workers passed in the workers object. A worker must be a function.

Options

• recover (Boolean) - Defines if jobs that are in status dequeued should be recovered when starting the queue. Defaults to true.
• interval (number in milliseconds) - Defines the poll interval. Defaults to 5000 ms.
• parallel (Boolean) - Defines whether jobs are executed in parallel. Defaults to true.

Query the queue for jobs with the given status. Status must be one of enqueued, dequeued, completed, failed.

Returns a promise resolving to a list of jobs

Updates all jobs currently in dequeue status to enqueued status and adds a date field recoveredAt

Removes all jobs before a specified date (new Date() if not given) in status completed or failed.

Stops polling. No workers are started after stopping the queue.

The queue object returned by microq(connectionUrl) is an EventEmitter emitting events:

• failed - A worker failed to process a job
• completed - A woker processed a job successfully
• empty - The job queue is currently empty