Sentry Logo Debug Microservices & Distributed Systems

Join my free newsletter

Level up your dev skills and career with curated tips, practical advice, and in-depth tech insights – all delivered straight to your inbox.

3 min read
Up to date

Trevor I. Lasn

Staff Software Engineer & Engineering Manager

navigator.clipboard - The New Asynchronous Clipboard API in JavaScript

Copy and paste text, images, and files using the new navigator.clipboard API

When I first encountered the new navigator.clipboard API, I was amazed by how simple it made copying and pasting in web applications. Gone were the days of hacky document.execCommand solutions.

In the past, we relied on document.execCommand("copy") to handle clipboard operations. This approach was synchronous and limited - it could only copy text from selected DOM elements. Plus, it didn’t work consistently across browsers.

The navigator.clipboard API solves these issues by providing asynchronous methods that work with various data types. It’s more secure too - browsers require explicit permission before allowing clipboard access.

Reading text works similarly:

Copying complex data like images or files:

Note that clipboard operations need permission and HTTPS in most browsers. Error handling is key since operations can fail if permission is denied or in restricted environments.

Browser Support Considerations

While clipboard API support is strong, it’s good practice to provide fallbacks:


When to Use navigator.clipboard API

The async clipboard API shines in several common scenarios:

  • Copy-to-clipboard buttons in documentation
  • Saving code snippets from editors
  • Moving rich content between applications
  • Handling image uploads via paste

The API’s permission model might seem like extra overhead, but it’s a worthwhile trade-off for security and reliability. Gone are the days of wrestling with text selection and synchronous clipboard operations.

Next time you need to implement clipboard functionality, reach for navigator.clipboard

Remember to add fallbacks for older browsers, and your users will thank you for the smooth experience.


Become a better engineer

Here are engineering resources I've personally vetted and use. They focus on skills you'll actually need to build and scale real projects - the kind of experience that gets you hired or promoted.

Many companies have a fixed annual stipend per engineer (e.g. $2,000) for use towards learning resources. If your company offers this stipend, you can forward them your invoices directly for reimbursement.


This article was originally published on https://www.trevorlasn.com/blog/javascript-navigator-clipboard. It was written by a human and polished using grammar tools for clarity.

Interested in a partnership? Shoot me an email at hi [at] trevorlasn.com with all relevant information.