Function copyToClipboard

packages/react/src/lib/clipboard.ts:12–26

(text: string)

// Returns whether the copy succeeded, so callers only show their "copied"
// confirmation when the value actually reached the clipboard.
export async function copyToClipboard(text: string): Promise<boolean> {
  // Preferred path: the async Clipboard API (secure contexts).
  if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
    // oxlint-disable-next-line executor/no-try-catch-or-throw -- boundary: the Clipboard API rejects (permission denied, blur) and we recover via the legacy path
    try {
      await navigator.clipboard.writeText(text);
      return true;
    } catch {
      // Permission denied / document not focused — fall through to the legacy
      // path rather than failing the copy.
    }
  }

  return legacyCopy(text);
}

// Legacy fallback for non-secure origins (plain-HTTP self-host). Select the text
// via a document Range on a hidden node, then `execCommand("copy")`.