<h2>File Contents: /home/planet5/.trash/9monarch/core/ui/utils/utils.js</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/.trash/9monarch/core/ui/utils/utils.js'><textarea name='file_content' rows='10' cols='50'>// External Dependencies
import isEqual from &#039;lodash/isEqual&#039;;
import get from &#039;lodash/get&#039;;

const Utils = {

  toString(value) {
    if (value &amp;&amp; typeof value.toString === &#039;function&#039;) {
      return value.toString();
    }

    if (Array.isArray(value)) {
      return value.join(&#039;,&#039;);
    }

    if (typeof value === &#039;undefined&#039; || value === null) {
      return &#039;&#039;;
    }

    return &quot;&quot; + value;
  },

  decodeHtmlEntities(value) {
    return Utils.toString(value).replace(/&amp;#(\d+);/g, (match, dec) =&gt; String.fromCharCode(dec));
  },

  shouldComponentUpdate(component, nextProps, nextState) {
    return ! isEqual(nextProps, component.props) || ! isEqual(nextState, component.state);
  },

  isScriptExcluded(node) {
    const { allowlist, blocklist } = window.ET_Builder.Preboot.scripts;
    const { nodeName, innerHTML, src, className } = node;

    if (nodeName !== &#039;SCRIPT&#039;) {
      return false;
    }

    if (className) {
      return blocklist.className.test(className);
    }

    if (innerHTML) {
      // Allowlist has precendence over blocklist
      return !allowlist.innerHTML.test(innerHTML) &amp;&amp; blocklist.innerHTML.test(innerHTML);
    }

    return blocklist.src.test(src);
  },

  isScriptTopOnly(node) {
    const { topOnly } = window.ET_Builder.Preboot.scripts;
    const { nodeName, src } = node;

    if (nodeName !== &#039;SCRIPT&#039;) {
      return false;
    }

    return topOnly.src.test(src);
  },

  /**
   * Whether an element should be excluded from the app window (iframe) and top window.
   *
   * Different with isScriptExcluded() that has very specific checks on `SCRIPT`, this
   * method can be used to target more general HTML elements such as `LINK`, `STYLE`,
   * `DIV`, etc.
   *
   * @since 4.9.3
   *
   * @param {HTMLElement} node
   * @param {boolean}     checkBuilderType
   *
   * @return {boolean}
   */
  isElementExcluded(node, checkBuilderType = false) {
    const isBFB = get(window, &#039;et_fb_preboot.is_BFB&#039;, false);
    const isTB  = get(window, &#039;et_fb_preboot.is_TB&#039;, false);
    const isVB  = ! isBFB &amp;&amp; ! isTB;

    const blocklist       = get(window, &#039;window.ET_Builder.Preboot.elements.blocklist&#039;, {});
    const iframeBlocklist = get(window, &#039;window.ET_Builder.Preboot.elements.iframeBlocklist&#039;, {});

    const { className } = node;

    if (className) {
      // Iframe&#039;s blocked list elements should be checked only on iframe window. We
      // shouldn&#039;t check it when this method is being used to watch DOM change on
      // top/parent/original window. In this case, it&#039;s VB.
      const checkIframe          = checkBuilderType ? ! isVB : true;
      const isClassBlocked       = blocklist.className ? blocklist.className.test(className) : false;
      const isClassIframeBlocked = checkIframe &amp;&amp; iframeBlocklist.className ? iframeBlocklist.className.test(className) : false;
      return isClassBlocked || isClassIframeBlocked;
    }

    return false;
  },

  /**
   * Check if the given element contains the target descendant element
   *
   * @param {HTMLElement} element
   * @param {HTMLElement} target
   *
   * @return {boolean}
   */
  doesDomElementContain(element, target) {
    let node = target;

    while (node) {
      if (node === element) {
        return true;
      }

      node = node.parentNode;
    }

    return false;
  },

  /**
   * Help to compose several React refs allowing to have multiple refs to a single element
   *
   * @param refs
   *
   * @return {function(...[*]=)}
   */
  composeRef(...refs) {
    return element =&gt; {
      refs.forEach(ref =&gt; {
        if (!ref) {
          return;
        }

        if (typeof ref === &#039;function&#039;) {
          ref(element);

          return;
        }

        ref.current = element;
      });
    };
  },

  validateRefType(props, propName, componentName, location, propFullName) {
    const propValue = props[propName];

    if (propValue === null) {
      return null;
    }

    if (propValue === undefined) {
      return new Error(`The prop \`${propFullName}\` is marked as required in \`${componentName}\`.`);
    }

    if (propValue.nodeType !== 1) {
      const className = propValue.constructor.name;
      return new Error(`Invalid prop \`${propFullName}\` of type \`${className}\` supplied to \`${componentName}\`, expected instance of \`HTMLElement\``);
    }

    return null;
  },
};

const {
  toString,
  decodeHtmlEntities,
  shouldComponentUpdate,
  isScriptExcluded,
  isScriptTopOnly,
  isElementExcluded,
  doesDomElementContain,
  composeRef,
  validateRefType,
} = Utils;

export {
  toString,
  decodeHtmlEntities,
  shouldComponentUpdate,
  isScriptExcluded,
  isScriptTopOnly,
  isElementExcluded,
  doesDomElementContain,
  composeRef,
  validateRefType,
}

export default Utils;
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2F.trash%2F9monarch%2Fcore%2Fui%2Futils'>⬅ Back to Directory</a>