feat(utils): async version of parseIconSet

packages/utils/src/icon-set/parse.ts

@@ -10,7 +10,12 @@ import { getIconsTree } from './tree';
 export type SplitIconSetCallback = (
 	name: string,
 	data: ExtendedIconifyIcon | null
-) => void;
+) => unknown;
+
+export type SplitIconSetAsyncCallback = (
+	name: string,
+	data: ExtendedIconifyIcon | null
+) => Promise<unknown>;
 
 /**
  * Extract icons from an icon set
@@ -49,3 +54,40 @@ export function parseIconSet(
 
 	return names;
 }
+
+/**
+ * Async version of parseIconSet()
+ */
+export async function parseIconSetAsync(
+	data: IconifyJSON,
+	callback: SplitIconSetAsyncCallback
+): Promise<string[]> {
+	// List of icon names
+	const names: string[] = [];
+
+	// Must be an object and must have 'icons' property
+	if (typeof data !== 'object' || typeof data.icons !== 'object') {
+		return names;
+	}
+
+	// Check for missing icons list returned by API
+	if (data.not_found instanceof Array) {
+		for (let i = 0; i < data.not_found.length; i++) {
+			const name = data.not_found[i];
+			await callback(name, null);
+			names.push(name);
+		}
+	}
+
+	// Get tree
+	const tree = getIconsTree(data);
+	for (const name in tree) {
+		const item = tree[name];
+		if (item) {
+			await callback(name, internalGetIconData(data, name, item));
+			names.push(name);
+		}
+	}
+
+	return names;
+}

packages/utils/src/index.ts

@@ -39,7 +39,7 @@ export type {
 // Icon set functions
 export { getIconsTree } from './icon-set/tree';
 export type { ParentIconsList, ParentIconsTree } from './icon-set/tree';
-export { parseIconSet } from './icon-set/parse';
+export { parseIconSet, parseIconSetAsync } from './icon-set/parse';
 export { validateIconSet } from './icon-set/validate';
 export { quicklyValidateIconSet } from './icon-set/validate-basic';
 export { expandIconSet } from './icon-set/expand';

packages/utils/tests/parse-icons-test.ts

@@ -1,5 +1,5 @@
 import type { ExtendedIconifyIcon } from '@iconify/types';
-import { parseIconSet } from '../lib/icon-set/parse';
+import { parseIconSet, parseIconSetAsync } from '../lib/icon-set/parse';
 
 describe('Testing parsing icon set', () => {
 	test('Simple icon set', () => {
@@ -137,7 +137,7 @@ describe('Testing parsing icon set', () => {
 		expect(parsedNames).toEqual(expectedNames);
 	});
 
-	test('Nested aliases', () => {
+	test('Nested aliases', async () => {
 		// Names list
 		let names: string[] = [
 			'icon1',
@@ -234,7 +234,7 @@ describe('Testing parsing icon set', () => {
 		};
 
 		// Do stuff
-		const parsedNames = parseIconSet(
+		const parsedNames = await parseIconSetAsync(
 			{
 				prefix: 'foo',
 				icons: {
@@ -298,13 +298,19 @@ describe('Testing parsing icon set', () => {
 				height: 24,
 			},
 			(name, data) => {
-				// Make sure name exists in array of pending names
-				const index = names.indexOf(name);
-				expect(index).not.toBe(-1);
-				names = names.slice(0, index).concat(names.slice(index + 1));
+				return new Promise((fulfill) => {
+					// Make sure name exists in array of pending names
+					const index = names.indexOf(name);
+					expect(index).not.toBe(-1);
+					names = names
+						.slice(0, index)
+						.concat(names.slice(index + 1));
 
-				// Check icon data
-				expect(data).toEqual(expected[name]);
+					// Check icon data
+					expect(data).toEqual(expected[name]);
+
+					fulfill(void 0);
+				});
 			}
 		);