Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

HTMLElement.click — clic programático

HTMLElement.click activa un clic sintético en un elemento HTML. No es un clic físico ni una fuente de activación del usuario.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

element.click()

Llama a HTMLElement.click como element.click(), sin argumentos; devuelve undefined. Es una API del navegador definida por el HTML Standard, no una función de ECMAScript. Los motores de navegador actuales la admiten; Node 24 no demuestra que esté disponible allí.

El método distribuye sincrónicamente un evento sintético click con isTrusted === false. Puede activar el comportamiento de activación predeterminado del elemento. No enfoca el elemento ni proporciona por sí mismo la activación del usuario que requieren las API protegidas.

En un control de formulario deshabilitado, el método no hace nada. También se ignora una llamada reentrante al mismo elemento mientras hay un click() en curso. El ejemplo muestra ambos casos; no es necesario que el elemento esté adjunto al documento.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes