Queue.js 978 B

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. /*
  2. MIT License http://www.opensource.org/licenses/mit-license.php
  3. Author Tobias Koppers @sokra
  4. */
  5. "use strict";
  6. /**
  7. * @template T
  8. */
  9. class Queue {
  10. /**
  11. * @param {Iterable<T>=} items The initial elements.
  12. */
  13. constructor(items) {
  14. /**
  15. * @private
  16. * @type {Set<T>}
  17. */
  18. this._set = new Set(items);
  19. }
  20. /**
  21. * Returns the number of elements in this queue.
  22. * @returns {number} The number of elements in this queue.
  23. */
  24. get length() {
  25. return this._set.size;
  26. }
  27. /**
  28. * Appends the specified element to this queue.
  29. * @param {T} item The element to add.
  30. * @returns {void}
  31. */
  32. enqueue(item) {
  33. this._set.add(item);
  34. }
  35. /**
  36. * Retrieves and removes the head of this queue.
  37. * @returns {T | undefined} The head of the queue of `undefined` if this queue is empty.
  38. */
  39. dequeue() {
  40. const result = this._set[Symbol.iterator]().next();
  41. if (result.done) return;
  42. this._set.delete(result.value);
  43. return result.value;
  44. }
  45. }
  46. module.exports = Queue;