vanillajs-browser-helpers/findUniqueNodeCollection.mjs

Collection of convenience code snippets (helpers) that aims to make it a little easier to work with vanilla JS in the browser

import isString from 'vanillajs-helpers/isString';
/**
 * Make a unique list of Elements from a list of selectors and and function to use that selector.
 *
 * @param selector - The selector(s) to use with the given `findElements` function
 * @param findElements - The function to find elements
 * @returns The unique list of found elements
 *
 * @example
 *
 * ```ts
 * const byClassName = (selector) => document.getElementsByClassName(selector)
 *
 * // Using a single selector
 * findUniqueNodeCollection('my-elements', byClassName);
 *
 * // Using multiple selectors
 * findUniqueNodeCollection(['my-elements', 'sone-other-elements'], byClassName);
 * ```
 */
export default function findUniqueNodeCollection(selector, findElements) {
    const selectors = isString(selector) ? [selector] : selector;
    const nodes = selectors.flatMap((s) => Array.from(findElements(s)));
    return Array.from(new Set(nodes));
}