🚧 progress: First draft.

Author: make-github-pseudonymous-again

Diff for: doc/scripts/header.js

@@ -17,7 +17,8 @@ domReady(() => {
 	header.insertBefore(projectname, header.firstChild);
 
 	const testlink = document.querySelector('header > a[data-ice="testLink"]');
-	testlink.href = 'https://app.codecov.io/gh/async-iterable-iterator/async-iterator-to-array';
+	testlink.href =
+		'https://app.codecov.io/gh/async-iterable-iterator/async-iterator-to-array';
 	testlink.target = '_BLANK';
 
 	const searchBox = document.querySelector('.search-box');

Diff for: src/index.js

@@ -1,2 +1,19 @@
-const answer = 42;
-export default answer;
+/**
+ * Spreads an asynchronous iterator inside a new array.
+ *
+ * TODO Could be abstracted further with asyncIteratorForEach.
+ *
+ * @param {AsyncIterator<any>} asyncIterator - the input iterator.
+ * @returns {Promise<any[]>} A new array filled with the elements of the input iterator.
+ */
+export const asyncIteratorToArray = async (asyncIterator) => {
+	const array = [];
+	for (;;) {
+		// eslint-disable-next-line no-await-in-loop
+		const {done, value} = await asyncIterator.next();
+		if (done) break;
+		array.push(value);
+	}
+
+	return array;
+};

Diff for: test/src/api.js

@@ -0,0 +1,28 @@
+import test from 'ava';
+
+import {asyncIteratorToArray} from '../../src/index.js';
+
+test('works with sync iterator', async (t) => {
+	const expected = [Math.random(), 3, 'x', {}, new Date()];
+	const it = expected[Symbol.iterator]();
+	const actual = await asyncIteratorToArray(it);
+	t.deepEqual(actual, expected);
+});
+
+const asyncify = async function* (array) {
+	// eslint-disable-next-line no-await-in-loop
+	for (const x of array) yield await x;
+};
+
+const macro = async (t, expected) => {
+	const asyncIterable = asyncify(expected);
+	const asyncIterator = asyncIterable[Symbol.asyncIterator]();
+	const actual = await asyncIteratorToArray(asyncIterator);
+	t.deepEqual(actual, expected);
+};
+
+macro.title = (title, expected) => title ?? JSON.stringify(expected);
+
+test(macro, [1, 2, 3]);
+test(macro, [1, Math.random(), 3]);
+test(macro, [1, Math.random(), 3]);