WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen