From 218a76d953df113cd7d05c11618eb10c3a65a610 Mon Sep 17 00:00:00 2001 From: Alicia Sykes <gh@d0h.co> Date: Sat, 28 May 2022 18:39:46 +0100 Subject: [PATCH] :memo: Adds copy to clipboard to troubleshooting guide (#681) --- docs/troubleshooting.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index b69d48e4..c23fc908 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -31,6 +31,7 @@ - [Fixing Widget CORS Errors](#widget-cors-errors) - [Weather Forecast Widget 401](#weather-forecast-widget-401) - [Font Awesome Icons not Displaying](#font-awesome-icons-not-displaying) +- [Copy to Clipboard not Working](#copy-to-clipboard-not-working) - [How-To Open Browser Console](#how-to-open-browser-console) - [Git Contributions not Displaying](#git-contributions-not-displaying) @@ -436,6 +437,17 @@ Finally, check the [browser console](#how-to-open-browser-console) for any error --- +## Copy to Clipboard not Working + +If the copy to clipboard feature (either under Config --> Export, or Item --> Copy URL) isn't functioning as expected, first check the browser console. If you see `TypeError: Cannot read properties of undefined (reading 'writeText')` then this feature is not supported by your browser. +The most common reason for this, is if you not running the app over HTTPS. Copying to the clipboard requires the app to be running in a secure origin / aka have valid HTTPS cert. You can read more about this [here](https://stackoverflow.com/a/71876238/979052). + +As a workaround, you could either: +- Highlight the text and copy / <kbd>Ctrl</kbd> + <kbd>C</kbd> +- Or setup SSL - [here's a guide](https://github.com/Lissy93/dashy/blob/master/docs/management.md#ssl-certificates) on doing so + +--- + ## How-To Open Browser Console When raising a bug, one crucial piece of info needed is the browser's console output. This will help the developer diagnose and fix the issue.