Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Clipboard.writeText — zapis besedila v odložišče

Clipboard.writeText zapiše navadno besedilo v sistemsko odložišče. Operacija je asinhrona in zahteva varen kontekst ter dovoljenje brskalnika za zapisovanje.

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

Sintaksa

await navigator.clipboard.writeText(text);

Clipboard.writeText, klicana kot navigator.clipboard.writeText(text), nadomesti vsebino odložišča z navadnim besedilom, ne s HTML-jem. Vrne Promise, ki se po zapisu izpolni z vrednostjo undefined.

Potreben je varen kontekst in aktiven dokument, ki ima fokus. Metodo pokličite neposredno po kliku; aktivacija uporabnika ne zagotavlja dovoljenja. Zavrnitev lahko povzroči, da se promise zavrne z napako NotAllowedError.

Uporabljajte await in try...catch; uspeh sporočite šele, ko se promise izpolni. Preverite razpoložljivost API-ja v ciljnem brskalniku: Node 24 v repozitoriju ne potrjuje podpore v brskalnikih.

Primeri

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}`;
  }
});

Rezultat

Copied: CKTIS

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri