ClipboardChangeEvent

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The ClipboardChangeEvent interface of the Clipboard API represents events fired whenever the contents of the system clipboard are changed.

Event ClipboardChangeEvent

Constructor

ClipboardChangeEvent()

Creates a new ClipboardChangeEvent event with the given parameters.

Instance properties

Also inherits properties from its parent Event.

ClipboardChangeEvent.types Read only

An array of strings representing the mandatory data types available on the system clipboard when the event was fired.

ClipboardChangeEvent.changeId Read only

A 128-bit integer representing a unique identifier for this specific clipboard change operation.

Instance methods

No specific methods; inherits methods from its parent Event.

Examples

In this example, when the clipboard's contents are changed, the event listener logs the data types, change id, and the entire event object to the console. This is a ClipboardChangeEvent object of type clipboardchange.

js
navigator.clipboard.addEventListener("clipboardchange", (event) => {
  console.log(`MIME types: ${event.types}`);
  console.log(`ID: ${event.changeId}`);
  console.dir(event);
});

Specifications

Specification
Clipboard API and events
# clipboardchangeevent

Browser compatibility

See also