CKTIS / JavaScript
HTMLElement.click — clique programático
HTMLElement.click desencadeia um clique sintético num elemento HTML. Não é um clique físico nem uma fonte de ativação do utilizador.
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
element.click()Chame HTMLElement.click como element.click(), sem argumentos; devolve undefined. Esta é uma API do navegador definida pelo HTML Standard, não uma função ECMAScript. Os motores de navegador atuais suportam-na; o Node 24 não demonstra que esteja disponível nesse ambiente.
O método despacha sincronamente um evento sintético click com isTrusted === false. Pode desencadear o comportamento de ativação predefinido do elemento. Não coloca o elemento em foco nem fornece, por si só, a ativação do utilizador exigida pelas API protegidas.
Para um controlo de formulário desativado, o método não faz nada. Uma chamada reentrante ao mesmo elemento durante um click() em curso também é ignorada. O exemplo demonstra ambos os casos; não é necessário que o elemento esteja associado ao documento.
Exemplos
const button = document.createElement('button');
button.type = 'button';
let count = 0;
button.addEventListener('click', (event) => {
count += 1;
console.log(`click ${count}; trusted=${event.isTrusted}`);
button.click(); // Reentrant call is ignored.
});
button.click();
button.disabled = true;
button.click();
console.log(`total=${count}`);Resultado
click 1; trusted=false total=1
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.