CKTIS / JavaScript
HTMLElement.click — déclenchement programmatique d’un clic
HTMLElement.click déclenche un clic synthétique sur un élément HTML. Ce n’est ni un clic physique ni une source d’activation utilisateur.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.click()Appelez HTMLElement.click sous la forme element.click(), sans argument ; la méthode renvoie undefined. Il s’agit d’une API de navigateur définie par le HTML Standard, et non d’une fonction ECMAScript. Les moteurs de navigateur actuels la prennent en charge ; Node 24 ne permet pas d’établir qu’elle y est disponible.
La méthode distribue de manière synchrone un événement synthétique click avec isTrusted === false. Elle peut déclencher le comportement d’activation par défaut de l’élément. Elle ne donne pas le focus à l’élément et ne fournit pas à elle seule l’activation utilisateur requise par les API protégées.
Pour un contrôle de formulaire désactivé, la méthode ne fait rien. Un appel réentrant sur le même élément pendant un click() en cours est également ignoré. L’exemple illustre ces deux cas ; l’élément n’a pas besoin d’être rattaché au document.
Exemples
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}`);Résultat
click 1; trusted=false total=1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.