Prioritized
Jobs can also include a priority option. Using priorities, job processing order will be affected by the specified priority instead of following a FIFO or LIFO pattern.
WARNING
Adding prioritized jobs is a slower operation than the other types of jobs, with a complexity O(log(n)) relative to the number of jobs in the prioritized set in the queue.
Note that prioritized jobs use values from 1 to 2 097 151, where a lower number is always a higher priority than higher numbers. A priority of 0 means no priority, so those jobs are processed before prioritized jobs.
DANGER
Jobs without a priority assigned will get the highest priority, being processed before jobs with priorities assigned to them.
import { Queue } from 'bullmq';
const myQueue = new Queue('Paint');
await myQueue.add('wall', { color: 'pink' }, { priority: 10 });
await myQueue.add('wall', { color: 'brown' }, { priority: 5 });
await myQueue.add('wall', { color: 'blue' }, { priority: 7 });
// The wall will be painted first brown, then blue and
// finally pink.If several jobs are added with the same priority value, then the jobs within that priority will be processed in FIFO (First in, first out) fashion.
Change priority
If you want to change the priority after inserting a job, use the changePriority method. For example, let's say that you want to change the priority from 16 to 1:
const job = await Job.create(queue, 'test2', { foo: 'bar' }, { priority: 16 });
await job.changePriority({
priority: 1,
});or if you want to use the LIFO (Last In, First Out) option:
const job = await Job.create(queue, 'test2', { foo: 'bar' }, { priority: 16 });
await job.changePriority({
lifo: true,
});Get Prioritized jobs
As prioritized is a new state. You must use getJobs or getPrioritized method as:
const jobs = await queue.getJobs(['prioritized']);
const jobs2 = await queue.getPrioritized();Get Counts per Priority
If you want to get the count of jobs in prioritized status (priorities higher than 0) or in waiting status (priority 0), use the getCountsPerPriority method. For example, let's say that you want to get counts for priority 1 and 0:
const counts = await queue.getCountsPerPriority([1, 0]);
/*
{
'1': 11,
'0': 10
}
*/