Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Clipboard — asynchrónny prístup k schránke

Clipboard sprístupňuje systémovú schránku prostredníctvom navigator.clipboard; operácie sú asynchrónne a podliehajú bezpečnostným obmedzeniam.

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

Syntax

navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>

Clipboard, dostupný cez navigator.clipboard, je rozhranie Web API, nie ECMAScriptu. readText() vracia text, writeText() zapisuje text; read() a write() pracujú s objektmi ClipboardItem. Metódy vracajú prísľuby.

Vyžaduje sa zabezpečený kontext a fokus dokumentu. Povolenia a aktivácia používateľom môžu obmedziť prístup; kliknutie nezaručuje úspech. Ošetrujte odmietnutia vrátane NotAllowedError. Overte dostupnosť funkcií; návrh W3C nezaručuje podporu v prehliadačoch a nedokazuje ju ani Node 24.

To sa líši od synchrónnych udalostí copy, cut a paste, ktoré používajú event.clipboardData. Schránka môže obsahovať tajné údaje: nečítajte ju bez vyžiadania. Príklad prepíše schránku až po kliknutí.

Príklady

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

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

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

Výsledok

On an allowed, successful click: Copied: CKTIS
Clipboard text: CKTIS

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje