Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

ononline — obsługa zdarzenia online

Atrybut ononline elementu body określa kod JavaScript obsługujący zdarzenie online obiektu Window. Sygnalizuje zmianę oceny dostępności sieci przez przeglądarkę, ale nie potwierdza dostępności konkretnego serwera.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

<body ononline="JavaScript statements">

ononline to atrybut obsługi zdarzenia online. Zapisany na elemencie body ustawia procedurę obsługi obiektu Window, a nie zwykłe zdarzenie skierowane do body. Wartością atrybutu jest kod JavaScript; dostępny w nim parametr event reprezentuje zdarzenie.

Przeglądarka emituje online, gdy wartość navigator.onLine zmienia się z false na true. Nie oznacza to, że konkretny serwer jest osiągalny ani że żądanie sieciowe zakończy się powodzeniem. Samo zarejestrowanie procedury nie wywołuje jej dla początkowego stanu połączenia.

W JavaScript odpowiadającą właściwością jest window.ononline. Przypisanie do niej zastępuje dotychczasową procedurę tej właściwości. Alternatywą jest window.addEventListener('online', handler), które umożliwia rejestrowanie niezależnych funkcji. Nie wstawiaj niezaufanych danych do kodu atrybutu.

Przykład celowo wysyła syntetyczne zdarzenie do window, aby sprawdzić powiązanie atrybutu bez zmiany połączenia. Oczekiwany tekst akapitu to online. Taki test nie zmienia navigator.onLine i nie dowodzi dostępu do Internetu. Polityka Content Security Policy może blokować procedury zapisane bezpośrednio w atrybutach.

Przykłady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ononline demo</title>
</head>
<body ononline="document.getElementById('status').textContent = event.type">
  <p id="status">waiting</p>
  <script>
    window.dispatchEvent(new Event('online'));
  </script>
</body>
</html>

Wynik

online

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła