Testing copy-to-clipboard interactions with Jest and Testing Library

Long ago, I was amazed by the release of yet another project by Zeno Rocha, one of the most impressive professionals I know. The project was called clipboard.js. Back then, the most common strategy for implementing any button that copied data to the clipboard was to use Flash, a technology that faded away with the advent of HTML 5.

Over the years that followed, the ease introduced by clipboard.js in using the clipboard led to the proliferation of Copy buttons all over the internet. Nowadays, selecting text and pressing Ctrl+C (or Cmd+C) feels uncomfortable when we need to copy any data presented on a website.

But how do you write tests for this interesting use case? Is it possible to access the data stored in the clipboard during automated testing? The answer to the second question is yes, and below, you will find the answer to the first one.

The API that exposes the clipboard to the browser is provided through the clipboard object found in window.navigator. When it comes to text specifically, there are two methods that can be used: writeText and readText. Below is a test for a use case where a button labeled as Copy stores the text passed to it in the clipboard:

it('should copy text to clipboard', async () => {
  const text = 'Anything'
  render(<CopyButton text={text}/>)
  userEvent.click(screen.getByRole('button', { name: 'Copy' }))
  await pause(10)
  const copiedText = await window.navigator.clipboard.readText()
  expect(copiedText).toEqual(text)
})

async function pause(delay){
  return await new Promise(resolve => setTimeout(resolve, delay))
}

Note that after clicking the Copy button, a brief pause is required. This is necessary because both the writeText and readText functions operate asynchronously. It's important to note that the tools used in this test were Jest v29 and React Testing Library (commonly referred to as RTL) v12.

Animation displaying the implementation of a Copy button written with React
React implementation of a Copy button

Are you curious to see how the implementation that makes this test pass would look? Access this playground and explore the possibilities offered by the Clipboard API right in your browser.