Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Clipboard.writeText — scrivere testo negli appunti

Clipboard.writeText scrive testo normale negli appunti di sistema. L’operazione è asincrona e richiede un contesto sicuro e l’autorizzazione del browser alla scrittura.

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

await navigator.clipboard.writeText(text);

Clipboard.writeText, chiamato come navigator.clipboard.writeText(text), sostituisce il contenuto degli appunti con testo normale, non HTML. Restituisce una Promise che, dopo la scrittura, viene soddisfatta con undefined.

Sono necessari un contesto sicuro e un documento attivo con il focus. Chiama il metodo direttamente in seguito a un clic; l’attivazione dell’utente non garantisce l’autorizzazione. Un rifiuto può far sì che la promise venga respinta con NotAllowedError.

Usa await e try...catch; segnala il successo solo dopo che la promise è stata soddisfatta. Verifica la disponibilità dell’API nel browser di destinazione: Node 24 nel repository non dimostra il supporto nei browser.

Esempi

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

Risultato

Copied: 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