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

CKTIS / JavaScript

Clipboard.writeText — escrever texto na área de transferência

Clipboard.writeText escreve texto simples na área de transferência do sistema. A operação é assíncrona e requer um contexto seguro e autorização do navegador para escrever.

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

await navigator.clipboard.writeText(text);

Clipboard.writeText, chamada como navigator.clipboard.writeText(text), substitui o conteúdo da área de transferência por texto simples, não HTML. Devolve uma Promise que é cumprida com undefined depois da escrita.

São necessários um contexto seguro e um documento ativo com o foco. Chama o método diretamente na sequência de um clique; a ativação do utilizador não garante autorização. Uma recusa pode fazer com que a promise seja rejeitada com NotAllowedError.

Usa await e try...catch; indica sucesso apenas depois de a promise ser cumprida. Verifica a disponibilidade da API no navegador de destino: o Node 24 no repositório não comprova o suporte nos navegadores.

Exemplos

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

Resultado

Copied: CKTIS

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