Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Clipboard.writeText — zápis textu do schránky

Clipboard.writeText zapisuje prostý text do systémové schránky. Operace je asynchronní a vyžaduje zabezpečený kontext a povolení prohlížeče k zápisu.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

await navigator.clipboard.writeText(text);

Clipboard.writeText, volaná jako navigator.clipboard.writeText(text), nahradí obsah schránky prostým textem, nikoli HTML. Vrací Promise, která se po zápisu splní hodnotou undefined.

Je vyžadován zabezpečený kontext a aktivní dokument, který má fokus. Metodu zavolejte přímo po kliknutí; aktivace uživatelem nezaručuje povolení. Zamítnutí může způsobit odmítnutí promise s chybou NotAllowedError.

Používejte await a try...catch; úspěch oznamte až po splnění promise. Ověřte dostupnost API v cílovém prohlížeči: Node 24 v repozitáři nepotvrzuje podporu v prohlížečích.

Příklady

const button = document.createElement('button');
button.type = 'button';
button.textContent = 'Copy CKTIS';
const status = document.createElement('p');
status.setAttribute('role', 'status');
document.body.append(button, status);

button.addEventListener('click', async () => {
  if (!window.isSecureContext ||
      typeof navigator.clipboard?.writeText !== 'function') {
    status.textContent = 'Unavailable';
    return;
  }

  try {
    await navigator.clipboard.writeText('CKTIS');
    status.textContent = 'Copied: CKTIS';
  } catch (error) {
    status.textContent = `Copy failed: ${error.name}`;
  }
});

Výsledek

Copied: CKTIS

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje