CKTIS / JavaScript
HTMLElement.click — programowe kliknięcie
Metoda HTMLElement.click wywołuje syntetyczne kliknięcie elementu HTML. Nie jest fizycznym kliknięciem ani źródłem aktywacji użytkownika.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.click()HTMLElement.click wywołuje się jako element.click(), bez argumentów; zwraca undefined. To API przeglądarki z HTML Standard, nie funkcja ECMAScript. Obsługują je współczesne silniki przeglądarek; Node 24 nie dowodzi jego dostępności.
Metoda synchronicznie wysyła syntetyczne zdarzenie click z isTrusted === false. Może uruchomić domyślne zachowanie aktywacji elementu. Nie ustawia fokusu ani sama nie zapewnia aktywacji użytkownika wymaganej przez chronione API.
Dla wyłączonej kontrolki formularza metoda nic nie robi. Ponowne wywołanie na tym samym elemencie podczas trwającego click() również jest ignorowane. Przykład pokazuje obie sytuacje; element nie musi być dołączony do dokumentu.
Przykłady
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}`);Wynik
click 1; trusted=false total=1
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.