focus-trap 6.5.0 → 6.7.0

package/dist/focus-trap.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"focus-trap.min.js","sources":["../index.js"],"sourcesContent":["import { tabbable, isFocusable } from 'tabbable';\n\nlet activeFocusDelay;\n\nconst activeFocusTraps = (function () {\n  const trapQueue = [];\n  return {\n    activateTrap(trap) {\n      if (trapQueue.length > 0) {\n        const activeTrap = trapQueue[trapQueue.length - 1];\n        if (activeTrap !== trap) {\n          activeTrap.pause();\n        }\n      }\n\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex === -1) {\n        trapQueue.push(trap);\n      } else {\n        // move this existing trap to the front of the queue\n        trapQueue.splice(trapIndex, 1);\n        trapQueue.push(trap);\n      }\n    },\n\n    deactivateTrap(trap) {\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex !== -1) {\n        trapQueue.splice(trapIndex, 1);\n      }\n\n      if (trapQueue.length > 0) {\n        trapQueue[trapQueue.length - 1].unpause();\n      }\n    },\n  };\n})();\n\nconst isSelectableInput = function (node) {\n  return (\n    node.tagName &&\n    node.tagName.toLowerCase() === 'input' &&\n    typeof node.select === 'function'\n  );\n};\n\nconst isEscapeEvent = function (e) {\n  return e.key === 'Escape' || e.key === 'Esc' || e.keyCode === 27;\n};\n\nconst isTabEvent = function (e) {\n  return e.key === 'Tab' || e.keyCode === 9;\n};\n\nconst delay = function (fn) {\n  return setTimeout(fn, 0);\n};\n\n// Array.find/findIndex() are not supported on IE; this replicates enough\n//  of Array.findIndex() for our needs\nconst findIndex = function (arr, fn) {\n  let idx = -1;\n\n  arr.every(function (value, i) {\n    if (fn(value)) {\n      idx = i;\n      return false; // break\n    }\n\n    return true; // next\n  });\n\n  return idx;\n};\n\n/**\n * Get an option's value when it could be a plain value, or a handler that provides\n *  the value.\n * @param {*} value Option's value to check.\n * @param {...*} [params] Any parameters to pass to the handler, if `value` is a function.\n * @returns {*} The `value`, or the handler's returned value.\n */\nconst valueOrHandler = function (value, ...params) {\n  return typeof value === 'function' ? value(...params) : value;\n};\n\nconst createFocusTrap = function (elements, userOptions) {\n  const doc = document;\n\n  const config = {\n    returnFocusOnDeactivate: true,\n    escapeDeactivates: true,\n    delayInitialFocus: true,\n    ...userOptions,\n  };\n\n  const state = {\n    // @type {Array<HTMLElement>}\n    containers: [],\n\n    // list of objects identifying the first and last tabbable nodes in all containers/groups in\n    //  the trap\n    // NOTE: it's possible that a group has no tabbable nodes if nodes get removed while the trap\n    //  is active, but the trap should never get to a state where there isn't at least one group\n    //  with at least one tabbable node in it (that would lead to an error condition that would\n    //  result in an error being thrown)\n    // @type {Array<{ container: HTMLElement, firstTabbableNode: HTMLElement|null, lastTabbableNode: HTMLElement|null }>}\n    tabbableGroups: [],\n\n    nodeFocusedBeforeActivation: null,\n    mostRecentlyFocusedNode: null,\n    active: false,\n    paused: false,\n  };\n\n  let trap; // eslint-disable-line prefer-const -- some private functions reference it, and its methods reference private functions, so we must declare here and define later\n\n  const getOption = (configOverrideOptions, optionName, configOptionName) => {\n    return configOverrideOptions &&\n      configOverrideOptions[optionName] !== undefined\n      ? configOverrideOptions[optionName]\n      : config[configOptionName || optionName];\n  };\n\n  const containersContain = function (element) {\n    return state.containers.some((container) => container.contains(element));\n  };\n\n  const getNodeForOption = function (optionName) {\n    const optionValue = config[optionName];\n    if (!optionValue) {\n      return null;\n    }\n\n    let node = optionValue;\n\n    if (typeof optionValue === 'string') {\n      node = doc.querySelector(optionValue);\n      if (!node) {\n        throw new Error(`\\`${optionName}\\` refers to no known node`);\n      }\n    }\n\n    if (typeof optionValue === 'function') {\n      node = optionValue();\n      if (!node) {\n        throw new Error(`\\`${optionName}\\` did not return a node`);\n      }\n    }\n\n    return node;\n  };\n\n  const getInitialFocusNode = function () {\n    let node;\n\n    if (getNodeForOption('initialFocus') !== null) {\n      node = getNodeForOption('initialFocus');\n    } else if (containersContain(doc.activeElement)) {\n      node = doc.activeElement;\n    } else {\n      const firstTabbableGroup = state.tabbableGroups[0];\n      const firstTabbableNode =\n        firstTabbableGroup && firstTabbableGroup.firstTabbableNode;\n      node = firstTabbableNode || getNodeForOption('fallbackFocus');\n    }\n\n    if (!node) {\n      throw new Error(\n        'Your focus-trap needs to have at least one focusable element'\n      );\n    }\n\n    return node;\n  };\n\n  const updateTabbableNodes = function () {\n    state.tabbableGroups = state.containers\n      .map((container) => {\n        const tabbableNodes = tabbable(container);\n\n        if (tabbableNodes.length > 0) {\n          return {\n            container,\n            firstTabbableNode: tabbableNodes[0],\n            lastTabbableNode: tabbableNodes[tabbableNodes.length - 1],\n          };\n        }\n\n        return undefined;\n      })\n      .filter((group) => !!group); // remove groups with no tabbable nodes\n\n    // throw if no groups have tabbable nodes and we don't have a fallback focus node either\n    if (\n      state.tabbableGroups.length <= 0 &&\n      !getNodeForOption('fallbackFocus')\n    ) {\n      throw new Error(\n        'Your focus-trap must have at least one container with at least one tabbable node in it at all times'\n      );\n    }\n  };\n\n  const tryFocus = function (node) {\n    if (node === doc.activeElement) {\n      return;\n    }\n    if (!node || !node.focus) {\n      tryFocus(getInitialFocusNode());\n      return;\n    }\n\n    node.focus({ preventScroll: !!config.preventScroll });\n    state.mostRecentlyFocusedNode = node;\n\n    if (isSelectableInput(node)) {\n      node.select();\n    }\n  };\n\n  const getReturnFocusNode = function (previousActiveElement) {\n    const node = getNodeForOption('setReturnFocus');\n\n    return node ? node : previousActiveElement;\n  };\n\n  // This needs to be done on mousedown and touchstart instead of click\n  // so that it precedes the focus event.\n  const checkPointerDown = function (e) {\n    if (containersContain(e.target)) {\n      // allow the click since it ocurred inside the trap\n      return;\n    }\n\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      // immediately deactivate the trap\n      trap.deactivate({\n        // if, on deactivation, we should return focus to the node originally-focused\n        //  when the trap was activated (or the configured `setReturnFocus` node),\n        //  then assume it's also OK to return focus to the outside node that was\n        //  just clicked, causing deactivation, as long as that node is focusable;\n        //  if it isn't focusable, then return focus to the original node focused\n        //  on activation (or the configured `setReturnFocus` node)\n        // NOTE: by setting `returnFocus: false`, deactivate() will do nothing,\n        //  which will result in the outside click setting focus to the node\n        //  that was clicked, whether it's focusable or not; by setting\n        //  `returnFocus: true`, we'll attempt to re-focus the node originally-focused\n        //  on activation (or the configured `setReturnFocus` node)\n        returnFocus: config.returnFocusOnDeactivate && !isFocusable(e.target),\n      });\n      return;\n    }\n\n    // This is needed for mobile devices.\n    // (If we'll only let `click` events through,\n    // then on mobile they will be blocked anyways if `touchstart` is blocked.)\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      // allow the click outside the trap to take place\n      return;\n    }\n\n    // otherwise, prevent the click\n    e.preventDefault();\n  };\n\n  // In case focus escapes the trap for some strange reason, pull it back in.\n  const checkFocusIn = function (e) {\n    const targetContained = containersContain(e.target);\n    // In Firefox when you Tab out of an iframe the Document is briefly focused.\n    if (targetContained || e.target instanceof Document) {\n      if (targetContained) {\n        state.mostRecentlyFocusedNode = e.target;\n      }\n    } else {\n      // escaped! pull it back in to where it just left\n      e.stopImmediatePropagation();\n      tryFocus(state.mostRecentlyFocusedNode || getInitialFocusNode());\n    }\n  };\n\n  // Hijack Tab events on the first and last focusable nodes of the trap,\n  // in order to prevent focus from escaping. If it escapes for even a\n  // moment it can end up scrolling the page and causing confusion so we\n  // kind of need to capture the action at the keydown phase.\n  const checkTab = function (e) {\n    updateTabbableNodes();\n\n    let destinationNode = null;\n\n    if (state.tabbableGroups.length > 0) {\n      // make sure the target is actually contained in a group\n      // NOTE: the target may also be the container itself if it's tabbable\n      //  with tabIndex='-1' and was given initial focus\n      const containerIndex = findIndex(state.tabbableGroups, ({ container }) =>\n        container.contains(e.target)\n      );\n\n      if (containerIndex < 0) {\n        // target not found in any group: quite possible focus has escaped the trap,\n        //  so bring it back in to...\n        if (e.shiftKey) {\n          // ...the last node in the last group\n          destinationNode =\n            state.tabbableGroups[state.tabbableGroups.length - 1]\n              .lastTabbableNode;\n        } else {\n          // ...the first node in the first group\n          destinationNode = state.tabbableGroups[0].firstTabbableNode;\n        }\n      } else if (e.shiftKey) {\n        // REVERSE\n\n        // is the target the first tabbable node in a group?\n        let startOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ firstTabbableNode }) => e.target === firstTabbableNode\n        );\n\n        if (\n          startOfGroupIndex < 0 &&\n          state.tabbableGroups[containerIndex].container === e.target\n        ) {\n          // an exception case where the target is the container itself, in which\n          //  case, we should handle shift+tab as if focus were on the container's\n          //  first tabbable node, and go to the last tabbable node of the LAST group\n          startOfGroupIndex = containerIndex;\n        }\n\n        if (startOfGroupIndex >= 0) {\n          // YES: then shift+tab should go to the last tabbable node in the\n          //  previous group (and wrap around to the last tabbable node of\n          //  the LAST group if it's the first tabbable node of the FIRST group)\n          const destinationGroupIndex =\n            startOfGroupIndex === 0\n              ? state.tabbableGroups.length - 1\n              : startOfGroupIndex - 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.lastTabbableNode;\n        }\n      } else {\n        // FORWARD\n\n        // is the target the last tabbable node in a group?\n        let lastOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ lastTabbableNode }) => e.target === lastTabbableNode\n        );\n\n        if (\n          lastOfGroupIndex < 0 &&\n          state.tabbableGroups[containerIndex].container === e.target\n        ) {\n          // an exception case where the target is the container itself, in which\n          //  case, we should handle tab as if focus were on the container's\n          //  last tabbable node, and go to the first tabbable node of the FIRST group\n          lastOfGroupIndex = containerIndex;\n        }\n\n        if (lastOfGroupIndex >= 0) {\n          // YES: then tab should go to the first tabbable node in the next\n          //  group (and wrap around to the first tabbable node of the FIRST\n          //  group if it's the last tabbable node of the LAST group)\n          const destinationGroupIndex =\n            lastOfGroupIndex === state.tabbableGroups.length - 1\n              ? 0\n              : lastOfGroupIndex + 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.firstTabbableNode;\n        }\n      }\n    } else {\n      destinationNode = getNodeForOption('fallbackFocus');\n    }\n\n    if (destinationNode) {\n      e.preventDefault();\n      tryFocus(destinationNode);\n    }\n    // else, let the browser take care of [shift+]tab and move the focus\n  };\n\n  const checkKey = function (e) {\n    if (config.escapeDeactivates !== false && isEscapeEvent(e)) {\n      e.preventDefault();\n      trap.deactivate();\n      return;\n    }\n\n    if (isTabEvent(e)) {\n      checkTab(e);\n      return;\n    }\n  };\n\n  const checkClick = function (e) {\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      return;\n    }\n\n    if (containersContain(e.target)) {\n      return;\n    }\n\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      return;\n    }\n\n    e.preventDefault();\n    e.stopImmediatePropagation();\n  };\n\n  //\n  // EVENT LISTENERS\n  //\n\n  const addListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    // There can be only one listening focus trap at a time\n    activeFocusTraps.activateTrap(trap);\n\n    // Delay ensures that the focused element doesn't capture the event\n    // that caused the focus trap activation.\n    activeFocusDelay = config.delayInitialFocus\n      ? delay(function () {\n          tryFocus(getInitialFocusNode());\n        })\n      : tryFocus(getInitialFocusNode());\n\n    doc.addEventListener('focusin', checkFocusIn, true);\n    doc.addEventListener('mousedown', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('touchstart', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('click', checkClick, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('keydown', checkKey, {\n      capture: true,\n      passive: false,\n    });\n\n    return trap;\n  };\n\n  const removeListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    doc.removeEventListener('focusin', checkFocusIn, true);\n    doc.removeEventListener('mousedown', checkPointerDown, true);\n    doc.removeEventListener('touchstart', checkPointerDown, true);\n    doc.removeEventListener('click', checkClick, true);\n    doc.removeEventListener('keydown', checkKey, true);\n\n    return trap;\n  };\n\n  //\n  // TRAP DEFINITION\n  //\n\n  trap = {\n    activate(activateOptions) {\n      if (state.active) {\n        return this;\n      }\n\n      const onActivate = getOption(activateOptions, 'onActivate');\n      const onPostActivate = getOption(activateOptions, 'onPostActivate');\n      const checkCanFocusTrap = getOption(activateOptions, 'checkCanFocusTrap');\n\n      if (!checkCanFocusTrap) {\n        updateTabbableNodes();\n      }\n\n      state.active = true;\n      state.paused = false;\n      state.nodeFocusedBeforeActivation = doc.activeElement;\n\n      if (onActivate) {\n        onActivate();\n      }\n\n      const finishActivation = () => {\n        if (checkCanFocusTrap) {\n          updateTabbableNodes();\n        }\n        addListeners();\n        if (onPostActivate) {\n          onPostActivate();\n        }\n      };\n\n      if (checkCanFocusTrap) {\n        checkCanFocusTrap(state.containers.concat()).then(\n          finishActivation,\n          finishActivation\n        );\n        return this;\n      }\n\n      finishActivation();\n      return this;\n    },\n\n    deactivate(deactivateOptions) {\n      if (!state.active) {\n        return this;\n      }\n\n      clearTimeout(activeFocusDelay);\n\n      removeListeners();\n      state.active = false;\n      state.paused = false;\n\n      activeFocusTraps.deactivateTrap(trap);\n\n      const onDeactivate = getOption(deactivateOptions, 'onDeactivate');\n      const onPostDeactivate = getOption(deactivateOptions, 'onPostDeactivate');\n      const checkCanReturnFocus = getOption(\n        deactivateOptions,\n        'checkCanReturnFocus'\n      );\n\n      if (onDeactivate) {\n        onDeactivate();\n      }\n\n      const returnFocus = getOption(\n        deactivateOptions,\n        'returnFocus',\n        'returnFocusOnDeactivate'\n      );\n\n      const finishDeactivation = () => {\n        if (returnFocus) {\n          delay(() => {\n            tryFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation));\n            if (onPostDeactivate) {\n              onPostDeactivate();\n            }\n          });\n        }\n      };\n\n      if (returnFocus && checkCanReturnFocus) {\n        checkCanReturnFocus(\n          getReturnFocusNode(state.nodeFocusedBeforeActivation)\n        ).then(finishDeactivation, finishDeactivation);\n        return this;\n      }\n\n      finishDeactivation();\n      return this;\n    },\n\n    pause() {\n      if (state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = true;\n      removeListeners();\n\n      return this;\n    },\n\n    unpause() {\n      if (!state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = false;\n      updateTabbableNodes();\n      addListeners();\n\n      return this;\n    },\n\n    updateContainerElements(containerElements) {\n      const elementsAsArray = [].concat(containerElements).filter(Boolean);\n\n      state.containers = elementsAsArray.map((element) =>\n        typeof element === 'string' ? doc.querySelector(element) : element\n      );\n\n      if (state.active) {\n        updateTabbableNodes();\n      }\n\n      return this;\n    },\n  };\n\n  // initialize container elements\n  trap.updateContainerElements(elements);\n\n  return trap;\n};\n\nexport { createFocusTrap };\n"],"names":["activeFocusDelay","trapQueue","activeFocusTraps","activateTrap","trap","length","activeTrap","pause","trapIndex","indexOf","splice","push","deactivateTrap","unpause","delay","fn","setTimeout","findIndex","arr","idx","every","value","i","valueOrHandler","params","elements","userOptions","doc","document","config","returnFocusOnDeactivate","escapeDeactivates","delayInitialFocus","state","containers","tabbableGroups","nodeFocusedBeforeActivation","mostRecentlyFocusedNode","active","paused","getOption","configOverrideOptions","optionName","configOptionName","undefined","containersContain","element","some","container","contains","getNodeForOption","optionValue","node","querySelector","Error","getInitialFocusNode","activeElement","firstTabbableGroup","firstTabbableNode","updateTabbableNodes","map","tabbableNodes","tabbable","lastTabbableNode","filter","group","tryFocus","focus","preventScroll","tagName","toLowerCase","select","isSelectableInput","getReturnFocusNode","previousActiveElement","checkPointerDown","e","target","clickOutsideDeactivates","deactivate","returnFocus","isFocusable","allowOutsideClick","preventDefault","checkFocusIn","targetContained","Document","stopImmediatePropagation","checkKey","key","keyCode","isEscapeEvent","isTabEvent","destinationNode","containerIndex","shiftKey","startOfGroupIndex","destinationGroupIndex","lastOfGroupIndex","checkTab","checkClick","addListeners","addEventListener","capture","passive","removeListeners","removeEventListener","activate","activateOptions","this","onActivate","onPostActivate","checkCanFocusTrap","finishActivation","concat","then","deactivateOptions","clearTimeout","onDeactivate","onPostDeactivate","checkCanReturnFocus","finishDeactivation","updateContainerElements","containerElements","elementsAsArray","Boolean"],"mappings":"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"}
+{"version":3,"file":"focus-trap.min.js","sources":["../index.js"],"sourcesContent":["import { tabbable, isFocusable } from 'tabbable';\n\nconst activeFocusTraps = (function () {\n  const trapQueue = [];\n  return {\n    activateTrap(trap) {\n      if (trapQueue.length > 0) {\n        const activeTrap = trapQueue[trapQueue.length - 1];\n        if (activeTrap !== trap) {\n          activeTrap.pause();\n        }\n      }\n\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex === -1) {\n        trapQueue.push(trap);\n      } else {\n        // move this existing trap to the front of the queue\n        trapQueue.splice(trapIndex, 1);\n        trapQueue.push(trap);\n      }\n    },\n\n    deactivateTrap(trap) {\n      const trapIndex = trapQueue.indexOf(trap);\n      if (trapIndex !== -1) {\n        trapQueue.splice(trapIndex, 1);\n      }\n\n      if (trapQueue.length > 0) {\n        trapQueue[trapQueue.length - 1].unpause();\n      }\n    },\n  };\n})();\n\nconst isSelectableInput = function (node) {\n  return (\n    node.tagName &&\n    node.tagName.toLowerCase() === 'input' &&\n    typeof node.select === 'function'\n  );\n};\n\nconst isEscapeEvent = function (e) {\n  return e.key === 'Escape' || e.key === 'Esc' || e.keyCode === 27;\n};\n\nconst isTabEvent = function (e) {\n  return e.key === 'Tab' || e.keyCode === 9;\n};\n\nconst delay = function (fn) {\n  return setTimeout(fn, 0);\n};\n\n// Array.find/findIndex() are not supported on IE; this replicates enough\n//  of Array.findIndex() for our needs\nconst findIndex = function (arr, fn) {\n  let idx = -1;\n\n  arr.every(function (value, i) {\n    if (fn(value)) {\n      idx = i;\n      return false; // break\n    }\n\n    return true; // next\n  });\n\n  return idx;\n};\n\n/**\n * Get an option's value when it could be a plain value, or a handler that provides\n *  the value.\n * @param {*} value Option's value to check.\n * @param {...*} [params] Any parameters to pass to the handler, if `value` is a function.\n * @returns {*} The `value`, or the handler's returned value.\n */\nconst valueOrHandler = function (value, ...params) {\n  return typeof value === 'function' ? value(...params) : value;\n};\n\nconst getActualTarget = function (event) {\n  // NOTE: If the trap is _inside_ a shadow DOM, event.target will always be the\n  //  shadow host. However, event.target.composedPath() will be an array of\n  //  nodes \"clicked\" from inner-most (the actual element inside the shadow) to\n  //  outer-most (the host HTML document). If we have access to composedPath(),\n  //  then use its first element; otherwise, fall back to event.target (and\n  //  this only works for an _open_ shadow DOM; otherwise,\n  //  composedPath()[0] === event.target always).\n  return event.target.shadowRoot && typeof event.composedPath === 'function'\n    ? event.composedPath()[0]\n    : event.target;\n};\n\nconst createFocusTrap = function (elements, userOptions) {\n  const doc = userOptions.document || document;\n\n  const config = {\n    returnFocusOnDeactivate: true,\n    escapeDeactivates: true,\n    delayInitialFocus: true,\n    ...userOptions,\n  };\n\n  const state = {\n    // @type {Array<HTMLElement>}\n    containers: [],\n\n    // list of objects identifying the first and last tabbable nodes in all containers/groups in\n    //  the trap\n    // NOTE: it's possible that a group has no tabbable nodes if nodes get removed while the trap\n    //  is active, but the trap should never get to a state where there isn't at least one group\n    //  with at least one tabbable node in it (that would lead to an error condition that would\n    //  result in an error being thrown)\n    // @type {Array<{ container: HTMLElement, firstTabbableNode: HTMLElement|null, lastTabbableNode: HTMLElement|null }>}\n    tabbableGroups: [],\n\n    nodeFocusedBeforeActivation: null,\n    mostRecentlyFocusedNode: null,\n    active: false,\n    paused: false,\n\n    // timer ID for when delayInitialFocus is true and initial focus in this trap\n    //  has been delayed during activation\n    delayInitialFocusTimer: undefined,\n  };\n\n  let trap; // eslint-disable-line prefer-const -- some private functions reference it, and its methods reference private functions, so we must declare here and define later\n\n  const getOption = (configOverrideOptions, optionName, configOptionName) => {\n    return configOverrideOptions &&\n      configOverrideOptions[optionName] !== undefined\n      ? configOverrideOptions[optionName]\n      : config[configOptionName || optionName];\n  };\n\n  const containersContain = function (element) {\n    return !!(\n      element &&\n      state.containers.some((container) => container.contains(element))\n    );\n  };\n\n  /**\n   * Gets the node for the given option, which is expected to be an option that\n   *  can be either a DOM node, a string that is a selector to get a node, `false`\n   *  (if a node is explicitly NOT given), or a function that returns any of these\n   *  values.\n   * @param {string} optionName\n   * @returns {undefined | false | HTMLElement | SVGElement} Returns\n   *  `undefined` if the option is not specified; `false` if the option\n   *  resolved to `false` (node explicitly not given); otherwise, the resolved\n   *  DOM node.\n   * @throws {Error} If the option is set, not `false`, and is not, or does not\n   *  resolve to a node.\n   */\n  const getNodeForOption = function (optionName, ...params) {\n    let optionValue = config[optionName];\n\n    if (typeof optionValue === 'function') {\n      optionValue = optionValue(...params);\n    }\n\n    if (!optionValue) {\n      if (optionValue === undefined || optionValue === false) {\n        return optionValue;\n      }\n      // else, empty string (invalid), null (invalid), 0 (invalid)\n\n      throw new Error(\n        `\\`${optionName}\\` was specified but was not a node, or did not return a node`\n      );\n    }\n\n    let node = optionValue; // could be HTMLElement, SVGElement, or non-empty string at this point\n\n    if (typeof optionValue === 'string') {\n      node = doc.querySelector(optionValue); // resolve to node, or null if fails\n      if (!node) {\n        throw new Error(\n          `\\`${optionName}\\` as selector refers to no known node`\n        );\n      }\n    }\n\n    return node;\n  };\n\n  const getInitialFocusNode = function () {\n    let node = getNodeForOption('initialFocus');\n\n    // false explicitly indicates we want no initialFocus at all\n    if (node === false) {\n      return false;\n    }\n\n    if (node === undefined) {\n      // option not specified: use fallback options\n      if (containersContain(doc.activeElement)) {\n        node = doc.activeElement;\n      } else {\n        const firstTabbableGroup = state.tabbableGroups[0];\n        const firstTabbableNode =\n          firstTabbableGroup && firstTabbableGroup.firstTabbableNode;\n\n        // NOTE: `fallbackFocus` option function cannot return `false` (not supported)\n        node = firstTabbableNode || getNodeForOption('fallbackFocus');\n      }\n    }\n\n    if (!node) {\n      throw new Error(\n        'Your focus-trap needs to have at least one focusable element'\n      );\n    }\n\n    return node;\n  };\n\n  const updateTabbableNodes = function () {\n    state.tabbableGroups = state.containers\n      .map((container) => {\n        const tabbableNodes = tabbable(container);\n\n        if (tabbableNodes.length > 0) {\n          return {\n            container,\n            firstTabbableNode: tabbableNodes[0],\n            lastTabbableNode: tabbableNodes[tabbableNodes.length - 1],\n          };\n        }\n\n        return undefined;\n      })\n      .filter((group) => !!group); // remove groups with no tabbable nodes\n\n    // throw if no groups have tabbable nodes and we don't have a fallback focus node either\n    if (\n      state.tabbableGroups.length <= 0 &&\n      !getNodeForOption('fallbackFocus') // returning false not supported for this option\n    ) {\n      throw new Error(\n        'Your focus-trap must have at least one container with at least one tabbable node in it at all times'\n      );\n    }\n  };\n\n  const tryFocus = function (node) {\n    if (node === false) {\n      return;\n    }\n\n    if (node === doc.activeElement) {\n      return;\n    }\n\n    if (!node || !node.focus) {\n      tryFocus(getInitialFocusNode());\n      return;\n    }\n\n    node.focus({ preventScroll: !!config.preventScroll });\n    state.mostRecentlyFocusedNode = node;\n\n    if (isSelectableInput(node)) {\n      node.select();\n    }\n  };\n\n  const getReturnFocusNode = function (previousActiveElement) {\n    const node = getNodeForOption('setReturnFocus', previousActiveElement);\n    return node ? node : node === false ? false : previousActiveElement;\n  };\n\n  // This needs to be done on mousedown and touchstart instead of click\n  // so that it precedes the focus event.\n  const checkPointerDown = function (e) {\n    const target = getActualTarget(e);\n\n    if (containersContain(target)) {\n      // allow the click since it ocurred inside the trap\n      return;\n    }\n\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      // immediately deactivate the trap\n      trap.deactivate({\n        // if, on deactivation, we should return focus to the node originally-focused\n        //  when the trap was activated (or the configured `setReturnFocus` node),\n        //  then assume it's also OK to return focus to the outside node that was\n        //  just clicked, causing deactivation, as long as that node is focusable;\n        //  if it isn't focusable, then return focus to the original node focused\n        //  on activation (or the configured `setReturnFocus` node)\n        // NOTE: by setting `returnFocus: false`, deactivate() will do nothing,\n        //  which will result in the outside click setting focus to the node\n        //  that was clicked, whether it's focusable or not; by setting\n        //  `returnFocus: true`, we'll attempt to re-focus the node originally-focused\n        //  on activation (or the configured `setReturnFocus` node)\n        returnFocus: config.returnFocusOnDeactivate && !isFocusable(target),\n      });\n      return;\n    }\n\n    // This is needed for mobile devices.\n    // (If we'll only let `click` events through,\n    // then on mobile they will be blocked anyways if `touchstart` is blocked.)\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      // allow the click outside the trap to take place\n      return;\n    }\n\n    // otherwise, prevent the click\n    e.preventDefault();\n  };\n\n  // In case focus escapes the trap for some strange reason, pull it back in.\n  const checkFocusIn = function (e) {\n    const target = getActualTarget(e);\n    const targetContained = containersContain(target);\n\n    // In Firefox when you Tab out of an iframe the Document is briefly focused.\n    if (targetContained || target instanceof Document) {\n      if (targetContained) {\n        state.mostRecentlyFocusedNode = target;\n      }\n    } else {\n      // escaped! pull it back in to where it just left\n      e.stopImmediatePropagation();\n      tryFocus(state.mostRecentlyFocusedNode || getInitialFocusNode());\n    }\n  };\n\n  // Hijack Tab events on the first and last focusable nodes of the trap,\n  // in order to prevent focus from escaping. If it escapes for even a\n  // moment it can end up scrolling the page and causing confusion so we\n  // kind of need to capture the action at the keydown phase.\n  const checkTab = function (e) {\n    const target = getActualTarget(e);\n    updateTabbableNodes();\n\n    let destinationNode = null;\n\n    if (state.tabbableGroups.length > 0) {\n      // make sure the target is actually contained in a group\n      // NOTE: the target may also be the container itself if it's tabbable\n      //  with tabIndex='-1' and was given initial focus\n      const containerIndex = findIndex(state.tabbableGroups, ({ container }) =>\n        container.contains(target)\n      );\n\n      if (containerIndex < 0) {\n        // target not found in any group: quite possible focus has escaped the trap,\n        //  so bring it back in to...\n        if (e.shiftKey) {\n          // ...the last node in the last group\n          destinationNode =\n            state.tabbableGroups[state.tabbableGroups.length - 1]\n              .lastTabbableNode;\n        } else {\n          // ...the first node in the first group\n          destinationNode = state.tabbableGroups[0].firstTabbableNode;\n        }\n      } else if (e.shiftKey) {\n        // REVERSE\n\n        // is the target the first tabbable node in a group?\n        let startOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ firstTabbableNode }) => target === firstTabbableNode\n        );\n\n        if (\n          startOfGroupIndex < 0 &&\n          state.tabbableGroups[containerIndex].container === target\n        ) {\n          // an exception case where the target is the container itself, in which\n          //  case, we should handle shift+tab as if focus were on the container's\n          //  first tabbable node, and go to the last tabbable node of the LAST group\n          startOfGroupIndex = containerIndex;\n        }\n\n        if (startOfGroupIndex >= 0) {\n          // YES: then shift+tab should go to the last tabbable node in the\n          //  previous group (and wrap around to the last tabbable node of\n          //  the LAST group if it's the first tabbable node of the FIRST group)\n          const destinationGroupIndex =\n            startOfGroupIndex === 0\n              ? state.tabbableGroups.length - 1\n              : startOfGroupIndex - 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.lastTabbableNode;\n        }\n      } else {\n        // FORWARD\n\n        // is the target the last tabbable node in a group?\n        let lastOfGroupIndex = findIndex(\n          state.tabbableGroups,\n          ({ lastTabbableNode }) => target === lastTabbableNode\n        );\n\n        if (\n          lastOfGroupIndex < 0 &&\n          state.tabbableGroups[containerIndex].container === target\n        ) {\n          // an exception case where the target is the container itself, in which\n          //  case, we should handle tab as if focus were on the container's\n          //  last tabbable node, and go to the first tabbable node of the FIRST group\n          lastOfGroupIndex = containerIndex;\n        }\n\n        if (lastOfGroupIndex >= 0) {\n          // YES: then tab should go to the first tabbable node in the next\n          //  group (and wrap around to the first tabbable node of the FIRST\n          //  group if it's the last tabbable node of the LAST group)\n          const destinationGroupIndex =\n            lastOfGroupIndex === state.tabbableGroups.length - 1\n              ? 0\n              : lastOfGroupIndex + 1;\n\n          const destinationGroup = state.tabbableGroups[destinationGroupIndex];\n          destinationNode = destinationGroup.firstTabbableNode;\n        }\n      }\n    } else {\n      // NOTE: the fallbackFocus option does not support returning false to opt-out\n      destinationNode = getNodeForOption('fallbackFocus');\n    }\n\n    if (destinationNode) {\n      e.preventDefault();\n      tryFocus(destinationNode);\n    }\n    // else, let the browser take care of [shift+]tab and move the focus\n  };\n\n  const checkKey = function (e) {\n    if (\n      isEscapeEvent(e) &&\n      valueOrHandler(config.escapeDeactivates, e) !== false\n    ) {\n      e.preventDefault();\n      trap.deactivate();\n      return;\n    }\n\n    if (isTabEvent(e)) {\n      checkTab(e);\n      return;\n    }\n  };\n\n  const checkClick = function (e) {\n    if (valueOrHandler(config.clickOutsideDeactivates, e)) {\n      return;\n    }\n\n    const target = getActualTarget(e);\n\n    if (containersContain(target)) {\n      return;\n    }\n\n    if (valueOrHandler(config.allowOutsideClick, e)) {\n      return;\n    }\n\n    e.preventDefault();\n    e.stopImmediatePropagation();\n  };\n\n  //\n  // EVENT LISTENERS\n  //\n\n  const addListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    // There can be only one listening focus trap at a time\n    activeFocusTraps.activateTrap(trap);\n\n    // Delay ensures that the focused element doesn't capture the event\n    // that caused the focus trap activation.\n    state.delayInitialFocusTimer = config.delayInitialFocus\n      ? delay(function () {\n          tryFocus(getInitialFocusNode());\n        })\n      : tryFocus(getInitialFocusNode());\n\n    doc.addEventListener('focusin', checkFocusIn, true);\n    doc.addEventListener('mousedown', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('touchstart', checkPointerDown, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('click', checkClick, {\n      capture: true,\n      passive: false,\n    });\n    doc.addEventListener('keydown', checkKey, {\n      capture: true,\n      passive: false,\n    });\n\n    return trap;\n  };\n\n  const removeListeners = function () {\n    if (!state.active) {\n      return;\n    }\n\n    doc.removeEventListener('focusin', checkFocusIn, true);\n    doc.removeEventListener('mousedown', checkPointerDown, true);\n    doc.removeEventListener('touchstart', checkPointerDown, true);\n    doc.removeEventListener('click', checkClick, true);\n    doc.removeEventListener('keydown', checkKey, true);\n\n    return trap;\n  };\n\n  //\n  // TRAP DEFINITION\n  //\n\n  trap = {\n    activate(activateOptions) {\n      if (state.active) {\n        return this;\n      }\n\n      const onActivate = getOption(activateOptions, 'onActivate');\n      const onPostActivate = getOption(activateOptions, 'onPostActivate');\n      const checkCanFocusTrap = getOption(activateOptions, 'checkCanFocusTrap');\n\n      if (!checkCanFocusTrap) {\n        updateTabbableNodes();\n      }\n\n      state.active = true;\n      state.paused = false;\n      state.nodeFocusedBeforeActivation = doc.activeElement;\n\n      if (onActivate) {\n        onActivate();\n      }\n\n      const finishActivation = () => {\n        if (checkCanFocusTrap) {\n          updateTabbableNodes();\n        }\n        addListeners();\n        if (onPostActivate) {\n          onPostActivate();\n        }\n      };\n\n      if (checkCanFocusTrap) {\n        checkCanFocusTrap(state.containers.concat()).then(\n          finishActivation,\n          finishActivation\n        );\n        return this;\n      }\n\n      finishActivation();\n      return this;\n    },\n\n    deactivate(deactivateOptions) {\n      if (!state.active) {\n        return this;\n      }\n\n      clearTimeout(state.delayInitialFocusTimer); // noop if undefined\n      state.delayInitialFocusTimer = undefined;\n\n      removeListeners();\n      state.active = false;\n      state.paused = false;\n\n      activeFocusTraps.deactivateTrap(trap);\n\n      const onDeactivate = getOption(deactivateOptions, 'onDeactivate');\n      const onPostDeactivate = getOption(deactivateOptions, 'onPostDeactivate');\n      const checkCanReturnFocus = getOption(\n        deactivateOptions,\n        'checkCanReturnFocus'\n      );\n\n      if (onDeactivate) {\n        onDeactivate();\n      }\n\n      const returnFocus = getOption(\n        deactivateOptions,\n        'returnFocus',\n        'returnFocusOnDeactivate'\n      );\n\n      const finishDeactivation = () => {\n        delay(() => {\n          if (returnFocus) {\n            tryFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation));\n          }\n          if (onPostDeactivate) {\n            onPostDeactivate();\n          }\n        });\n      };\n\n      if (returnFocus && checkCanReturnFocus) {\n        checkCanReturnFocus(\n          getReturnFocusNode(state.nodeFocusedBeforeActivation)\n        ).then(finishDeactivation, finishDeactivation);\n        return this;\n      }\n\n      finishDeactivation();\n      return this;\n    },\n\n    pause() {\n      if (state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = true;\n      removeListeners();\n\n      return this;\n    },\n\n    unpause() {\n      if (!state.paused || !state.active) {\n        return this;\n      }\n\n      state.paused = false;\n      updateTabbableNodes();\n      addListeners();\n\n      return this;\n    },\n\n    updateContainerElements(containerElements) {\n      const elementsAsArray = [].concat(containerElements).filter(Boolean);\n\n      state.containers = elementsAsArray.map((element) =>\n        typeof element === 'string' ? doc.querySelector(element) : element\n      );\n\n      if (state.active) {\n        updateTabbableNodes();\n      }\n\n      return this;\n    },\n  };\n\n  // initialize container elements\n  trap.updateContainerElements(elements);\n\n  return trap;\n};\n\nexport { createFocusTrap };\n"],"names":["trapQueue","activeFocusTraps","activateTrap","trap","length","activeTrap","pause","trapIndex","indexOf","splice","push","deactivateTrap","unpause","delay","fn","setTimeout","findIndex","arr","idx","every","value","i","valueOrHandler","params","getActualTarget","event","target","shadowRoot","composedPath","elements","userOptions","doc","document","config","returnFocusOnDeactivate","escapeDeactivates","delayInitialFocus","state","containers","tabbableGroups","nodeFocusedBeforeActivation","mostRecentlyFocusedNode","active","paused","delayInitialFocusTimer","undefined","getOption","configOverrideOptions","optionName","configOptionName","containersContain","element","some","container","contains","getNodeForOption","optionValue","Error","node","querySelector","getInitialFocusNode","activeElement","firstTabbableGroup","firstTabbableNode","updateTabbableNodes","map","tabbableNodes","tabbable","lastTabbableNode","filter","group","tryFocus","focus","preventScroll","tagName","toLowerCase","select","isSelectableInput","getReturnFocusNode","previousActiveElement","checkPointerDown","e","clickOutsideDeactivates","deactivate","returnFocus","isFocusable","allowOutsideClick","preventDefault","checkFocusIn","targetContained","Document","stopImmediatePropagation","checkKey","key","keyCode","isEscapeEvent","isTabEvent","destinationNode","containerIndex","shiftKey","startOfGroupIndex","destinationGroupIndex","lastOfGroupIndex","checkTab","checkClick","addListeners","addEventListener","capture","passive","removeListeners","removeEventListener","activate","activateOptions","this","onActivate","onPostActivate","checkCanFocusTrap","finishActivation","concat","then","deactivateOptions","clearTimeout","onDeactivate","onPostDeactivate","checkCanReturnFocus","finishDeactivation","updateContainerElements","containerElements","elementsAsArray","Boolean"],"mappings":"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"}

