@weborigami/async-tree 0.6.2 → 0.6.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weborigami/async-tree",
-  "version": "0.6.2",
+  "version": "0.6.3",
   "description": "Asynchronous tree drivers based on standard JavaScript classes",
   "type": "module",
   "main": "./main.js",

package/src/Tree.js

@@ -67,4 +67,5 @@ export { default as traverse } from "./operations/traverse.js";
 export { default as traverseOrThrow } from "./operations/traverseOrThrow.js";
 export { default as traversePath } from "./operations/traversePath.js";
 export { default as values } from "./operations/values.js";
+export { default as visit } from "./operations/visit.js";
 export { default as withKeys } from "./operations/withKeys.js";

package/src/operations/visit.js

@@ -0,0 +1,14 @@
+import getMapArgument from "../utilities/getMapArgument.js";
+import reduce from "./reduce.js";
+
+/**
+ * Visit every node in the tree and return `undefined`.
+ *
+ * @typedef {import("../../index.ts").Maplike} Maplike
+ *
+ * @param {Maplike} source
+ */
+export default async function visit(source) {
+  const tree = await getMapArgument(source, "visit", { deep: true });
+  return reduce(tree, () => undefined);
+}

package/test/operations/visit.test.js

@@ -0,0 +1,25 @@
+import assert from "node:assert";
+import { describe, test } from "node:test";
+import FunctionMap from "../../src/drivers/FunctionMap.js";
+import visit from "../../src/operations/visit.js";
+
+describe("visit", () => {
+  test("visits every node in the tree", async () => {
+    const values = [];
+    const map = new FunctionMap(
+      (key) => {
+        const value = `value for ${key}`;
+        values.push(value);
+        return value;
+      },
+      ["a", "b", "c"]
+    );
+    const result = await visit(map);
+    assert.strictEqual(result, undefined);
+    assert.deepStrictEqual(values, [
+      "value for a",
+      "value for b",
+      "value for c",
+    ]);
+  });
+});