Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

Summary

The oncopy property returns the onCopy event handler code on the current element.

Syntax

element.oncopy = functionRef;

where functionRef is a function - often a name of a function declared elsewhere or a function expression. See JavaScript Reference:Functions for details.

Example

<!DOCTYPE html>
<html>
<head>
<title>oncopy event example</title>

<script>
function log(txt) {
    document.getElementById("log").appendChild(document.createTextNode(txt + "\n"));
}
</script>
</head>

<body>
<div oncopy="log('Copy blocked!'); return false;">Try copying this text!</div>

<h3>Log</h3>
<textarea rows="15" cols="80" id="log" readonly="true"></textarea>
</body>
</html>

This example prevents the text from being copied out of the browser window.

Notes

This event is sent when the user attempts to copy text.

Since Firefox 13, the preference dom.event.clipboardevents.enabled controls this feature. It defaults to true but can be disabled.

Specification

Not part of specification.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic support
Non-standard
Chrome ? Edge Full support YesFirefox Full support 3IE ? Opera ? Safari ? WebView Android ? Chrome Android ? Edge Mobile Full support YesFirefox Android Full support 4Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.

See also

Document Tags and Contributors

Last updated by: fscholz,