Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

ClipboardItem — un elemento degli appunti con rappresentazioni MIME

ClipboardItem descrive un elemento degli appunti che può avere diverse rappresentazioni MIME. Il costruttore prepara i dati, ma non li scrive di per sé negli appunti di sistema.

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

new ClipboardItem(items, options)
item.types
item.getType(type) // Promise<Blob>
ClipboardItem.supports(type)

ClipboardItem fa parte delle Web API, non di ECMAScript. Un oggetto può contenere diverse rappresentazioni dello stesso contenuto. Il costruttore accetta una mappa non vuota di tipi MIME associati a valori Blob, stringhe o promesse di tali valori; una mappa vuota genera un TypeError.

types espone i tipi delle rappresentazioni e getType(type) restituisce un Promise<Blob>; se una rappresentazione non è presente, la promessa viene rifiutata con NotFoundError. La proprietà facoltativa presentationStyle accetta "unspecified" (predefinito), "inline" o "attachment". Il metodo statico ClipboardItem.supports(type) controlla il supporto del formato, non le autorizzazioni.

Solo navigator.clipboard.write([item]) scrive i dati; navigator.clipboard.read() legge gli elementi. L’accesso agli appunti è soggetto a restrizioni relative alle autorizzazioni, all’attivazione dell’utente e al focus. L’interfaccia richiede un contesto Window sicuro. Verifica la disponibilità dei metodi che usi; la specifica è una bozza W3C e Node 24 non dimostra il supporto nei browser.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ClipboardItem MIME representation</title>
</head>
<body>
  <pre id="result" role="status"></pre>
  <script>
    async function showItem() {
      const result = document.querySelector('#result');
      if (typeof globalThis.ClipboardItem !== 'function') {
        result.textContent = 'ClipboardItem unavailable';
        return;
      }
      const type = 'text/plain';
      const item = new ClipboardItem({
        [type]: new Blob(['Hello'], { type })
      });
      const representation = await item.getType(type);
      result.textContent = item.types.join(', ') + '\n' + await representation.text();
    }
    showItem();
  </script>
</body>
</html>

Risultato

ClipboardItem unavailable

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