Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Clipboard — accesso asincrono agli appunti

Clipboard consente di accedere agli appunti di sistema tramite navigator.clipboard; le operazioni sono asincrone e soggette a restrizioni di sicurezza.

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

Sintassi

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

Clipboard, accessibile tramite navigator.clipboard, è un’interfaccia Web API, non ECMAScript. readText() restituisce testo, writeText() scrive testo; read() e write() gestiscono oggetti ClipboardItem. I metodi restituiscono promesse.

Sono necessari un contesto sicuro e il focus del documento. Le autorizzazioni e l’attivazione dell’utente possono limitare l’accesso; un clic non garantisce il successo. Gestisci i rifiuti, incluso NotAllowedError. Verifica le funzionalità disponibili: la bozza W3C non garantisce il supporto dei browser, e nemmeno Node 24 lo dimostra.

Questo è diverso dagli eventi sincroni copy, cut e paste che usano event.clipboardData. Gli appunti possono contenere segreti: evita di leggerli senza che sia stato richiesto. L’esempio sovrascrive gli appunti solo dopo un clic.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti