CKTIS / JavaScript
Clipboard — asynchronní přístup ke schránce
Clipboard zpřístupňuje systémovou schránku prostřednictvím navigator.clipboard; operace jsou asynchronní a podléhají bezpečnostním omezením.
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
navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>Clipboard, dostupný přes navigator.clipboard, je rozhraní Web API, nikoli ECMAScriptu. readText() vrací text, writeText() text zapisuje; read() a write() pracují s objekty ClipboardItem. Metody vracejí přísliby.
Je vyžadován zabezpečený kontext a fokus dokumentu. Oprávnění a aktivace uživatelem mohou přístup omezit; kliknutí úspěch nezaručuje. Ošetřujte odmítnutí, včetně NotAllowedError. Ověřte dostupnost funkcí; návrh W3C nezaručuje podporu v prohlížečích a nedokazuje ji ani Node 24.
To se liší od synchronních událostí copy, cut a paste, které používají event.clipboardData. Schránka může obsahovat tajné údaje: nečtěte ji bez vyžádání. Příklad přepíše schránku až po kliknutí.
Pří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ýsledek
On an allowed, successful click: Copied: CKTIS Clipboard text: 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.