feat: add expectCallsAndReset()

Author: ersimont

projects/s-ng-dev-utils/src/lib/expect-calls-and-reset.spec.ts

@@ -0,0 +1,30 @@
+import { expectCallsAndReset } from "./expect-calls-and-reset";
+
+describe("expectCallsAndReset()", () => {
+  it("matches arguments", () => {
+    const spy = jasmine.createSpy();
+
+    spy("a thing", "or two");
+    expectCallsAndReset(spy, ["a thing", "or two"]);
+
+    spy();
+    expectCallsAndReset(spy, []);
+
+    spy(1);
+    spy(2);
+    spy(3, 4);
+    expectCallsAndReset(spy, [1], [2], [3, 4]);
+  });
+
+  it("resets the spy", () => {
+    const spy = jasmine.createSpy();
+
+    spy();
+    expectCallsAndReset(spy, []);
+    expect(spy).not.toHaveBeenCalled();
+
+    spy(1);
+    expectCallsAndReset(spy, [1]);
+    expect(spy).not.toHaveBeenCalled();
+  });
+});

projects/s-ng-dev-utils/src/lib/expect-calls-and-reset.ts

@@ -0,0 +1,17 @@
+/**
+ * Expects the spy to have been called the exact number of times as the argument lists provided, with those arguments, then resets the spy.
+ *
+ * ```ts
+ * const spy = jasmine.createSpy();
+ *
+ * spy(1)
+ * spy(2, 3)
+ * spy()
+ * expectCallsAndReset(spy, [1], [2, 3], []);
+ * ```
+ */
+export function expectCallsAndReset(spy: jasmine.Spy, ...allArgs: any[][]) {
+  expect(spy).toHaveBeenCalledTimes(allArgs.length);
+  expect(spy.calls.allArgs()).toEqual(allArgs);
+  spy.calls.reset();
+}

projects/s-ng-dev-utils/src/lib/expect-type.ts

@@ -10,4 +10,6 @@
 export function expectType<Expected, Actual extends Expected>(): void;
 export function expectType<Expected>(value: Expected): void;
 
-export function expectType(_value?: any) {}
+export function expectType(_value?: any) {
+  expect().nothing();
+}

projects/s-ng-dev-utils/src/public-api.ts

@@ -2,6 +2,7 @@
  * Public API Surface of s-ng-dev-utils
  */
 
+export { expectCallsAndReset } from "./lib/expect-calls-and-reset";
 export { expectSingleCallAndReset } from "./lib/expect-single-call-and-reset";
 export { expectType } from "./lib/expect-type";
 export { marbleTest } from "./lib/marble-test";

src/app/integration.spec.ts

@@ -1,5 +1,6 @@
 import {
   Existant,
+  expectCallsAndReset,
   expectSingleCallAndReset,
   expectType,
   Falsey,
@@ -17,6 +18,12 @@ import {
 } from "s-ng-dev-utils";
 
 describe("s-ng-dev-utils", () => {
+  it("has expectCallsAndReset()", () => {
+    const spy = jasmine.createSpy();
+    spy();
+    expectCallsAndReset(spy, []);
+  });
+
   it("has expectSingleCallAndReset()", () => {
     const spy = jasmine.createSpy();
     spy();