Back to Content

ClipboardChangeEvent: changeId property

files/en-us/web/api/clipboardchangeevent/changeid/index.md

latest1.3 KB
Original Source

{{securecontext_header}}{{APIRef("Clipboard API")}}{{SeeCompatTable}}

The changeId read-only property of the {{domxref("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

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{domxref("ClipboardChangeEvent.types")}}
  • {{domxref("ClipboardChangeEvent")}}
  • {{domxref("ClipboardEvent")}}
  • Clipboard API