summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorFlorian Bruhin <me@the-compiler.org>2021-01-27 14:06:21 +0100
committerFlorian Bruhin <me@the-compiler.org>2021-01-27 14:06:21 +0100
commit7d8fd507924309227ebb6c11c3d32cb0b013d238 (patch)
treeefbc2f302b577b51ed59c8b8092908f843daba4d /doc
parentb0c812b239e000da384c04f716e8ec9f38ad870a (diff)
downloadqutebrowser-7d8fd507924309227ebb6c11c3d32cb0b013d238.tar.gz
qutebrowser-7d8fd507924309227ebb6c11c3d32cb0b013d238.zip
Add qt.workarounds.remove_service_workers setting
See #5656, #5634
Diffstat (limited to 'doc')
-rw-r--r--doc/changelog.asciidoc4
-rw-r--r--doc/help/settings.asciidoc11
2 files changed, 15 insertions, 0 deletions
diff --git a/doc/changelog.asciidoc b/doc/changelog.asciidoc
index 2b4011a20..21bd24412 100644
--- a/doc/changelog.asciidoc
+++ b/doc/changelog.asciidoc
@@ -94,6 +94,10 @@ Added
- New `:bookmark-list` command which lists all bookmarks/quickmarks. The
corresponding `qute://bookmarks` URL already existed since v0.8.0, but it was
never exposed as a command.
+- New `qt.workarounds.remove_service_workers` setting which can be used to
+ remove the "Service Workers" directory on every start. Usage of this option is
+ generally discouraged, except in situations where the underlying QtWebEngine bug
+ is a known cause for crashes.
- New userscripts:
* `kodi` to play videos in Kodi
* `qr` to generate a QR code of the current URL
diff --git a/doc/help/settings.asciidoc b/doc/help/settings.asciidoc
index 03b48c182..742b1ab49 100644
--- a/doc/help/settings.asciidoc
+++ b/doc/help/settings.asciidoc
@@ -282,6 +282,7 @@
|<<qt.highdpi,qt.highdpi>>|Turn on Qt HighDPI scaling.
|<<qt.low_end_device_mode,qt.low_end_device_mode>>|When to use Chromium's low-end device mode.
|<<qt.process_model,qt.process_model>>|Which Chromium process model to use.
+|<<qt.workarounds.remove_service_workers,qt.workarounds.remove_service_workers>>|Delete the QtWebEngine Service Worker directory on every start.
|<<scrolling.bar,scrolling.bar>>|When/how to show the scrollbar.
|<<scrolling.smooth,scrolling.smooth>>|Enable smooth scrolling for web pages.
|<<search.ignore_case,search.ignore_case>>|When to find text on a page case-insensitively.
@@ -3638,6 +3639,16 @@ Default: +pass:[process-per-site-instance]+
This setting is only available with the QtWebEngine backend.
+[[qt.workarounds.remove_service_workers]]
+=== qt.workarounds.remove_service_workers
+Delete the QtWebEngine Service Worker directory on every start.
+This workaround can help with certain crashes caused by an unknown QtWebEngine bug related to Service Workers. Those crashes happen seemingly immediately on Windows; after one hour of operation on other systems.
+Note however that enabling this option *can lead to data loss* on some pages (as Service Worker data isn't persisted) and will negatively impact start-up time.
+
+Type: <<types,Bool>>
+
+Default: +pass:[false]+
+
[[scrolling.bar]]
=== scrolling.bar
When/how to show the scrollbar.