Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

ClipboardItem — um elemento da área de transferência com representações MIME

ClipboardItem descreve um elemento da área de transferência que pode ter várias representações MIME. O construtor prepara os dados; não os escreve, por si só, na área de transferência do sistema.

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

Sintaxe

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

ClipboardItem faz parte das Web APIs, não do ECMAScript. Um objeto pode conter diferentes representações do mesmo conteúdo. O construtor aceita um mapa não vazio de tipos MIME para valores Blob, cadeias de caracteres ou promessas desses valores; um mapa vazio gera um TypeError.

types expõe os tipos de representação e getType(type) devolve um Promise<Blob>; se faltar uma representação, a promessa é rejeitada com NotFoundError. A propriedade opcional presentationStyle aceita "unspecified" (predefinição), "inline" ou "attachment". O método estático ClipboardItem.supports(type) verifica o suporte do formato, não as permissões.

Só navigator.clipboard.write([item]) escreve os dados; navigator.clipboard.read() lê os elementos. O acesso à área de transferência está sujeito a restrições de permissões, ativação do utilizador e foco. A interface requer um contexto Window seguro. Verifique a disponibilidade dos métodos que utiliza; a especificação é um projeto do W3C e o Node 24 não comprova o suporte nos navegadores.

Exemplos

<!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>

Resultado

ClipboardItem unavailable

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes