dt-utils / copy

Function: copy()

copy(text): Promise<boolean>

Defined in: copy/index.ts:46

A robust cross-browser clipboard utility function.

Parameters

text

string

The text content to copy

Returns

Promise<boolean>

Copy operation result

• Resolves to true if copy succeeds
• Resolves to false if copy fails

Description

This function provides a consistent and reliable way to copy text to the clipboard across different browsers. It leverages the modern Clipboard API when available, falling back to the execCommand('copy') method for legacy browsers.

Example

import { copy } from 'dt-utils';

// Simple copy
const text = "Hello, clipboard!";
const success = await copy(text);
console.log(success ? "Copied!" : "Copy failed");

// Copy with error handling
try {
  const text = "Sensitive data";
  if (await copy(text)) {
    showSuccessToast("Content copied!");
  } else {
    showErrorToast("Copy failed");
  }
} catch (error) {
  handleError(error);
}

// Copy in button click handler
button.addEventListener('click', async () => {
  const success = await copy('Click to copy text');
  button.textContent = success ? 'Copied!' : 'Try again';
  setTimeout(() => {
    button.textContent = 'Copy';
  }, 2000);
});