documentation/known-bugs.md

   1 # Known Bugs
   2
   3 Given that VimFx operates outside the bounds of what Mozilla supports, there
   4 are some things that VimFx doesn't play along with well. This page lists
   5 problems that affect VimFx when run on versions of Firefox we support
   6 (latest *Release* and *ESR* versions).
   7
   8 ## Responsive Design Mode
   9
  10 **Affected**: Firefox <= 78
  11 **Workaround**: `devtools.responsive.browserUI.enabled;true`
  12
  13 Launching the (old) Responsive Design Mode breaks VimFx for this tab. The only
  14 way to recover is to copy-paste the URL into a new tab.
  15
  16 The [new RDM] does not have this bug; it can be enabled by switching
  17 `devtools.responsive.browserUI.enabled` to `true` in `about:config` in Firefox
  18 78 ESR. There is no workaround for Firefox 68 ESR.
  19
  20 [new RDM]: https://mail.mozilla.org/pipermail/firefox-dev/2020-March/007397.html
  21
  22 ## Fission
  23
  24 **Affected**: Firefox >= 96
  25 **Workaround**: `fission.webContentIsolationStrategy;0`
  26
  27 With [Fission] enabled, VimFx can't inspect out-of-process iframes.
  28
  29 With Fission, sometimes called *Site Isolation*, VimFx cannot place hint markers
  30 or detect input elements inside iframes from a different domain to the top
  31 document. We will instead enter insert mode whenever such an iframe is active.
  32 Hit Escape or click outside the iframe to let VimFx re-gain control. Setting
  33 `fission.webContentIsolationStrategy` to `0` in `about:config` only disables the
  34 iframe part of Fission, but is available only since Firefox 94. Some Nightly
  35 installations were opted into Fission earlier; set `fission.autostart`
  36 to `false` if the main workaround is unavailable.
  37
  38 <!-- VimFx will probably never support Fission. Its architecture assumes that
  39 all elements can be interacted with from a single point. It would require
  40 revisiting 8a33140f and injecting a script into each frame and postMessage'ing
  41 them instead of directly accessing elements within them. -->
  42
  43 [Fission]: https://wiki.mozilla.org/Project_Fission
  44
  45 ## VimFx behaves broken after installation
  46
  47 **Affected**: all supported versions
  48 **Solution**: restart browser
  49
  50 For some as-of-yet undetermined reason, the addon sometimes breaks after
  51 installation (or upgrade)<!-- possibly Gecko internals changed and the
  52 BootstrapLoader is failing -->. Fastest way to restart Firefox is pressing
  53 `<c-s-j>` to open the browser console, then `<c-a-r>` to restart.