CKTIS / JavaScript
HTMLElement.click — programmgesteuertes Klicken
HTMLElement.click löst auf einem HTML-Element einen synthetischen Klick aus. Dieser ist weder ein physischer Klick noch eine Quelle für eine Benutzeraktivierung.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.click()HTMLElement.click wird als element.click() ohne Argumente aufgerufen und gibt undefined zurück. Dies ist eine Browser-API, die im HTML Standard definiert ist, keine ECMAScript-Funktion. Aktuelle Browser-Engines unterstützen sie; Node 24 belegt nicht, dass sie dort verfügbar ist.
Die Methode löst synchron ein synthetisches click-Ereignis mit isTrusted === false aus. Sie kann das standardmäßige Aktivierungsverhalten des Elements auslösen. Sie setzt weder den Fokus auf das Element noch stellt sie selbst die für geschützte APIs erforderliche Benutzeraktivierung bereit.
Bei einem deaktivierten Formularsteuerelement bewirkt die Methode nichts. Auch ein erneuter Aufruf für dasselbe Element während eines laufenden click() wird ignoriert. Das Beispiel zeigt beide Fälle; das Element muss nicht in das Dokument eingefügt sein.
Beispiele
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}`);Ergebnis
click 1; trusted=false total=1
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.