CKTIS / JavaScript
Clipboard — asinkroni pristup međuspremniku
Clipboard omogućuje pristup sistemskom međuspremniku putem navigator.clipboard; operacije su asinkrone i podliježu sigurnosnim ograničenjima.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>Clipboard, dostupan putem navigator.clipboard, sučelje je Web API-ja, a ne ECMAScripta. readText() vraća tekst, writeText() zapisuje tekst; read() i write() obrađuju objekte ClipboardItem. Metode vraćaju obećanja.
Potreban je siguran kontekst i fokus dokumenta. Dozvole i aktivacija korisnika mogu ograničiti pristup; klik ne jamči uspjeh. Obradite odbijanja, uključujući NotAllowedError. Provjerite dostupnost funkcija; nacrt W3C-a ne jamči podršku preglednika, a ne dokazuje je ni Node 24.
To se razlikuje od sinkronih događaja copy, cut i paste koji upotrebljavaju event.clipboardData. Međuspremnik može sadržavati tajne: izbjegavajte čitanje bez zahtjeva. Primjer prepisuje sadržaj međuspremnika tek nakon klika.
Primjeri
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;
}
});Rezultat
On an allowed, successful click: Copied: CKTIS Clipboard text: CKTIS
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.