Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 = value

nonce 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.

Źródła