Project Fission: Difference between revisions

fission is no longer a nightly experiment
(Adding a somewhat vulgarized summary)
(fission is no longer a nightly experiment)
 
(8 intermediate revisions by 5 users not shown)
Line 16: Line 16:


The Fission team is standing by, ready to answer your questions in the '''#fission:mozilla.org''' room on [https://chat.mozilla.org/#/room/#fission:mozilla.org Mozilla's Matrix server].
The Fission team is standing by, ready to answer your questions in the '''#fission:mozilla.org''' room on [https://chat.mozilla.org/#/room/#fission:mozilla.org Mozilla's Matrix server].
= Observing Fission =
In desktop Firefox, you may open '''about:processes''' to see the processes used by Firefox.


= Reporting Bugs =
= Reporting Bugs =
Line 23: Line 27:
* Fission meta {{bug|1451850}}
* Fission meta {{bug|1451850}}
* [https://bugzilla.mozilla.org/buglist.cgi?classification=Client%20Software&classification=Developer%20Infrastructure&classification=Components&classification=Server%20Software&classification=Other&f1=cf_fission_milestone&resolution=---&o1=anywordssubstr&query_format=advanced&v1=M4.1%2CM5%2CM6 All bugs blocking Fission Nightly]
* [https://bugzilla.mozilla.org/buglist.cgi?classification=Client%20Software&classification=Developer%20Infrastructure&classification=Components&classification=Server%20Software&classification=Other&f1=cf_fission_milestone&resolution=---&o1=anywordssubstr&query_format=advanced&v1=M4.1%2CM5%2CM6 All bugs blocking Fission Nightly]
= Known Issues =
* Some extensions might not work fully. But please file bugs if you find an extension that doesn't work!
* Cross-site iframes appear empty when printed.
* Cross-site iframes appear empty in screenshots.
* Documents with cross-site iframes cannot enter the BFCache.
* Session history is not tracked for cross-site iframes.
* Session restore occasionally fails to restore page state, such as page zoom, scroll offset, or form data.
* DevTools support for cross-site iframes with fission is incomplete ([https://wiki.mozilla.org/DevTools/Fission read more]).
* Attempting to debug extensions or workers from a non-fission window can cause crashes.
* Linux resource exhaustion issues with large tab counts, including:
** Excessive memory usage
** File descriptor exhaustion issues
** X11 connection exhaustion on Linux ({{bug|1635451}})


= Enabling Fission =
= Enabling Fission =
Line 43: Line 32:
[[File:Fission tab tooltip.png|thumb|A "[F]" in a loaded tab's tooltip indicates that Fission is enabled]]
[[File:Fission tab tooltip.png|thumb|A "[F]" in a loaded tab's tooltip indicates that Fission is enabled]]


Fission is still in active development, and can only be enabled in Firefox Nightly.
Fission was released to desktop [https://www.mozilla.org/firefox/95.0/releasenotes/ Firefox in version 95].


# In ''about:config'', set the '''"fission.autostart"''' and '''"gfx.webrender.all"''' prefs to '''"true"'''. DO NOT edit any other "fission.*" or "gfx.webrender.*" prefs.
# In ''about:config'', set the '''"fission.autostart"''' and '''"gfx.webrender.all"''' prefs to '''"true"'''. DO NOT edit any other "fission.*" or "gfx.webrender.*" prefs.
# Restart Nightly.


You can verify that Fission has been enabled by hovering over the current tab. If the tooltip contains a "[F]", Fission is enabled. Background tabs' tooltips might not have the "[F]" if they are not loaded yet.
You can verify that Fission has been enabled by hovering over the current tab. If the tooltip contains a "[F]", Fission is enabled. Background tabs' tooltips might not have the "[F]" if they are not loaded yet.
Line 52: Line 40:
=== Disabling Fission ===
=== Disabling Fission ===


[[File:New_non_fission_window3.png|thumb|Opening a new non-fission window]]
If you encounter an issue while using Fission, it can be useful to create a new profile in about:profiles and attempt to recreate the issue. This can be useful to determine if issues are Fission-specific. If you encounter an issue that only happens with Fission, please be sure to file a bug in Bugzilla about it as described above!
 
If you encounter an issue while using Fission, it is possible to open a non-fission window within the same browsing session using the "New Non-Fission Window" item in the hamburger menu. This can be useful to determine if issues are Fission-specific, or to work around fission-specific breakage.


To disable Fission, reset the "fission.autostart" pref back to "false" and restart Nightly.
To disable Fission, set the "fission.autostart" pref to "false" and restart Firefox.


= Sub-pages =
= Sub-pages =
6

edits