CKTIS / HTML
Atrybut nonce
Atrybut nonce przechowuje tekstową wartość kryptograficzną używaną przez Content Security Policy (CSP). Właściwość element.nonce udostępnia ją skryptom, nawet gdy przeglądarka ukryje wartość atrybutu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
nonce="value"; element.nonce; element.nonce = valuenonce oznacza kryptograficzną wartość jednorazową, którą Content Security Policy (CSP) może wykorzystać przy podejmowaniu decyzji o dopuszczeniu pobrania zasobu. Sam atrybut nie definiuje polityki bezpieczeństwa.
Rozróżniaj atrybut HTML nonce i właściwość DOM element.nonce. Ustawienie atrybutu aktualizuje wewnętrzną wartość [[CryptographicNonce]]. Odczyt właściwości zwraca tę wartość, ale przypisanie do właściwości nie aktualizuje atrybutu.
Gdy element zostaje połączony z kontekstem przeglądania, a lista CSP zawiera politykę dostarczoną w nagłówku HTTP, przeglądarka opróżnia niepusty atrybut, zachowując wewnętrzną wartość nonce. Ogranicza to wyciek przez selektory CSS; skrypty nadal mogą odczytać element.nonce. Dlatego getAttribute('nonce') nie jest niezawodnym sposobem odczytu bieżącej wartości nonce.
Przykład pokazuje różnicę między atrybutem a właściwością na odłączonym elemencie. Stałe wartości służą wyłącznie demonstracji, nie zabezpieczaniu treści.
Przykłady
const element = document.createElement('script');
element.setAttribute('nonce', 'demo-only');
console.log(element.nonce);
element.nonce = 'changed-demo-only';
console.log(element.nonce);
console.log(element.getAttribute('nonce'));Wynik
demo-only changed-demo-only demo-only
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.