ClipboardChangeEvent: changeId property

Limited availability

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The changeId read-only property of the ClipboardChangeEvent interface returns an integer representing a unique identifier for this specific clipboard change operation.

The identifier is consistent across all windows and tabs with the same storage key for the same clipboard change, enabling applications to deduplicate events when multiple windows receive the same clipboard change notification.

Value

An integer. A cryptographically derived 128-bit integer that, after something is written to the clipboard, is guaranteed to yield a different value than it did before the write operation.

Examples

In this example, when the contents of the clipboard change, the event listener uses the ClipboardChangeEvent.changeId property to log to the console the unique ID representing the clipboard change operation that fired the event.

js
navigator.clipboard.addEventListener("clipboardchange", (event) => {
  console.log(event.changeId);
});

Specifications

Specification
Clipboard API and events
# dom-clipboardchangeevent-changeid

Browser compatibility

See also