Have ideas to improve npm?Join in the discussion! »

    fastq

    1.11.0 • Public • Published

    fastq

    ci npm version Dependency Status

    Fast, in memory work queue.

    Benchmarks (1 million tasks):

    • setImmediate: 812ms
    • fastq: 854ms
    • async.queue: 1298ms
    • neoAsync.queue: 1249ms

    Obtained on node 12.16.1, on a dedicated server.

    If you need zero-overhead series function call, check out fastseries. For zero-overhead parallel function call, check out fastparallel.

    js-standard-style

    Install

    npm i fastq --save

    Usage

    'use strict'
    
    var queue = require('fastq')(worker, 1)
    
    queue.push(42, function (err, result) {
      if (err) { throw err }
      console.log('the result is', result)
    })
    
    function worker (arg, cb) {
      cb(null, 42 * 2)
    }

    or

    var queue = require('fastq').promise(worker, 1)
    
    async function worker (arg) {
      return 42 * 2
    }
    
    async function run () {
      const result = await queue.push(42)
      console.log('the result is', result)
    })
    }
    
    run()

    Setting this

    'use strict'
    
    var that = { hello: 'world' }
    var queue = require('fastq')(that, worker, 1)
    
    queue.push(42, function (err, result) {
      if (err) { throw err }
      console.log(this)
      console.log('the result is', result)
    })
    
    function worker (arg, cb) {
      console.log(this)
      cb(null, 42 * 2)
    }

    API


    fastqueue([that], worker, concurrency)

    Creates a new queue.

    Arguments:

    • that, optional context of the worker function.
    • worker, worker function, it would be called with that as this, if that is specified.
    • concurrency, number of concurrent tasks that could be executed in parallel.

    queue.push(task, done)

    Add a task at the end of the queue. done(err, result) will be called when the task was processed.


    queue.unshift(task, done)

    Add a task at the beginning of the queue. done(err, result) will be called when the task was processed.


    queue.pause()

    Pause the processing of tasks. Currently worked tasks are not stopped.


    queue.resume()

    Resume the processing of tasks.


    queue.idle()

    Returns false if there are tasks being processed or waiting to be processed. true otherwise.


    queue.length()

    Returns the number of tasks waiting to be processed (in the queue).


    queue.getQueue()

    Returns all the tasks be processed (in the queue). Returns empty array when there are no tasks


    queue.kill()

    Removes all tasks waiting to be processed, and reset drain to an empty function.


    queue.killAndDrain()

    Same than kill but the drain function will be called before reset to empty.


    queue.error(handler)

    Set a global error handler. handler(err, task) will be called when any of the tasks return an error.


    queue.concurrency

    Property that returns the number of concurrent tasks that could be executed in parallel. It can be altered at runtime.


    queue.drain

    Function that will be called when the last item from the queue has been processed by a worker. It can be altered at runtime.


    queue.empty

    Function that will be called when the last item from the queue has been assigned to a worker. It can be altered at runtime.


    queue.saturated

    Function that will be called when the queue hits the concurrency limit. It can be altered at runtime.


    fastqueue.promise([that], worker(arg), concurrency)

    Creates a new queue with Promise apis. It also offers all the methods and properties of the object returned by fastqueue with the modified push and unshift methods.

    Node v10+ is required to use the promisified version.

    Arguments:

    • that, optional context of the worker function.
    • worker, worker function, it would be called with that as this, if that is specified. It MUST return a Promise.
    • concurrency, number of concurrent tasks that could be executed in parallel.

    queue.push(task) => Promise

    Add a task at the end of the queue. The returned Promise will be fulfilled when the task is processed.

    queue.unshift(task) => Promise

    Add a task at the beginning of the queue. The returned Promise will be fulfilled when the task is processed.

    License

    ISC

    Install

    npm i fastq

    DownloadsWeekly Downloads

    10,826,989

    Version

    1.11.0

    License

    ISC

    Unpacked Size

    33.7 kB

    Total Files

    12

    Last publish

    Collaborators

    • avatar