Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Clipboard.write — scrittura asincrona negli appunti

Clipboard.write scrive oggetti ClipboardItem negli appunti di sistema. Accetta rappresentazioni MIME alternative, ma richiede un contesto sicuro e l’autorizzazione del browser.

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.write([new ClipboardItem({ "text/plain": new Blob([text], { type: "text/plain" }) })]);

Clipboard.write, chiamato come navigator.clipboard.write(items), accetta oggetti ClipboardItem. Un elemento può contenere più rappresentazioni MIME dello stesso contenuto. writeText(text) è più semplice quando si tratta solo di testo. La promise restituita viene soddisfatta con undefined dopo la scrittura; l’accesso negato può causare NotAllowedError.

Questa è una Web API, non fa parte di ECMAScript; Node 24 non dimostra il supporto nei browser. Verifica che l’API sia disponibile e prova i browser di destinazione. Usa un contesto sicuro: HTTPS o un’origine locale attendibile, come localhost. HTTPS da solo non garantisce un contesto sicuro se la pagina è incorporata sotto un antenato non sicuro; controlla window.isSecureContext.

Esegui la scrittura direttamente in risposta a un clic in un documento che ha il focus e gestisci gli errori; le regole di autorizzazione variano da browser a browser. Non confondere più rappresentazioni con più elementi: la piattaforma potrebbe conservare solo il primo elemento. L’esempio sovrascrive gli appunti dopo un clic intenzionale dell’utente.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>Clipboard.write</title>
<button id="copy" type="button">Copy: Hello, clipboard!</button>
<output id="status" aria-live="polite"></output>
<script>
const button = document.querySelector('#copy');
const status = document.querySelector('#status');

button.addEventListener('click', async () => {
  if (!window.isSecureContext ||
      typeof navigator.clipboard?.write !== 'function' ||
      typeof ClipboardItem !== 'function') {
    status.textContent = 'Unavailable';
    return;
  }

  try {
    const blob = new Blob(['Hello, clipboard!'], { type: 'text/plain' });
    const item = new ClipboardItem({ 'text/plain': blob });
    await navigator.clipboard.write([item]);
    status.textContent = 'Copied';
  } catch (error) {
    status.textContent = `Failed: ${error.name}`;
  }
});
</script>

Risultato

The status is initially empty. After the user clicks the button, it displays `Copied` only if the clipboard write succeeds. If the context is insecure or the required API is unavailable, it displays `Unavailable`. If an error occurs while preparing or writing the clipboard item, it displays `Failed: ` followed by the error name.

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