CKTIS / JavaScript
Clipboard — acesso assíncrono à área de transferência
Clipboard permite aceder à área de transferência do sistema através de navigator.clipboard; as operações são assíncronas e estão sujeitas a restrições de segurança.
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
navigator.clipboard.readText(): Promise<string>
navigator.clipboard.writeText(text): Promise<undefined>
navigator.clipboard.read(): Promise<ClipboardItem[]>
navigator.clipboard.write(items): Promise<undefined>Clipboard, acessível através de navigator.clipboard, é uma interface de Web API, não de ECMAScript. readText() devolve texto, writeText() escreve texto; read() e write() processam objetos ClipboardItem. Os métodos devolvem promessas.
São necessários um contexto seguro e o foco do documento. As permissões e a ativação do utilizador podem restringir o acesso; um clique não garante o sucesso. Trata as rejeições, incluindo NotAllowedError. Verifica as funcionalidades disponíveis: o rascunho do W3C não garante suporte nos navegadores, e o Node 24 também não o comprova.
Isto é diferente dos eventos síncronos copy, cut e paste que usam event.clipboardData. A área de transferência pode conter segredos: evita lê-la sem que isso seja solicitado. O exemplo só substitui o conteúdo da área de transferência depois de um clique.
Exemplos
const button = document.createElement('button');
const status = document.createElement('p');
button.textContent = 'Copy CKTIS';
status.setAttribute('role', 'status');
document.body.append(button, status);
button.addEventListener('click', async () => {
if (!window.isSecureContext ||
typeof navigator.clipboard?.writeText !== 'function') {
status.textContent = 'Clipboard unavailable';
return;
}
button.disabled = true;
try {
await navigator.clipboard.writeText('CKTIS');
status.textContent = 'Copied: CKTIS';
} catch (error) {
status.textContent = `Copy failed: ${error.name}`;
} finally {
button.disabled = false;
}
});Resultado
On an allowed, successful click: Copied: CKTIS Clipboard text: 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.