add clear function

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 # Upcoming
 
+- Performance: Better handling of wait timeouts. Instead of waiting in intervals of 50ms, we check the result whenever new results are
+  added to the bin.
+- Feature: "clear" method to remove all objects
+
 # v0.2.1
 
 Date: 2024-04-21T21:47:25.224Z

src/QueryBin.d.ts

@@ -5,6 +5,8 @@ export class QueryBin<T, Q extends QueryDefinitions<T> = QueryDefinitions<T>> {
 
   addAll(values: T[]): void;
 
+  clear(): void;
+
   all(): T[];
 
   queryAll: QueryAll<T, Q>;

src/QueryBin.js

@@ -77,6 +77,10 @@ export class QueryBin {
     this.latch.next();
   }
 
+  clear() {
+    this.values = [];
+  }
+
   all() {
     return this.values;
   }

src/QueryBin.test.ts

@@ -31,6 +31,14 @@ describe("QueryBin", () => {
     expect(numbers.all()).toEqual([1, 2, 3, 1, 2]);
   });
 
+  it("can clear all values", () => {
+    const numbers = new QueryBin({});
+    numbers.addAll([1, 2, 3]);
+    expect(numbers.all()).toEqual([1, 2, 3]);
+    numbers.clear();
+    expect(numbers.all()).toEqual([]);
+  });
+
   it("queryAll returns all results matching a query", () => {
     const bin = new QueryBin({ dividableBy });
     bin.addAll([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);