Skip to content
Permalink
Browse files
GUACAMOLE-559: Merge upgrade FAQ regarding async clipboard API.
  • Loading branch information
necouchman committed May 4, 2018
2 parents c8dc521 + 22ccad9 commit 22043e1c01a1808a3c95b87a901fee45737259ed
Showing 1 changed file with 14 additions and 10 deletions.
24 faq.md
@@ -118,16 +118,20 @@ Clipboard {#clipboard}
### Why don't you just use the clipboard directly instead of the box in the menu? {#local-clipboard}

Guacamole actually already attempts to do this leveraging the [Clipboard
API](https://www.w3.org/TR/clipboard-apis/) defined by the W3C. Browsers only
provide access to the clipboard under very strict circumstances, so these
attempts will fail unless the browser itself provides some means of explicitly
granting clipboard access.

IE10 and IE11 will both prompt the user to grant clipboard access, and there is
a [third-party extension for
Chrome](https://chrome.google.com/webstore/detail/clipboard-permission-mana/ipbhneeanpgkaleihlknhjiaamobkceh)
which provides similar functionality. Until a generic mechanism for granting
clipboard access exists across all browsers, these are really the only options.
API](https://www.w3.org/TR/clipboard-apis/) defined by the W3C, with support
for the asynchronous version of this API added via
[GUACAMOLE-559](https://issues.apache.org/jira/browse/GUACAMOLE-559). Browsers
vary in their level of support for this API, and some only provide access to
the clipboard under very strict circumstances.

The following browsers are known to support clipboard access:

* Google Chrome version 66 and later (via the [Asynchronous Clipboard API](https://www.w3.org/TR/clipboard-apis/#async-clipboard-api))
* Older versions of Google Chrome using the third-party [Clipboard Permission Manager extension](https://chrome.google.com/webstore/detail/clipboard-permission-mana/ipbhneeanpgkaleihlknhjiaamobkceh)
* IE10 and IE11 (via the older, synchronous version of the API)

This can be expected to change as the asynchronous version of the clipboard API
gains wider adoption.

### I see the browser has "copy" and "paste" events. Why don't you handle these events so clipboard works? {#copy-paste-events}

0 comments on commit 22043e1

Please sign in to comment.