Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła