sweetalert2 11.3.3 → 11.3.7

package/dist/sweetalert2.js

@@ -1,5 +1,5 @@
 /*!
-* sweetalert2 v11.3.3
+* sweetalert2 v11.3.7
 * Released under the MIT License.
 */
 (function (global, factory) {
@@ -27,27 +27,28 @@
   };
   /**
    * Capitalize the first letter of a string
-   * @param str
+   * @param {string} str
+   * @returns {string}
    */
 
   const capitalizeFirstLetter = str => str.charAt(0).toUpperCase() + str.slice(1);
   /**
-   * Convert NodeList to Array
-   * @param nodeList
+   * @param {NodeList | HTMLCollection | NamedNodeMap} nodeList
+   * @returns {array}
    */
 
   const toArray = nodeList => Array.prototype.slice.call(nodeList);
   /**
-   * Standardise console warnings
-   * @param message
+   * Standardize console warnings
+   * @param {string | array} message
    */
 
   const warn = message => {
     console.warn("".concat(consolePrefix, " ").concat(typeof message === 'object' ? message.join(' ') : message));
   };
   /**
-   * Standardise console errors
-   * @param message
+   * Standardize console errors
+   * @param {string} message
    */
 
   const error = message => {
@@ -62,7 +63,7 @@
   const previousWarnOnceMessages = [];
   /**
    * Show a console warning, but only if it hasn't already been shown
-   * @param message
+   * @param {string} message
    */
 
   const warnOnce = message => {
@@ -296,12 +297,12 @@
   const getFocusableElements = () => {
     const focusableElementsWithTabindex = toArray(getPopup().querySelectorAll('[tabindex]:not([tabindex="-1"]):not([tabindex="0"])')) // sort according to tabindex
     .sort((a, b) => {
-      a = parseInt(a.getAttribute('tabindex'));
-      b = parseInt(b.getAttribute('tabindex'));
+      const tabindexA = parseInt(a.getAttribute('tabindex'));
+      const tabindexB = parseInt(b.getAttribute('tabindex'));
 
-      if (a > b) {
+      if (tabindexA > tabindexB) {
         return 1;
-      } else if (a < b) {
+      } else if (tabindexA < tabindexB) {
         return -1;
       }
 
@@ -569,7 +570,11 @@
     timerProgressBar.style.width = "".concat(timerProgressBarPercent, "%");
   };
 
-  // Detect Node env
+  /**
+   * Detect Node env
+   *
+   * @returns {boolean}
+   */
   const isNodeEnv = () => typeof window === 'undefined' || typeof document === 'undefined';
 
   const RESTORE_FOCUS_TIMEOUT = 100;
@@ -694,22 +699,34 @@
     addInputChangeListeners();
   };
 
+  /**
+   * @param {HTMLElement | object | string} param
+   * @param {HTMLElement} target
+   */
+
   const parseHtmlToContainer = (param, target) => {
     // DOM element
     if (param instanceof HTMLElement) {
-      target.appendChild(param); // Object
-    } else if (typeof param === 'object') {
-      handleObject(param, target); // Plain string
-    } else if (param) {
+      target.appendChild(param);
+    } // Object
+    else if (typeof param === 'object') {
+      handleObject(param, target);
+    } // Plain string
+    else if (param) {
       setInnerHtml(target, param);
     }
   };
+  /**
+   * @param {object} param
+   * @param {HTMLElement} target
+   */
 
   const handleObject = (param, target) => {
     // JQuery element(s)
     if (param.jquery) {
-      handleJqueryElem(target, param); // For other objects use their string representation
-    } else {
+      handleJqueryElem(target, param);
+    } // For other objects use their string representation
+    else {
       setInnerHtml(target, param.toString());
     }
   };
@@ -737,8 +754,9 @@
     const testEl = document.createElement('div');
     const transEndEventNames = {
       WebkitAnimation: 'webkitAnimationEnd',
-      OAnimation: 'oAnimationEnd oanimationend',
-      animation: 'animationend'
+      // Chrome, Safari and Opera
+      animation: 'animationend' // Standard syntax
+
     };
 
     for (const i in transEndEventNames) {
@@ -1060,12 +1078,12 @@
     setInputPlaceholder(textarea, params);
     setInputLabel(textarea, textarea, params);
 
-    const getMargin = el => parseInt(window.getComputedStyle(el).marginLeft) + parseInt(window.getComputedStyle(el).marginRight);
+    const getMargin = el => parseInt(window.getComputedStyle(el).marginLeft) + parseInt(window.getComputedStyle(el).marginRight); // https://github.com/sweetalert2/sweetalert2/issues/2291
+
 
     setTimeout(() => {
-      // #2291
+      // https://github.com/sweetalert2/sweetalert2/issues/1699
       if ('MutationObserver' in window) {
-        // #1699
         const initialPopupWidth = parseInt(window.getComputedStyle(getPopup()).width);
 
         const textareaResizeHandler = () => {
@@ -1093,11 +1111,13 @@
 
     if (params.html) {
       parseHtmlToContainer(params.html, htmlContainer);
-      show(htmlContainer, 'block'); // Content as plain text
-    } else if (params.text) {
+      show(htmlContainer, 'block');
+    } // Content as plain text
+    else if (params.text) {
       htmlContainer.textContent = params.text;
-      show(htmlContainer, 'block'); // No content
-    } else {
+      show(htmlContainer, 'block');
+    } // No content
+    else {
       hide(htmlContainer);
     }
 
@@ -1164,13 +1184,13 @@
 
     setColor(icon, params); // Success icon background color
 
-    adjustSuccessIconBackgoundColor(); // Custom class
+    adjustSuccessIconBackgroundColor(); // Custom class
 
     applyCustomClass(icon, params, 'icon');
   }; // Adjust success icon background color to match the popup background color
 
 
-  const adjustSuccessIconBackgoundColor = () => {
+  const adjustSuccessIconBackgroundColor = () => {
     const popup = getPopup();
     const popupBackgroundColor = window.getComputedStyle(popup).getPropertyValue('background-color');
     const successIconParts = popup.querySelectorAll('[class^=swal2-success-circular-line], .swal2-success-fix');
@@ -1180,15 +1200,18 @@
     }
   };
 
+  const successIconHtml = "\n  <div class=\"swal2-success-circular-line-left\"></div>\n  <span class=\"swal2-success-line-tip\"></span> <span class=\"swal2-success-line-long\"></span>\n  <div class=\"swal2-success-ring\"></div> <div class=\"swal2-success-fix\"></div>\n  <div class=\"swal2-success-circular-line-right\"></div>\n";
+  const errorIconHtml = "\n  <span class=\"swal2-x-mark\">\n    <span class=\"swal2-x-mark-line-left\"></span>\n    <span class=\"swal2-x-mark-line-right\"></span>\n  </span>\n";
+
   const setContent = (icon, params) => {
     icon.textContent = '';
 
     if (params.iconHtml) {
       setInnerHtml(icon, iconContent(params.iconHtml));
     } else if (params.icon === 'success') {
-      setInnerHtml(icon, "\n      <div class=\"swal2-success-circular-line-left\"></div>\n      <span class=\"swal2-success-line-tip\"></span> <span class=\"swal2-success-line-long\"></span>\n      <div class=\"swal2-success-ring\"></div> <div class=\"swal2-success-fix\"></div>\n      <div class=\"swal2-success-circular-line-right\"></div>\n    ");
+      setInnerHtml(icon, successIconHtml);
     } else if (params.icon === 'error') {
-      setInnerHtml(icon, "\n      <span class=\"swal2-x-mark\">\n        <span class=\"swal2-x-mark-line-left\"></span>\n        <span class=\"swal2-x-mark-line-right\"></span>\n      </span>\n    ");
+      setInnerHtml(icon, errorIconHtml);
     } else {
       const defaultIconHtml = {
         question: '?',
@@ -1301,9 +1324,9 @@
   const renderPopup = (instance, params) => {
     const container = getContainer();
     const popup = getPopup(); // Width
+    // https://github.com/sweetalert2/sweetalert2/issues/2170
 
     if (params.toast) {
-      // #2170
       applyNumericalStyle(container, 'width', params.width);
       popup.style.width = '100%';
       popup.insertBefore(getLoader(), getIcon());
@@ -1414,32 +1437,39 @@
     if (!template) {
       return {};
     }
+    /** @type {DocumentFragment} */
+
 
     const templateContent = template.content;
     showWarningsForElements(templateContent);
     const result = Object.assign(getSwalParams(templateContent), getSwalButtons(templateContent), getSwalImage(templateContent), getSwalIcon(templateContent), getSwalInput(templateContent), getSwalStringParams(templateContent, swalStringParams));
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   */
 
   const getSwalParams = templateContent => {
     const result = {};
     toArray(templateContent.querySelectorAll('swal-param')).forEach(param => {
       showWarningsForAttributes(param, ['name', 'value']);
       const paramName = param.getAttribute('name');
-      let value = param.getAttribute('value');
+      const value = param.getAttribute('value');
 
       if (typeof defaultParams[paramName] === 'boolean' && value === 'false') {
-        value = false;
+        result[paramName] = false;
       }
 
       if (typeof defaultParams[paramName] === 'object') {
-        value = JSON.parse(value);
+        result[paramName] = JSON.parse(value);
       }
-
-      result[paramName] = value;
     });
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   */
+
 
   const getSwalButtons = templateContent => {
     const result = {};
@@ -1459,9 +1489,15 @@
     });
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   */
+
 
   const getSwalImage = templateContent => {
     const result = {};
+    /** @type {HTMLElement} */
+
     const image = templateContent.querySelector('swal-image');
 
     if (image) {
@@ -1486,9 +1522,15 @@
 
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   */
+
 
   const getSwalIcon = templateContent => {
     const result = {};
+    /** @type {HTMLElement} */
+
     const icon = templateContent.querySelector('swal-icon');
 
     if (icon) {
@@ -1507,9 +1549,15 @@
 
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   */
+
 
   const getSwalInput = templateContent => {
     const result = {};
+    /** @type {HTMLElement} */
+
     const input = templateContent.querySelector('swal-input');
 
     if (input) {
@@ -1543,12 +1591,19 @@
 
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   * @param {string[]} paramNames
+   */
+
 
   const getSwalStringParams = (templateContent, paramNames) => {
     const result = {};
 
     for (const i in paramNames) {
       const paramName = paramNames[i];
+      /** @type {HTMLElement} */
+
       const tag = templateContent.querySelector(paramName);
 
       if (tag) {
@@ -1559,10 +1614,14 @@
 
     return result;
   };
+  /**
+   * @param {DocumentFragment} templateContent
+   */
 
-  const showWarningsForElements = template => {
+
+  const showWarningsForElements = templateContent => {
     const allowedElements = swalStringParams.concat(['swal-param', 'swal-button', 'swal-image', 'swal-icon', 'swal-input', 'swal-input-option']);
-    toArray(template.children).forEach(el => {
+    toArray(templateContent.children).forEach(el => {
       const tagName = el.tagName.toLowerCase();
 
       if (allowedElements.indexOf(tagName) === -1) {
@@ -1570,6 +1629,11 @@
       }
     });
   };
+  /**
+   * @param {HTMLElement} el
+   * @param {string[]} allowedAttributes
+   */
+
 
   const showWarningsForAttributes = (el, allowedAttributes) => {
     toArray(el.attributes).forEach(attribute => {
@@ -1712,22 +1776,28 @@
   /* istanbul ignore file */
 
   const iOSfix = () => {
-    // @ts-ignore
-    const iOS = /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream || navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1;
+    const iOS = // @ts-ignore
+    /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream || navigator.platform === 'MacIntel' && navigator.maxTouchPoints > 1;
 
     if (iOS && !hasClass(document.body, swalClasses.iosfix)) {
       const offset = document.body.scrollTop;
       document.body.style.top = "".concat(offset * -1, "px");
       addClass(document.body, swalClasses.iosfix);
       lockBodyScroll();
-      addBottomPaddingForTallPopups(); // #1948
+      addBottomPaddingForTallPopups();
     }
   };
+  /**
+   * https://github.com/sweetalert2/sweetalert2/issues/1948
+   */
 
   const addBottomPaddingForTallPopups = () => {
-    const safari = !navigator.userAgent.match(/(CriOS|FxiOS|EdgiOS|YaBrowser|UCBrowser)/i);
+    const ua = navigator.userAgent;
+    const iOS = !!ua.match(/iPad/i) || !!ua.match(/iPhone/i);
+    const webkit = !!ua.match(/WebKit/i);
+    const iOSSafari = iOS && webkit && !ua.match(/CriOS/i);
 
-    if (safari) {
+    if (iOSSafari) {
       const bottomPanelHeight = 44;
 
       if (getPopup().scrollHeight > window.innerHeight - bottomPanelHeight) {
@@ -1735,9 +1805,12 @@
       }
     }
   };
+  /**
+   * https://github.com/sweetalert2/sweetalert2/issues/1246
+   */
+
 
   const lockBodyScroll = () => {
-    // #1246
     const container = getContainer();
     let preventTouchMove;
 
@@ -1757,7 +1830,7 @@
     const target = event.target;
     const container = getContainer();
 
-    if (isStylys(event) || isZoom(event)) {
+    if (isStylus(event) || isZoom(event)) {
       return false;
     }
 
@@ -1774,14 +1847,26 @@
 
     return false;
   };
+  /**
+   * https://github.com/sweetalert2/sweetalert2/issues/1786
+   *
+   * @param {*} event
+   * @returns {boolean}
+   */
+
 
-  const isStylys = event => {
-    // #1786
+  const isStylus = event => {
     return event.touches && event.touches.length && event.touches[0].touchType === 'stylus';
   };
+  /**
+   * https://github.com/sweetalert2/sweetalert2/issues/1891
+   *
+   * @param {TouchEvent} event
+   * @returns {boolean}
+   */
+
 
   const isZoom = event => {
-    // #1891
     return event.touches && event.touches.length > 1;
   };
 
@@ -1868,7 +1953,7 @@
   };
 
   const addClasses$1 = (container, popup, params) => {
-    addClass(container, params.showClass.backdrop); // the workaround with setting/unsetting opacity is needed for #2019 and 2059
+    addClass(container, params.showClass.backdrop); // this workaround with opacity is needed for https://github.com/sweetalert2/sweetalert2/issues/2059
 
     popup.style.setProperty('opacity', '0', 'important');
     show(popup, 'grid');
@@ -2134,6 +2219,11 @@
   /* 'confirm' | 'deny' */
   ) => {
     const innerParams = privateProps.innerParams.get(instance);
+
+    if (!innerParams.input) {
+      return error("The \"input\" parameter is needed to be set when using returnInputValueOn".concat(capitalizeFirstLetter(type)));
+    }
+
     const inputValue = getInputValue(instance, innerParams);
 
     if (innerParams.inputValidator) {
@@ -2176,7 +2266,7 @@
     }
 
     if (innerParams.preDeny) {
-      privateProps.awaitingPromise.set(instance || undefined, true); // Flagging the instance as awaiting a promise so it's own promise's reject/resolve methods doesnt get destroyed until the result from this preDeny's promise is received
+      privateProps.awaitingPromise.set(instance || undefined, true); // Flagging the instance as awaiting a promise so it's own promise's reject/resolve methods doesn't get destroyed until the result from this preDeny's promise is received
 
       const preDenyPromise = Promise.resolve().then(() => asPromise(innerParams.preDeny(value, innerParams.validationMessage)));
       preDenyPromise.then(preDenyValue => {
@@ -2217,7 +2307,7 @@
 
     if (innerParams.preConfirm) {
       instance.resetValidationMessage();
-      privateProps.awaitingPromise.set(instance || undefined, true); // Flagging the instance as awaiting a promise so it's own promise's reject/resolve methods doesnt get destroyed until the result from this preConfirm's promise is received
+      privateProps.awaitingPromise.set(instance || undefined, true); // Flagging the instance as awaiting a promise so it's own promise's reject/resolve methods doesn't get destroyed until the result from this preConfirm's promise is received
 
       const preConfirmPromise = Promise.resolve().then(() => asPromise(innerParams.preConfirm(value, innerParams.validationMessage)));
       preConfirmPromise.then(preConfirmValue => {
@@ -2388,19 +2478,22 @@
 
 
     if (e.key === 'Enter') {
-      handleEnter(instance, e, innerParams); // TAB
-    } else if (e.key === 'Tab') {
-      handleTab(e, innerParams); // ARROWS - switch focus between buttons
-    } else if ([...arrowKeysNextButton, ...arrowKeysPreviousButton].includes(e.key)) {
-      handleArrows(e.key); // ESC
-    } else if (e.key === 'Escape') {
+      handleEnter(instance, e, innerParams);
+    } // TAB
+    else if (e.key === 'Tab') {
+      handleTab(e, innerParams);
+    } // ARROWS - switch focus between buttons
+    else if ([...arrowKeysNextButton, ...arrowKeysPreviousButton].includes(e.key)) {
+      handleArrows(e.key);
+    } // ESC
+    else if (e.key === 'Escape') {
       handleEsc(e, innerParams, dismissWith);
     }
   };
 
   const handleEnter = (instance, e, innerParams) => {
-    // #720 #721
-    if (e.isComposing) {
+    // #2386 #720 #721
+    if (!callIfFunction(innerParams.allowEnterKey) || e.isComposing) {
       return;
     }
 
@@ -2424,13 +2517,13 @@
         btnIndex = i;
         break;
       }
-    }
+    } // Cycle to the next button
+
 
     if (!e.shiftKey) {
-      // Cycle to the next button
       setFocus(innerParams, btnIndex, 1);
-    } else {
-      // Cycle to the prev button
+    } // Cycle to the prev button
+    else {
       setFocus(innerParams, btnIndex, -1);
     }
 
@@ -2487,7 +2580,7 @@
   };
 
   function fire() {
-    const Swal = this;
+    const Swal = this; // eslint-disable-line @typescript-eslint/no-this-alias
 
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
@@ -2973,15 +3066,7 @@
       return warn("You're trying to update the closed or closing popup, that won't work. Use the update() method in preConfirm parameter or show a new popup.");
     }
 
-    const validUpdatableParams = {}; // assign valid params from `params` to `defaults`
-
-    Object.keys(params).forEach(param => {
-      if (isUpdatableParameter(param)) {
-        validUpdatableParams[param] = params[param];
-      } else {
-        warn("Invalid parameter to update: \"".concat(param, "\". Updatable params are listed here: https://github.com/sweetalert2/sweetalert2/blob/master/src/utils/params.js\n\nIf you think this parameter should be updatable, request it here: https://github.com/sweetalert2/sweetalert2/issues/new?template=02_feature_request.md"));
-      }
-    });
+    const validUpdatableParams = filterValidParams(params);
     const updatedParams = Object.assign({}, innerParams, validUpdatableParams);
     render(this, updatedParams);
     privateProps.innerParams.set(this, updatedParams);
@@ -2994,12 +3079,24 @@
     });
   }
 
+  const filterValidParams = params => {
+    const validUpdatableParams = {};
+    Object.keys(params).forEach(param => {
+      if (isUpdatableParameter(param)) {
+        validUpdatableParams[param] = params[param];
+      } else {
+        warn("Invalid parameter to update: \"".concat(param, "\". Updatable params are listed here: https://github.com/sweetalert2/sweetalert2/blob/master/src/utils/params.js\n\nIf you think this parameter should be updatable, request it here: https://github.com/sweetalert2/sweetalert2/issues/new?template=02_feature_request.md"));
+      }
+    });
+    return validUpdatableParams;
+  };
+
   function _destroy() {
     const domCache = privateProps.domCache.get(this);
     const innerParams = privateProps.innerParams.get(this);
 
     if (!innerParams) {
-      disposeWeakMaps(this); // The WeakMaps might have been partly destroyed, we must recall it to dispose any remaining weakmaps #2335
+      disposeWeakMaps(this); // The WeakMaps might have been partly destroyed, we must recall it to dispose any remaining WeakMaps #2335
 
       return; // This instance has already been destroyed
     } // Check if there is another Swal closing
@@ -3281,7 +3378,7 @@
     };
   });
   SweetAlert.DismissReason = DismissReason;
-  SweetAlert.version = '11.3.3';
+  SweetAlert.version = '11.3.7';
 
   const Swal = SweetAlert; // @ts-ignore