@instructure/canvas-rce 5.14.1 → 5.15.0

package/es/rce/RCEWrapper.utils.js

@@ -0,0 +1,131 @@
+/*
+ * Copyright (C) 2025 - present Instructure, Inc.
+ *
+ * This file is part of Canvas.
+ *
+ * Canvas is free software: you can redistribute it and/or modify it under
+ * the terms of the GNU Affero General Public License as published by the Free
+ * Software Foundation, version 3 of the License.
+ *
+ * Canvas is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
+ * A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU Affero General Public License along
+ * with this program. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+import formatMessage from '../format-message';
+
+// standard: string of tinymce menu commands
+// e.g. 'instructure_links | inserttable instructure_media_embed | hr'
+// custom: a string of tinymce menu commands
+// returns: standard + custom with any duplicate commands removed from custom
+export function mergeMenuItems(standard, custom) {
+  let c = custom?.trim?.();
+  if (!c) return standard;
+  const s = new Set(standard.split(/[\s|]+/));
+  // remove any duplicates
+  const c_array = c.split(/\s+/).filter(m => !s.has(m));
+  c = c_array.join(' ').replace(/^\s*\|\s*/, '').replace(/\s*\|\s*$/, '');
+  return `${standard} | ${c}`;
+}
+
+// standard: the incoming tinymce menu object
+// custom: tinymce menu object to merge into standard
+// returns: the merged result by mutating incoming standard arg.
+// It will add commands to existing menus, or add a new menu
+// if the custom one does not exist
+export function mergeMenu(standard, custom) {
+  if (!custom) return standard;
+  Object.keys(custom).forEach(k => {
+    const curr_m = standard[k];
+    if (curr_m) {
+      curr_m.items = mergeMenuItems(curr_m.items, custom[k].items);
+    } else {
+      standard[k] = {
+        ...custom[k]
+      };
+    }
+  });
+  return standard;
+}
+
+// standard: incoming tinymce toolbar array
+// custom: tinymce toolbar array to merge into standard
+// returns: the merged result by mutating the incoming standard arg.
+// It will add commands to existing toolbars, or add a new toolbar
+// if the custom one does not exist
+export function mergeToolbar(standard, custom) {
+  if (!custom) return standard;
+  // merge given toolbar data into the default toolbar
+  custom.forEach(tb => {
+    const curr_tb = standard.find(t => tb.name && formatMessage(tb.name) === t.name);
+    if (curr_tb) {
+      curr_tb.items.splice(curr_tb.items.length, 0, ...tb.items);
+    } else {
+      standard.push(tb);
+    }
+  });
+  return standard;
+}
+
+// standard: incoming array of plugin names
+// custom: array of plugin names to merge
+// exclusions: array of plugins to remove
+// returns: the merged result, duplicates and exclusions removed
+export function mergePlugins(standard, custom = [], exclusions = []) {
+  const union = new Set(standard);
+  for (const c of custom) {
+    union.add(c);
+  }
+  for (const e of exclusions) {
+    union.delete(e);
+  }
+  return [...union];
+}
+export function focusToolbar(el) {
+  const $firstToolbarButton = el.querySelector('.tox-tbtn');
+  if ($firstToolbarButton) {
+    $firstToolbarButton.focus();
+  }
+}
+export function focusFirstMenuButton(el) {
+  const $firstMenu = el.querySelector('.tox-mbtn');
+  if ($firstMenu) {
+    $firstMenu.focus();
+  }
+}
+export function isElementWithinTable(node) {
+  let elem = node;
+  while (elem) {
+    if (elem.tagName === 'TABLE' || elem.tagName === 'TD' || elem.tagName === 'TH') {
+      return true;
+    }
+    elem = elem.parentElement;
+  }
+  return false;
+}
+
+// plugins is an array of strings
+// the convention is that plugins starting with '-',
+// i.e. a hyphen, are to be disabled in the RCE instance
+export function parsePluginsToExclude(plugins) {
+  return plugins.filter(plugin => plugin.length > 0 && plugin[0] === '-').map(pluginToIgnore => pluginToIgnore.slice(1));
+}
+
+// if a placeholder image shows up in autosaved content, we have to remove it
+// because the data url gets converted to a blob, which is not valid when restored.
+// besides, the placeholder is intended to be temporary while the file
+// is being uploaded
+export function patchAutosavedContent(content, asText = false) {
+  const temp = document.createElement('div');
+  temp.innerHTML = content;
+  temp.querySelectorAll('[data-placeholder-for]').forEach(placeholder => {
+    // @ts-expect-error
+    placeholder.parentElement.removeChild(placeholder);
+  });
+  if (asText) return temp.textContent;
+  return temp.innerHTML;
+}

package/es/rce/RCEWrapperProps.js

@@ -15,10 +15,12 @@
  * You should have received a copy of the GNU Affero General Public License along
  * with this program. If not, see <http://www.gnu.org/licenses/>.
  */
+
 import PropTypes from 'prop-types';
 import { trayPropTypes } from './plugins/shared/CanvasContentTray';
 import { RCEVariantValues } from './RCEVariants';
-import { PRETTY_HTML_EDITOR_VIEW, RAW_HTML_EDITOR_VIEW, WYSIWYG_VIEW } from './StatusBar'; // This file contains the prop types for the RCEWrapper component, so that types can be shared without having
+import { PRETTY_HTML_EDITOR_VIEW, RAW_HTML_EDITOR_VIEW, WYSIWYG_VIEW } from './StatusBar';
+// This file contains the prop types for the RCEWrapper component, so that types can be shared without having
 // to refactor RCEWrapper.js into typescript.
 
 export const toolbarPropType = PropTypes.arrayOf(PropTypes.shape({
@@ -34,7 +36,8 @@ export const toolbarPropType = PropTypes.arrayOf(PropTypes.shape({
   // registered with tinymce
   items: PropTypes.arrayOf(PropTypes.string).isRequired
 }));
-export const menuPropType = PropTypes.objectOf( // the key is the name of the menu item a plugin has
+export const menuPropType = PropTypes.objectOf(
+// the key is the name of the menu item a plugin has
 // registered with tinymce. If it does not exist in the
 // default menubar, it will be added.
 PropTypes.shape({
@@ -57,12 +60,13 @@ export const ltiToolsPropType = PropTypes.arrayOf(PropTypes.shape({
   height: PropTypes.number,
   width: PropTypes.number,
   use_tray: PropTypes.bool,
-  canvas_icon_class: PropTypes.oneOfType([PropTypes.string, // Sometimes this is an object with an icon_url. Not sure why, see MAT-1354
+  canvas_icon_class: PropTypes.oneOfType([PropTypes.string,
+  // Sometimes this is an object with an icon_url. Not sure why, see MAT-1354
   PropTypes.shape({
     icon_url: PropTypes.string
   }), PropTypes.any])
 }));
-export const editorOptionsPropType = PropTypes.shape({
+export const EditorOptionsPropType = PropTypes.shape({
   // height of the RCE.
   // if a number interpreted as pixels.
   // if a string as a CSS value.
@@ -100,7 +104,7 @@ export const rceWrapperPropTypes = {
   }),
   canvasOrigin: PropTypes.string,
   defaultContent: PropTypes.string,
-  editorOptions: editorOptionsPropType,
+  editorOptions: EditorOptionsPropType,
   handleUnmount: PropTypes.func,
   editorView: PropTypes.oneOf([WYSIWYG_VIEW, PRETTY_HTML_EDITOR_VIEW, RAW_HTML_EDITOR_VIEW]),
   renderKBShortcutModal: PropTypes.bool,

package/es/rce/RceHtmlEditor.js

@@ -1,3 +1,4 @@
+import _pt from "prop-types";
 /*
  * Copyright (C) 2020 - present Instructure, Inc.
  *
@@ -15,18 +16,14 @@
  * You should have received a copy of the GNU Affero General Public License along
  * with this program. If not, see <http://www.gnu.org/licenses/>.
  */
-import React, { useCallback, useEffect, useRef, useState } from 'react';
-import { func, string } from 'prop-types';
+import React, { useEffect, useState } from 'react';
 import formatMessage from '../format-message';
 import { SourceCodeEditor } from '@instructure/ui-source-code-editor';
 import beautify from 'js-beautify';
 const RceHtmlEditor = /*#__PURE__*/React.forwardRef((props, editorRef) => {
-  const [code, setCode] = useState(props.code);
+  const [_code, setCode] = useState(props.code);
   const label = formatMessage('html code editor');
   const [dir, setDir] = useState(getComputedStyle(document.body, null).direction);
-  useEffect(() => {
-    setCode(beautify.html(props.code)); // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
   useEffect(() => {
     // INSTUI sets the CodeEditor's surrounding label's
     // display inline-block so it doesn't fill the width
@@ -47,18 +44,20 @@ const RceHtmlEditor = /*#__PURE__*/React.forwardRef((props, editorRef) => {
         }
       `;
       document.head.appendChild(stylesheet);
-    } // odds are, this won't change the dir.
-
-
-    setDir(getComputedStyle(editorRef.current || document.body, null).direction);
+    }
+    // odds are, this won't change the dir.
+    if (editorRef && 'current' in editorRef) {
+      setDir(getComputedStyle(editorRef.current || document.body, null).direction);
+    }
   }, [dir, editorRef]);
-  const direction = ['ltr', 'rtl'].includes(dir) ? dir : 'ltr'; // setting height on the container keeps the RCE toolbar from jumping
+  const direction = ['ltr', 'rtl'].includes(dir) ? dir : 'ltr';
 
+  // setting height on the container keeps the RCE toolbar from jumping
   return /*#__PURE__*/React.createElement("div", {
     ref: editorRef,
     className: "RceHtmlEditor",
     style: {
-      height: props.height,
+      height: props.height || 'auto',
       overflow: 'hidden',
       textAlign: 'start'
     }
@@ -71,21 +70,20 @@ const RceHtmlEditor = /*#__PURE__*/React.forwardRef((props, editorRef) => {
     spellcheck: true,
     direction: direction,
     rtlMoveVisually: true,
-    height: props.height,
-    value: code,
+    height: props.height || 'auto',
+    defaultValue: beautify.html(props.code),
     onChange: value => {
       setCode(value);
-      props.onChange(value);
+      props.onChange?.(value);
     }
   }));
 });
 RceHtmlEditor.propTypes = {
-  code: string.isRequired,
-  height: string,
-  onChange: func
+  code: _pt.string.isRequired,
+  height: _pt.string,
+  onChange: _pt.func
 };
 RceHtmlEditor.defaultProps = {
-  height: 'auto',
   onChange: _value => {}
 };
 export default RceHtmlEditor;

package/es/rce/ResizeHandle.js

@@ -15,6 +15,7 @@
  * You should have received a copy of the GNU Affero General Public License along
  * with this program. If not, see <http://www.gnu.org/licenses/>.
  */
+
 import React, { useState } from 'react';
 import { func, string, number } from 'prop-types';
 import { DraggableCore } from 'react-draggable';
@@ -40,29 +41,22 @@ export default function ResizeHandle(props) {
       });
     }
   }
-
   function handleFocus(event) {
-    var _props$onFocus;
-
     setIsFocused(true);
-    (_props$onFocus = props.onFocus) === null || _props$onFocus === void 0 ? void 0 : _props$onFocus.call(props, event);
+    props.onFocus?.(event);
   }
-
   function handleBlur() {
     setIsFocused(false);
   }
-
   function handleDragStart(_e) {
     setDragging(true);
   }
-
   function handleDragStop(_e) {
     setDragging(false);
   }
-
-  const [dragging, setDragging] = useState(false); // tracking isFocused rather than leveraging instui Focusable
+  const [dragging, setDragging] = useState(false);
+  // tracking isFocused rather than leveraging instui Focusable
   // because Focusable doesn't detect whan ResizeHandle gets focus
-
   const [isFocused, setIsFocused] = useState(false);
   return /*#__PURE__*/React.createElement(View, {
     "aria-label": formatMessage('Drag handle. Use up and down arrows to resize'),

package/es/rce/RestoreAutoSaveModal.js

@@ -15,6 +15,7 @@
  * You should have received a copy of the GNU Affero General Public License along
  * with this program. If not, see <http://www.gnu.org/licenses/>.
  */
+
 import React, { useState } from 'react';
 import { bool, func, string } from 'prop-types';
 import { Alert } from '@instructure/ui-alerts';
@@ -26,9 +27,7 @@ import { View } from '@instructure/ui-view';
 import formatMessage from '../format-message';
 export default function RestoreAutoSaveModal(props) {
   const [previewExpanded, setPreviewExpanded] = useState(false);
-
   const toggleLabel = () => previewExpanded ? formatMessage('Click to hide preview') : formatMessage('Click to show preview');
-
   return /*#__PURE__*/React.createElement(Modal, {
     "data-testid": "RCE_RestoreAutoSaveModal",
     "data-mce-component": true,

package/es/rce/ShowOnFocusButton/index.js

@@ -30,32 +30,28 @@ const hideStyle = {
   left: '-9999px'
 };
 export default class ShowOnFocusButton extends Component {
-  constructor() {
-    super(...arguments);
+  constructor(...args) {
+    super(...args);
     this.state = {
       visible: false
     };
-
     this.handleFocus = () => {
       this.setState({
         visible: true
       });
     };
-
     this.handleBlur = () => {
       this.setState({
         visible: false
       });
     };
   }
-
   focus() {
     this.btnRef.focus();
     this.setState({
       visible: true
     });
   }
-
   renderButton() {
     return /*#__PURE__*/React.createElement(IconButton, {
       id: this.props.id,
@@ -74,14 +70,12 @@ export default class ShowOnFocusButton extends Component {
       withBorder: false
     }, this.props.children);
   }
-
   render() {
     return /*#__PURE__*/React.createElement("div", {
       "data-testid": "ShowOnFocusButton__wrapper",
       style: this.state.visible ? null : hideStyle
     }, this.renderButton());
   }
-
 }
 ShowOnFocusButton.propTypes = {
   children: oneOfType([node, func]).isRequired,

package/es/rce/StatusBar.js

@@ -15,6 +15,7 @@
  * You should have received a copy of the GNU Affero General Public License along
  * with this program. If not, see <http://www.gnu.org/licenses/>.
  */
+
 import React, { useEffect, useRef, useState } from 'react';
 import ReactDOM from 'react-dom';
 import { arrayOf, bool, func, number, oneOf, string } from 'prop-types';
@@ -34,9 +35,9 @@ import { FS_ENABLED } from '../util/fullscreenHelpers';
 import { AIWandSVG } from './plugins/shared/ai_tools';
 export const WYSIWYG_VIEW = 'WYSIWYG';
 export const PRETTY_HTML_EDITOR_VIEW = 'PRETTY';
-export const RAW_HTML_EDITOR_VIEW = 'RAW'; // I don't know why eslint is reporting this, the props are all used
+export const RAW_HTML_EDITOR_VIEW = 'RAW';
 
-/* eslint-disable react/no-unused-prop-types */
+// I don't know why eslint is reporting this, the props are all used
 
 StatusBar.propTypes = {
   id: string.isRequired,
@@ -65,24 +66,18 @@ StatusBar.defaultProps = {
   a11yErrorsCount: 0,
   disabledPlugins: []
 };
-/* eslint-enable react/no-unused-prop-types */
-// we use the array index because pathname may not be unique
 
-/* eslint-disable react/no-array-index-key */
+// we use the array index because pathname may not be unique
 
-function renderPathString(_ref) {
-  let {
-    path
-  } = _ref;
+function renderPathString({
+  path
+}) {
   return path.reduce((result, pathName, index) => {
-    return result.concat( /*#__PURE__*/React.createElement("span", {
+    return result.concat(/*#__PURE__*/React.createElement("span", {
       key: `${pathName}-${index}`
     }, /*#__PURE__*/React.createElement(Text, null, index > 0 ? /*#__PURE__*/React.createElement(IconMiniArrowEndLine, null) : null, pathName)));
   }, []);
 }
-/* eslint-enable react/no-array-index-key */
-
-
 function emptyTagIcon() {
   return /*#__PURE__*/React.createElement(SVGIcon, {
     viewBox: "0 0 24 24",
@@ -96,13 +91,11 @@ function emptyTagIcon() {
     fontSize: "16"
   }, "</>")));
 }
-
 function findFocusable(el) {
   // eslint-disable-next-line react/no-find-dom-node
   const element = ReactDOM.findDOMNode(el);
   return element ? Array.from(element.querySelectorAll('[tabindex]')) : [];
 }
-
 export default function StatusBar(props) {
   const [focusedBtnId, setFocusedBtnId] = useState(null);
   const [includeEdtrDesc, setIncludeEdtrDesc] = useState(false);
@@ -117,10 +110,9 @@ export default function StatusBar(props) {
     // move focus to the next button over.
     if (isHtmlView() && /rce-kbshortcut-btn|rce-a11y-btn/.test(focusedBtnId)) {
       setFocusedBtnId('rce-edit-btn');
-    } // adding a delay before including the HTML Editor description to wait the focus moves to the RCE
+    }
+    // adding a delay before including the HTML Editor description to wait the focus moves to the RCE
     // and prevent JAWS from reading the aria-describedby element when switching back to RCE view
-
-
     const timerid = setTimeout(() => {
       setIncludeEdtrDesc(!isHtmlView());
     }, 100);
@@ -130,26 +122,21 @@ export default function StatusBar(props) {
   function isAvailable(plugin) {
     return !props.disabledPlugins.includes(plugin);
   }
-
   function isFeature(feature_name) {
     return props.features.includes(feature_name);
   }
-
   function preferredHtmlEditor() {
     if (props.preferredHtmlEditor) return props.preferredHtmlEditor;
     return PRETTY_HTML_EDITOR_VIEW;
   }
-
   function getHtmlEditorView(event) {
     if (!event.shiftKey) return preferredHtmlEditor();
     return preferredHtmlEditor() === RAW_HTML_EDITOR_VIEW ? PRETTY_HTML_EDITOR_VIEW : RAW_HTML_EDITOR_VIEW;
   }
-
   function handleKey(event) {
     const buttons = findFocusable(statusBarRef.current).filter(b => !b.disabled);
     const focusedIndex = buttons.findIndex(b => b.getAttribute('data-btn-id') === focusedBtnId);
     let newFocusedIndex;
-
     if (event.keyCode === keycode.codes.right) {
       newFocusedIndex = (focusedIndex + 1) % buttons.length;
     } else if (event.keyCode === keycode.codes.left) {
@@ -157,20 +144,16 @@ export default function StatusBar(props) {
     } else {
       return;
     }
-
     buttons[newFocusedIndex].focus();
     setFocusedBtnId(buttons[newFocusedIndex].getAttribute('data-btn-id'));
   }
-
   function isHtmlView() {
     return props.editorView !== WYSIWYG_VIEW;
   }
-
   function tabIndexForBtn(itemId) {
     const tabindex = focusedBtnId === itemId ? 0 : -1;
     return tabindex;
   }
-
   function renderPath() {
     return /*#__PURE__*/React.createElement(View, {
       "data-testid": "whole-status-bar-path",
@@ -179,7 +162,6 @@ export default function StatusBar(props) {
       }
     }, renderPathString(props));
   }
-
   function renderA11yButton() {
     const a11y = formatMessage('Accessibility Checker');
     const a11yButtonId = 'rce-a11y-btn';
@@ -197,11 +179,9 @@ export default function StatusBar(props) {
       withBackground: false,
       withBorder: false
     }, /*#__PURE__*/React.createElement(IconA11yLine, null));
-
     if (props.a11yErrorsCount <= 0) {
       return button;
     }
-
     return /*#__PURE__*/React.createElement(InstUISettingsProvider, {
       theme: {
         componentOverrides: {
@@ -215,7 +195,6 @@ export default function StatusBar(props) {
       countUntil: 100
     }, button));
   }
-
   function renderHtmlEditorMessage() {
     const message = props.editorView === PRETTY_HTML_EDITOR_VIEW ? formatMessage('Sadly, the pretty HTML editor is not keyboard accessible. Access the raw HTML editor here.') : formatMessage('Access the pretty HTML editor');
     const label = props.editorView === PRETTY_HTML_EDITOR_VIEW ? formatMessage('Switch to raw HTML Editor') : formatMessage('Switch to pretty HTML Editor');
@@ -238,7 +217,6 @@ export default function StatusBar(props) {
       onFocus: () => setFocusedBtnId('rce-editormessage-btn')
     }, label));
   }
-
   function renderIconButtons() {
     if (isHtmlView()) return null;
     const ai_tools = isFeature('ai_tools');
@@ -257,7 +235,6 @@ export default function StatusBar(props) {
       tabIndex: tabIndexForBtn('rce-ai-btn'),
       onClick: event => {
         event.target.focus(); // FF doesn't focus buttons on click
-
         props.onAI();
       },
       onFocus: () => setFocusedBtnId('rce-ai-btn'),
@@ -279,7 +256,6 @@ export default function StatusBar(props) {
       tabIndex: tabIndexForBtn('rce-kbshortcut-btn'),
       onClick: event => {
         event.target.focus(); // FF doesn't focus buttons on click
-
         props.onKBShortcutModalOpen();
       },
       onFocus: () => setFocusedBtnId('rce-kbshortcut-btn'),
@@ -288,7 +264,6 @@ export default function StatusBar(props) {
       withBorder: false
     }, /*#__PURE__*/React.createElement(IconKeyboardShortcutsLine, null)), a11y_checker && !props.readOnly && isAvailable('ally_checker') && renderA11yButton());
   }
-
   function renderWordCount() {
     if (isHtmlView()) return null;
     const wordCount = formatMessage(`{count, plural,
@@ -312,17 +287,14 @@ export default function StatusBar(props) {
       title: formatMessage('View word and character counts')
     }, wordCount)));
   }
-
   function renderSection3(html_view, fullscreen, resize_handle) {
     return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement("div", {
       className: css(styles.separator)
     }), html_view && renderToggleHtml(), fullscreen && renderFullscreen(), resize_handle && renderResizeHandle());
   }
-
   function descMsg() {
     return preferredHtmlEditor() === RAW_HTML_EDITOR_VIEW ? formatMessage('Shift-O to open the pretty html editor.') : formatMessage('The pretty html editor is not keyboard accessible. Press Shift O to open the raw html editor.');
   }
-
   function renderToggleHtml() {
     const toggleToHtml = formatMessage('Switch to the html editor');
     const toggleToRich = formatMessage('Switch to the rich text editor');
@@ -358,16 +330,13 @@ export default function StatusBar(props) {
       id: "edit-button-desc"
     }, descMsg()));
   }
-
   function renderFullscreen() {
     if (props.readOnly) return null;
     if (!document[FS_ENABLED]) return null;
-
     if (props.editorView === RAW_HTML_EDITOR_VIEW && !('requestFullscreen' in document.body)) {
       // this is safari, which refuses to fullscreen a textarea
       return null;
     }
-
     const fullscreen = props.rceIsFullscreen ? formatMessage('Exit Fullscreen') : formatMessage('Fullscreen');
     return /*#__PURE__*/React.createElement(IconButton, {
       "data-btn-id": "rce-fullscreen-btn",
@@ -384,7 +353,6 @@ export default function StatusBar(props) {
       withBorder: false
     }, props.rceIsFullscreen ? /*#__PURE__*/React.createElement(IconExitFullScreenLine, null) : /*#__PURE__*/React.createElement(IconFullScreenLine, null));
   }
-
   function renderResizeHandle() {
     if (props.rceIsFullscreen) return null;
     return /*#__PURE__*/React.createElement(ResizeHandle, {
@@ -396,7 +364,6 @@ export default function StatusBar(props) {
       }
     });
   }
-
   const flexJustify = isHtmlView() ? 'end' : 'start';
   const html_view = isFeature('html_view') && isAvailable('instructure_html_view');
   const fullscreen = isFeature('fullscreen') && isAvailable('instructure_fullscreen');
@@ -406,7 +373,6 @@ export default function StatusBar(props) {
       componentOverrides: {
         IconButton: {
           secondaryGhostColor: 'rgb(34, 47, 62)' // to match tinymce's button color
-
         }
       }
     }

package/es/rce/alertHandler.js

@@ -28,19 +28,16 @@ export class AlertHandler {
       if (this.alertFunc == null) {
         throw new Error('Tried to alert without alertFunc being set first');
       }
-
       this.alertFunc(alert);
     };
-
     this.alertFunc = alertFunc;
   }
+
   /**
    * Calls the registered alertFunc assuming one has been set, otherwise
    * it throws.
    *
    * @memberof AlertHandler
    */
-
-
 }
 export default new AlertHandler();