Skip to content

Add comprehensive clipboardchange event API specification #239

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
johanneswilm merged 11 commits into from
Nov 24, 2025
Merged

Add comprehensive clipboardchange event API specification #239

johanneswilm merged 11 commits into from
Nov 24, 2025

Conversation

@roraja
Copy link
Contributor

@roraja roraja commented Jun 23, 2025 •
edited by pr-preview bot
Loading

Summary

This PR adds a complete specification for the clipboardchange event to the W3C Clipboard API specification, including the missing ClipboardChangeEventInit dictionary and enhanced documentation based on implementation experience and the Microsoft Edge explainer.

The bikeshed rendered version can be verified from here:
https://rohanraja.github.io/cr-clipboard/clipboardchange/spec/#clipboard-event-clipboardchange

Changes

Added ClipboardChangeEventInit Dictionary

  • New: ClipboardChangeEventInit dictionary with types sequence parameter
  • Documentation: Clear specification of available mandatory data types on system clipboard
  • Security: Explicit exclusion of custom data types to prevent fingerprinting

Enhanced ClipboardChangeEvent Interface

  • Improved: Detailed documentation for the types attribute behavior
  • Clarified: Event firing conditions and focus requirements
  • Added: Constructor steps algorithm following W3C specification patterns

Implementation Status

Related Documentation

Testing

The specification includes comprehensive examples that can be used for:

  • Web Platform Tests (WPTs) development
  • Cross-browser compatibility validation
  • Security and privacy testing scenarios

Security & Privacy Considerations

  • No permissions required: Event only exposes data types, not contents
  • Fingerprinting mitigation: Custom data types excluded from event payload
  • Focus-gated: Events only fire when document has focus
  • Privacy-preserving: No clipboard contents exposed in event

Contacts: roraja@microsoft.com, ragoulik@microsoft.com

Fixes #230

For normative changes, the following tasks have been completed:

  • Editing WG resolution on the proposed changes, with at least two implementers participating and not objecting:
    • WebKit
    • Chromium
    • Gecko

Preview | Diff

@roraja roraja marked this pull request as draft June 23, 2025 05:42
@roraja roraja marked this pull request as ready for review July 8, 2025 04:27
@roraja roraja added the Agenda+ label Aug 12, 2025
annevk
annevk reviewed Aug 14, 2025
View reviewed changes
zgroza
zgroza reviewed Aug 20, 2025
View reviewed changes
utpathak
utpathak reviewed Aug 22, 2025
View reviewed changes
@beyondkmp beyondkmp mentioned this pull request Sep 3, 2025
Closed
4 tasks
annevk
annevk reviewed Sep 10, 2025
View reviewed changes
@roraja roraja removed the Agenda+ label Sep 10, 2025
@zgroza zgroza mentioned this pull request Sep 11, 2025
Closed
zgroza
zgroza reviewed Sep 29, 2025
View reviewed changes
@roraja roraja requested a review from annevk October 8, 2025 06:08
@roraja roraja mentioned this pull request Oct 14, 2025
Closed
@roraja roraja added the Agenda+ label Oct 22, 2025
@roraja roraja requested a review from smaug---- October 23, 2025 16:39
@johanneswilm johanneswilm mentioned this pull request Nov 6, 2025
Closed
@roraja roraja changed the title Add comprehensive clipboardchange event specification with ClipboardChangeEventInit dictionary Add comprehensive clipboardchange event API specification Nov 14, 2025
@roraja roraja requested a review from johanneswilm November 14, 2025 02:36
@johanneswilm johanneswilm merged commit ab5f530 into w3c:main Nov 24, 2025
2 checks passed
github-actions bot added a commit that referenced this pull request Nov 24, 2025
@roraja @github-actions
Add comprehensive clipboardchange event API specification (#239)
4cf7930 
SHA: ab5f530
Reason: push, by johanneswilm

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
github-actions bot added a commit to dizzydaizy/clipboard-apis that referenced this pull request Nov 24, 2025
@roraja @github-actions
Add comprehensive clipboardchange event API specification (w3c#239)
8f6adf7 
SHA: ab5f530
Reason: push, by pull[bot]

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@zgroza zgroza linked an issue Dec 4, 2025 that may be closed by this pull request
Proposal: Identifying whether the clipboard has changed without re-reading it #232
Closed
@NAME-sovsec
Copy link

NAME-sovsec commented Dec 11, 2025

https://github.com/w3c/clipboard-apis/commit/efdccf07a0cc518b4faba4095a07b0a2e0f06c83.diff

@johanneswilm
Copy link

johanneswilm commented Dec 11, 2025

TPAC 2025:

Resolution is to include the feedback from Anne
And adopt the resolution

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@zgroza zgroza zgroza left review comments

@johanneswilm johanneswilm johanneswilm approved these changes

@annevk annevk Awaiting requested review from annevk

@smaug---- smaug---- Awaiting requested review from smaug----

+1 more reviewer

@utpathak utpathak utpathak left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

Agenda+

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Proposal: Identifying whether the clipboard has changed without re-reading it Add privacy considerations for the clipboardchange event

6 participants

@roraja @NAME-sovsec @johanneswilm @annevk @zgroza @utpathak