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

CKTIS / JavaScript

Clipboard.write — asynchrónny zápis do schránky

Clipboard.write zapisuje objekty ClipboardItem do systémovej schránky. Prijíma alternatívne reprezentácie MIME, ale vyžaduje zabezpečený kontext a povolenie prehliadača.

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

await navigator.clipboard.write([new ClipboardItem({ "text/plain": new Blob([text], { type: "text/plain" }) })]);

Clipboard.write, volaná ako navigator.clipboard.write(items), prijíma objekty ClipboardItem. Jedna položka môže obsahovať viacero reprezentácií MIME toho istého obsahu. Pre samotný text je jednoduchšia metóda writeText(text). Vrátený prísľub sa po zápise splní hodnotou undefined; odmietnutie prístupu môže spôsobiť NotAllowedError.

Ide o Web API, nie o súčasť ECMAScriptu; Node 24 nedokazuje podporu v prehliadačoch. Overte dostupnosť API a otestujte cieľové prehliadače. Použite zabezpečený kontext: HTTPS alebo dôveryhodný miestny pôvod, napríklad localhost. Samotné HTTPS nezaručuje zabezpečený kontext, ak je stránka vložená pod nezabezpečeného predka; skontrolujte window.isSecureContext.

Zápis vykonajte priamo po kliknutí v aktívnom dokumente a ošetrite chyby; pravidlá oprávnení sa v jednotlivých prehliadačoch líšia. Nezamieňajte si viacero reprezentácií s viacerými položkami: platforma môže zachovať iba prvú položku. Príklad prepíše schránku po zámernom kliknutí používateľa.

Príklady

<!doctype html>
<meta charset="utf-8">
<title>Clipboard.write</title>
<button id="copy" type="button">Copy: Hello, clipboard!</button>
<output id="status" aria-live="polite"></output>
<script>
const button = document.querySelector('#copy');
const status = document.querySelector('#status');

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

  try {
    const blob = new Blob(['Hello, clipboard!'], { type: 'text/plain' });
    const item = new ClipboardItem({ 'text/plain': blob });
    await navigator.clipboard.write([item]);
    status.textContent = 'Copied';
  } catch (error) {
    status.textContent = `Failed: ${error.name}`;
  }
});
</script>

Výsledok

The status is initially empty. After the user clicks the button, it displays `Copied` only if the clipboard write succeeds. If the context is insecure or the required API is unavailable, it displays `Unavailable`. If an error occurs while preparing or writing the clipboard item, it displays `Failed: ` followed by the error name.

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

Zdroje