feat(matcher): add toContainAnyValues matcher

README.md

@@ -89,7 +89,6 @@ Released under the [MIT](./LICENSE) license
     - toContainAllKeys
     - toContainValues
     - toContainAllValues
-    - toContainAnyValues
     - toContainEntry
     - toContainEntries
     - toContainAllEntries

matcher/mod.ts

@@ -80,3 +80,4 @@ export { toBeHexColor } from "./to_be_hex_color.ts";
 export { toIncludeAllMembers } from "./to_include_all_members.ts";
 export { toContainAnyKeys } from "./to_contain_any_keys.ts";
 export { toContainValue } from "./to_contain_value.ts";
+export { toContainAnyValues } from "./to_contain_any_values.ts";

matcher/preset.ts

@@ -1,5 +1,6 @@
 // Copyright 2021-Present the Unitest authors. All rights reserved. MIT license.
 // This module is browser compatible.
+import { toContainAnyValues } from "./to_contain_any_values.ts";
 import { toContainValue } from "./to_contain_value.ts";
 import { toContainAnyKeys } from "./to_contain_any_keys.ts";
 import { toIncludeAllMembers } from "./to_include_all_members.ts";
@@ -122,6 +123,7 @@ const jestMatcherMap = {
  * @see https://github.com/jest-community/jest-extended
  */
 const jestExtendedMatcherMap = {
+  toContainAnyValues,
   toContainValue,
   toContainAnyKeys,
   toIncludeAllMembers,

matcher/to_contain_any_values.ts

@@ -0,0 +1,19 @@
+// Copyright 2021-Present the Unitest authors. All rights reserved. MIT license.
+// This module is browser compatible.
+
+import { containSome } from "./utils.ts";
+import type { MatchResult } from "./types.ts";
+
+function toContainAnyValues(actual: object, expected: unknown[]): MatchResult {
+  const actualValue = Object.values(actual);
+
+  return {
+    pass: containSome(actualValue, expected),
+    actual: actualValue,
+    actualHint: "Actual values:",
+    expected,
+    expectedHint: "Expected to contain any of values:",
+  };
+}
+
+export { toContainAnyValues };

matcher/to_contain_any_values_test.ts

@@ -0,0 +1,20 @@
+// Copyright 2021-Present the Unitest authors. All rights reserved. MIT license.
+
+import { assertEquals, assertFail, assertSuccess } from "../dev_deps.ts";
+import { toContainAnyValues } from "./to_contain_any_values.ts";
+
+Deno.test({
+  name: "toContainAnyValues",
+  fn: () => {
+    assertSuccess(toContainAnyValues({ a: 1, b: 2 }, [0, 2]));
+    assertFail(toContainAnyValues({}, []));
+
+    assertEquals(toContainAnyValues({ a: 1, b: 2, c: 3 }, [4, 5, 6]), {
+      pass: false,
+      actual: [1, 2, 3],
+      actualHint: "Actual values:",
+      expected: [4, 5, 6],
+      expectedHint: "Expected to contain any of values:",
+    });
+  },
+});

matcher/utils.ts

@@ -14,6 +14,10 @@ function contains(array: unknown[], value: unknown): boolean {
   return array.some((v) => equal(v, value));
 }
 
+function containSome(target: unknown[], part: unknown[]): boolean {
+  return part.some((value) => contains(target, value));
+}
+
 function has(
   key: PropertyKey,
   object: object,
@@ -62,4 +66,4 @@ function hasPath(
   return false;
 }
 
-export { contains, has, hasPath, propPath, takeLast };
+export { contains, containSome, has, hasPath, propPath, takeLast };

matcher/utils_test.ts

@@ -1,6 +1,6 @@
 // Copyright 2021-Present the Unitest authors. All rights reserved. MIT license.
 import { assertEquals } from "../dev_deps.ts";
-import { contains, hasPath, propPath } from "./utils.ts";
+import { contains, containSome, hasPath, propPath } from "./utils.ts";
 import { stringify } from "../helper/format.ts";
 
 Deno.test({
@@ -45,6 +45,28 @@ Deno.test({
   },
 });
 
+Deno.test({
+  name: "containSome",
+  fn: () => {
+    const table: [
+      ...Parameters<typeof containSome>,
+      ReturnType<typeof containSome>,
+    ][] = [
+      [[], [], false],
+      [[], [1], false],
+      [[1, 2, 3], [2], true],
+      [[1, 2, 3], [2, 3], true],
+      [[1, 2, 3], [{}, [], 1], true],
+    ];
+    table.forEach(([target, part, result]) => {
+      assertEquals(
+        containSome(target, part),
+        result,
+      );
+    });
+  },
+});
+
 Deno.test({
   name: "propPath",
   fn: () => {

mod.ts

@@ -17,6 +17,7 @@ export { toEqualCaseInsensitive } from "./matcher/to_equal_case_insensitive.ts";
 export { toIncludeAllMembers } from "./matcher/to_include_all_members.ts";
 export { toContainAnyKeys } from "./matcher/to_contain_any_keys.ts";
 export { toContainValue } from "./matcher/to_contain_value.ts";
+export { toContainAnyValues } from "./matcher/to_contain_any_values.ts";
 export { toBeHexColor } from "./matcher/to_be_hex_color.ts";
 export { toBeDateString } from "./matcher/to_be_date_string.ts";
 export { toBeSealed } from "./matcher/to_be_sealed.ts";