q5 querySelector Helper Function

q5.js

/**
 * Returns matched element or nodelist.
 *
 * @param {string} A valid CSS selector.
 * @param {HTMLElement} An object instance of HTMLElement.
 * @param {boolean} True uses querySelectorAll and returns a Nodelist.
 * @return {HTMLElement or Nodelist} Matched element or elements.
 * Usage:
 * q5('.some-class') // returns single element in the DOM tree
 * q5('.some-class', ancestor) // returns single element descendant of parent element
 * q5('.some-class', ancestor, true) // returns Nodelist of matched descendant elements of ancestor
 * q5('.some-class', true) // returns Nodelist of matched elements in the DOM tree
 */

window.q5 = function (selector, ancestor, all) {
  if (typeof ancestor === "boolean") {
    all = ancestor
    
    return document.querySelectorAll(selector);
  } else {
    if (all) {
      return (ancestor ? ancestor : document).querySelectorAll(selector);
    } else {
      return (ancestor ? ancestor : document).querySelector(selector);
    }
  }
};