From 80567cca6ce00962c9798d5d14cc9b3ebc998577 Mon Sep 17 00:00:00 2001
From: James Sumners <jsumners@newrelic.com>
Date: Wed, 4 Sep 2024 09:50:13 -0400
Subject: [PATCH] chore: Added a match function for tests

---
 test/lib/custom-assertions.js | 67 ++++++++++++++++++++++++++++++++++-
 1 file changed, 66 insertions(+), 1 deletion(-)

diff --git a/test/lib/custom-assertions.js b/test/lib/custom-assertions.js
index ac67506a82..edc0c94cee 100644
--- a/test/lib/custom-assertions.js
+++ b/test/lib/custom-assertions.js
@@ -80,9 +80,74 @@ function compareSegments(parent, segments) {
   })
 }
 
+/**
+ * Like `tap.prototype.match`. Verifies that `actual` satisfies the shape
+ * provided by `expected`.
+ *
+ * This may eventually make its way into `node:assert`. See
+ * https://github.com/fastify/fastify/discussions/5628#discussioncomment-10392942
+ *
+ * @example
+ * const input = {
+ *   foo: /^foo.+bar$/,
+ *   bar: [1, 2, '3']
+ * }
+ * // true
+ * match(input, {
+ *   foo: 'foo is bar',
+ *   bar: [1, 2, '3']
+ * })
+ * // false
+ * match(input, {
+ *   foo: 'foo is bar',
+ *   bar: [1, 2, '3', 4]
+ * })
+ *
+ * @param {string|object} actual The entity to verify.
+ * @param {string|object} expected What the entity should match against.
+ *
+ * @returns {boolean} `true` if `actual` satisfies `expected`. `false`
+ * otherwise.
+ */
+function match(actual, expected) {
+  if (typeof actual === 'string' && typeof expected === 'string') {
+    const patterns = expected
+      .trim()
+      .split(/\r?\n/)
+      .map((s) => s.trim())
+
+    let lastIndex = -1
+    for (const pattern of patterns) {
+      const index = actual.indexOf(pattern)
+      if (index === -1 || index < lastIndex) {
+        return false
+      }
+      lastIndex = index
+    }
+    return true
+  }
+
+  for (const key in expected) {
+    if (key in actual) {
+      if (typeof expected[key] === 'object' && expected[key] !== null) {
+        /* c8 ignore next 3 */
+        if (!match(actual[key], expected[key])) {
+          return false
+        }
+      } else if (actual[key] !== expected[key]) {
+        return false
+      }
+    } else {
+      return false
+    }
+  }
+  return true
+}
+
 module.exports = {
   assertCLMAttrs,
   assertExactClmAttrs,
   compareSegments,
-  isNonWritable
+  isNonWritable,
+  match
 }