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

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.

Fontes