`querySelectorAll` with regex support

querySelectorAllRegex.ts

/**
 * querySelectorAll with regex support.
 * Adapted from: https://stackoverflow.com/a/62144522.
 *
 * Note: In the `attributeToSearch` parameter's absence, all attributes on all
 * DOM nodes will be searched. This can get quite expensive for large DOM trees.
 *
 * Usage example:
 * `querySelectorAllRegex(/someregex/, 'target-specific-attribute-if-needed');`
 *
 * @param regex - A regular expression selector.
 * @param attributeToSearch - A specific attribute to search on.
 * @returns All element descendants of nodes that match the regex selector.
 */
function querySelectorAllRegex(
  regex: RegExp,
  attributeToSearch?: string
): Element[] {
  const output: Element[] = [];

  if (attributeToSearch) {
    for (let element of document.querySelectorAll<Element>(
      `[${attributeToSearch}]`
    )) {
      if (regex.test(element.getAttribute(attributeToSearch))) {
        output.push(element);
      }
    }
  } else {
    for (let element of document.querySelectorAll<Element>('*')) {
      for (let attribute of element.attributes) {
        if (regex.test(attribute.value)) {
          output.push(element);
        }
      }
    }
  }

  return output;
}