denque

What is denque?

The denque npm package is a fast double-ended queue implementation. It is optimized for performance and is useful for situations where you need a queue that allows adding or removing items from both ends.

What are denque's main functionalities?

Adding items

This demonstrates how to add items to the queue. 'push' adds an item to the end of the queue, while 'unshift' adds an item to the beginning.

const Denque = require('denque');
let myQueue = new Denque();
myQueue.push('item1');
myQueue.unshift('item0');

Removing items

This shows how to remove items from the queue. 'pop' removes an item from the end of the queue, and 'shift' removes an item from the beginning.

const removedLast = myQueue.pop();
const removedFirst = myQueue.shift();

Peeking at items

This code sample demonstrates how to peek at items in the queue without removing them. 'peekFront' looks at the first item, and 'peekBack' looks at the last item.

const firstItem = myQueue.peekFront();
const lastItem = myQueue.peekBack();

Other packages similar to denque

fastqueue

FastQueue is another high-performance queue implementation. It offers similar functionality to Denque but may have different performance characteristics under certain conditions.

double-ended-queue

This package also provides a double-ended queue implementation. It is similar to Denque in terms of API and functionality but might have slight differences in performance or additional methods.

README

Denque

Denque is a well tested, extremely fast and lightweight double-ended queue implementation with zero dependencies and includes TypeScript types.

Double-ended queues can also be used as a:

• Stack
• Queue

This implementation is currently the fastest available, even faster than double-ended-queue, see the benchmarks.

Every queue operation is done at a constant O(1) - including random access from .peekAt(index).

Works on all node versions >= v0.10

Quick Start

Install the package:

npm install denque

Create and consume a queue:

const Denque = require("denque");

const denque = new Denque([1,2,3,4]);
denque.shift(); // 1
denque.pop(); // 4

See the API reference documentation for more examples.

---

Who's using it?

• Kafka Node.js client
• MariaDB Node.js client
• MongoDB Node.js client
• MySQL Node.js client
• Redis Node.js clients

... and many more.

---

License

• See LICENSE

---

Built and maintained by Invertase.

Changelog

2.1.0

• fix: issue where clear() is still keeping references to the elements (#47)
• refactor: performance optimizations for growth and array copy (#43)
• refactor: performance optimizations for toArray and fromArray (#46)
• test: add additional benchmarks for queue growth and toArray (#45)