Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onsecuritypolicyviolation — obsługa zdarzenia naruszenia CSP

Atrybut onsecuritypolicyviolation określa kod JavaScript obsługujący zdarzenie securitypolicyviolation związane z naruszeniem Content Security Policy (CSP). Sam nie ustanawia polityki bezpieczeństwa, a CSP może zablokować jego kod inline.

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

Składnia

onsecuritypolicyviolation="JavaScript statements"

onsecuritypolicyviolation jest atrybutem obsługi zdarzenia securitypolicyviolation, związanego z naruszeniem Content Security Policy (CSP). Można go zapisać na dowolnym elemencie HTML, ale samo dodanie atrybutu nie gwarantuje, że element otrzyma takie zdarzenie. Atrybut nie definiuje ani nie egzekwuje CSP.

Wartością atrybutu są instrukcje JavaScript, czyli treść funkcji, a nie jej deklaracja. W kodzie obsługi event oznacza przekazane zdarzenie, a this — element obsługujący zdarzenie. Nie należy mylić nazwy atrybutu onsecuritypolicyviolation z nazwą zdarzenia securitypolicyviolation, która nie ma prefiksu on.

Odpowiadająca mu właściwość JavaScript, na przykład element.onsecuritypolicyviolation, przyjmuje funkcję albo null, a nie tekst kodu. CSP może blokować atrybuty obsługi zdarzeń inline; kod mający obserwować naruszenia również podlega tym ograniczeniom. Nie osłabiaj polityki tylko po to, aby uruchomić taki atrybut.

Przykład wysyła syntetyczne zdarzenie Event bez wywoływania rzeczywistego naruszenia CSP. Sprawdza wyłącznie powiązanie atrybutu z nazwą zdarzenia i wyświetla securitypolicyviolation. Taki obiekt nie zawiera szczegółów rzeczywistego naruszenia.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Handler test</title>
<div id="target" onsecuritypolicyviolation="this.textContent = event.type;">Waiting</div>
<script>
  const target = document.getElementById('target');
  target.dispatchEvent(new Event('securitypolicyviolation'));
</script>
</html>

Wynik

securitypolicyviolation

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

Źródła