package/dist/focus-trap.umd.js

@@ -1,5 +1,5 @@
 /*!
-* focus-trap 6.5.0
+* focus-trap 6.7.0
 * @license MIT, https://github.com/focus-trap/focus-trap/blob/master/LICENSE
 */
 (function (global, factory) {
@@ -10,8 +10,8 @@
     var exports = global.focusTrap = {};
     factory(exports, global.tabbable);
     exports.noConflict = function () { global.focusTrap = current; return exports; };
-  }()));
-}(this, (function (exports, tabbable) { 'use strict';
+  })());
+})(this, (function (exports, tabbable) { 'use strict';
 
   function ownKeys(object, enumerableOnly) {
     var keys = Object.keys(object);
@@ -66,8 +66,6 @@
     return obj;
   }
 
-  var activeFocusDelay;
-
   var activeFocusTraps = function () {
     var trapQueue = [];
     return {
@@ -151,8 +149,19 @@
     return typeof value === 'function' ? value.apply(void 0, params) : value;
   };
 
+  var getActualTarget = function getActualTarget(event) {
+    // NOTE: If the trap is _inside_ a shadow DOM, event.target will always be the
+    //  shadow host. However, event.target.composedPath() will be an array of
+    //  nodes "clicked" from inner-most (the actual element inside the shadow) to
+    //  outer-most (the host HTML document). If we have access to composedPath(),
+    //  then use its first element; otherwise, fall back to event.target (and
+    //  this only works for an _open_ shadow DOM; otherwise,
+    //  composedPath()[0] === event.target always).
+    return event.target.shadowRoot && typeof event.composedPath === 'function' ? event.composedPath()[0] : event.target;
+  };
+
   var createFocusTrap = function createFocusTrap(elements, userOptions) {
-    var doc = document;
+    var doc = userOptions.document || document;
 
     var config = _objectSpread2({
       returnFocusOnDeactivate: true,
@@ -174,7 +183,10 @@
       nodeFocusedBeforeActivation: null,
       mostRecentlyFocusedNode: null,
       active: false,
-      paused: false
+      paused: false,
+      // timer ID for when delayInitialFocus is true and initial focus in this trap
+      //  has been delayed during activation
+      delayInitialFocusTimer: undefined
     };
     var trap; // eslint-disable-line prefer-const -- some private functions reference it, and its methods reference private functions, so we must declare here and define later
 
@@ -183,33 +195,52 @@
     };
 
     var containersContain = function containersContain(element) {
-      return state.containers.some(function (container) {
+      return !!(element && state.containers.some(function (container) {
         return container.contains(element);
-      });
+      }));
     };
+    /**
+     * Gets the node for the given option, which is expected to be an option that
+     *  can be either a DOM node, a string that is a selector to get a node, `false`
+     *  (if a node is explicitly NOT given), or a function that returns any of these
+     *  values.
+     * @param {string} optionName
+     * @returns {undefined | false | HTMLElement | SVGElement} Returns
+     *  `undefined` if the option is not specified; `false` if the option
+     *  resolved to `false` (node explicitly not given); otherwise, the resolved
+     *  DOM node.
+     * @throws {Error} If the option is set, not `false`, and is not, or does not
+     *  resolve to a node.
+     */
+
 
     var getNodeForOption = function getNodeForOption(optionName) {
       var optionValue = config[optionName];
 
-      if (!optionValue) {
-        return null;
+      if (typeof optionValue === 'function') {
+        for (var _len2 = arguments.length, params = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++) {
+          params[_key2 - 1] = arguments[_key2];
+        }
+
+        optionValue = optionValue.apply(void 0, params);
       }
 
-      var node = optionValue;
+      if (!optionValue) {
+        if (optionValue === undefined || optionValue === false) {
+          return optionValue;
+        } // else, empty string (invalid), null (invalid), 0 (invalid)
 
-      if (typeof optionValue === 'string') {
-        node = doc.querySelector(optionValue);
 
-        if (!node) {
-          throw new Error("`".concat(optionName, "` refers to no known node"));
-        }
+        throw new Error("`".concat(optionName, "` was specified but was not a node, or did not return a node"));
       }
 
-      if (typeof optionValue === 'function') {
-        node = optionValue();
+      var node = optionValue; // could be HTMLElement, SVGElement, or non-empty string at this point
+
+      if (typeof optionValue === 'string') {
+        node = doc.querySelector(optionValue); // resolve to node, or null if fails
 
         if (!node) {
-          throw new Error("`".concat(optionName, "` did not return a node"));
+          throw new Error("`".concat(optionName, "` as selector refers to no known node"));
         }
       }
 
@@ -217,16 +248,22 @@
     };
 
     var getInitialFocusNode = function getInitialFocusNode() {
-      var node;
+      var node = getNodeForOption('initialFocus'); // false explicitly indicates we want no initialFocus at all
 
-      if (getNodeForOption('initialFocus') !== null) {
-        node = getNodeForOption('initialFocus');
-      } else if (containersContain(doc.activeElement)) {
-        node = doc.activeElement;
-      } else {
-        var firstTabbableGroup = state.tabbableGroups[0];
-        var firstTabbableNode = firstTabbableGroup && firstTabbableGroup.firstTabbableNode;
-        node = firstTabbableNode || getNodeForOption('fallbackFocus');
+      if (node === false) {
+        return false;
+      }
+
+      if (node === undefined) {
+        // option not specified: use fallback options
+        if (containersContain(doc.activeElement)) {
+          node = doc.activeElement;
+        } else {
+          var firstTabbableGroup = state.tabbableGroups[0];
+          var firstTabbableNode = firstTabbableGroup && firstTabbableGroup.firstTabbableNode; // NOTE: `fallbackFocus` option function cannot return `false` (not supported)
+
+          node = firstTabbableNode || getNodeForOption('fallbackFocus');
+        }
       }
 
       if (!node) {
@@ -254,12 +291,17 @@
       }); // remove groups with no tabbable nodes
       // throw if no groups have tabbable nodes and we don't have a fallback focus node either
 
-      if (state.tabbableGroups.length <= 0 && !getNodeForOption('fallbackFocus')) {
+      if (state.tabbableGroups.length <= 0 && !getNodeForOption('fallbackFocus') // returning false not supported for this option
+      ) {
         throw new Error('Your focus-trap must have at least one container with at least one tabbable node in it at all times');
       }
     };
 
     var tryFocus = function tryFocus(node) {
+      if (node === false) {
+        return;
+      }
+
       if (node === doc.activeElement) {
         return;
       }
@@ -280,14 +322,16 @@
     };
 
     var getReturnFocusNode = function getReturnFocusNode(previousActiveElement) {
-      var node = getNodeForOption('setReturnFocus');
-      return node ? node : previousActiveElement;
+      var node = getNodeForOption('setReturnFocus', previousActiveElement);
+      return node ? node : node === false ? false : previousActiveElement;
     }; // This needs to be done on mousedown and touchstart instead of click
     // so that it precedes the focus event.
 
 
     var checkPointerDown = function checkPointerDown(e) {
-      if (containersContain(e.target)) {
+      var target = getActualTarget(e);
+
+      if (containersContain(target)) {
         // allow the click since it ocurred inside the trap
         return;
       }
@@ -306,7 +350,7 @@
           //  that was clicked, whether it's focusable or not; by setting
           //  `returnFocus: true`, we'll attempt to re-focus the node originally-focused
           //  on activation (or the configured `setReturnFocus` node)
-          returnFocus: config.returnFocusOnDeactivate && !tabbable.isFocusable(e.target)
+          returnFocus: config.returnFocusOnDeactivate && !tabbable.isFocusable(target)
         });
         return;
       } // This is needed for mobile devices.
@@ -325,11 +369,12 @@
 
 
     var checkFocusIn = function checkFocusIn(e) {
-      var targetContained = containersContain(e.target); // In Firefox when you Tab out of an iframe the Document is briefly focused.
+      var target = getActualTarget(e);
+      var targetContained = containersContain(target); // In Firefox when you Tab out of an iframe the Document is briefly focused.
 
-      if (targetContained || e.target instanceof Document) {
+      if (targetContained || target instanceof Document) {
         if (targetContained) {
-          state.mostRecentlyFocusedNode = e.target;
+          state.mostRecentlyFocusedNode = target;
         }
       } else {
         // escaped! pull it back in to where it just left
@@ -343,6 +388,7 @@
 
 
     var checkTab = function checkTab(e) {
+      var target = getActualTarget(e);
       updateTabbableNodes();
       var destinationNode = null;
 
@@ -352,7 +398,7 @@
         //  with tabIndex='-1' and was given initial focus
         var containerIndex = findIndex(state.tabbableGroups, function (_ref) {
           var container = _ref.container;
-          return container.contains(e.target);
+          return container.contains(target);
         });
 
         if (containerIndex < 0) {
@@ -370,10 +416,10 @@
           // is the target the first tabbable node in a group?
           var startOfGroupIndex = findIndex(state.tabbableGroups, function (_ref2) {
             var firstTabbableNode = _ref2.firstTabbableNode;
-            return e.target === firstTabbableNode;
+            return target === firstTabbableNode;
           });
 
-          if (startOfGroupIndex < 0 && state.tabbableGroups[containerIndex].container === e.target) {
+          if (startOfGroupIndex < 0 && state.tabbableGroups[containerIndex].container === target) {
             // an exception case where the target is the container itself, in which
             //  case, we should handle shift+tab as if focus were on the container's
             //  first tabbable node, and go to the last tabbable node of the LAST group
@@ -393,10 +439,10 @@
           // is the target the last tabbable node in a group?
           var lastOfGroupIndex = findIndex(state.tabbableGroups, function (_ref3) {
             var lastTabbableNode = _ref3.lastTabbableNode;
-            return e.target === lastTabbableNode;
+            return target === lastTabbableNode;
           });
 
-          if (lastOfGroupIndex < 0 && state.tabbableGroups[containerIndex].container === e.target) {
+          if (lastOfGroupIndex < 0 && state.tabbableGroups[containerIndex].container === target) {
             // an exception case where the target is the container itself, in which
             //  case, we should handle tab as if focus were on the container's
             //  last tabbable node, and go to the first tabbable node of the FIRST group
@@ -414,6 +460,7 @@
           }
         }
       } else {
+        // NOTE: the fallbackFocus option does not support returning false to opt-out
         destinationNode = getNodeForOption('fallbackFocus');
       }
 
@@ -425,7 +472,7 @@
     };
 
     var checkKey = function checkKey(e) {
-      if (config.escapeDeactivates !== false && isEscapeEvent(e)) {
+      if (isEscapeEvent(e) && valueOrHandler(config.escapeDeactivates, e) !== false) {
         e.preventDefault();
         trap.deactivate();
         return;
@@ -442,7 +489,9 @@
         return;
       }
 
-      if (containersContain(e.target)) {
+      var target = getActualTarget(e);
+
+      if (containersContain(target)) {
         return;
       }
 
@@ -466,7 +515,7 @@
       activeFocusTraps.activateTrap(trap); // Delay ensures that the focused element doesn't capture the event
       // that caused the focus trap activation.
 
-      activeFocusDelay = config.delayInitialFocus ? delay(function () {
+      state.delayInitialFocusTimer = config.delayInitialFocus ? delay(function () {
         tryFocus(getInitialFocusNode());
       }) : tryFocus(getInitialFocusNode());
       doc.addEventListener('focusin', checkFocusIn, true);
@@ -552,7 +601,9 @@
           return this;
         }
 
-        clearTimeout(activeFocusDelay);
+        clearTimeout(state.delayInitialFocusTimer); // noop if undefined
+
+        state.delayInitialFocusTimer = undefined;
         removeListeners();
         state.active = false;
         state.paused = false;
@@ -568,15 +619,15 @@
         var returnFocus = getOption(deactivateOptions, 'returnFocus', 'returnFocusOnDeactivate');
 
         var finishDeactivation = function finishDeactivation() {
-          if (returnFocus) {
-            delay(function () {
+          delay(function () {
+            if (returnFocus) {
               tryFocus(getReturnFocusNode(state.nodeFocusedBeforeActivation));
+            }
 
-              if (onPostDeactivate) {
-                onPostDeactivate();
-              }
-            });
-          }
+            if (onPostDeactivate) {
+              onPostDeactivate();
+            }
+          });
         };
 
         if (returnFocus && checkCanReturnFocus) {
@@ -628,5 +679,5 @@
 
   Object.defineProperty(exports, '__esModule', { value: true });
 
-})));
+}));
 //# sourceMappingURL=focus-trap.umd.js.map