Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

Atribut nonce

Atribut nonce obsahuje textovou kryptografickou hodnotu používanou zásadami Content Security Policy (CSP). Vlastnost element.nonce ji zpřístupňuje skriptům, i když prohlížeč hodnotu atributu skryje.

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

Syntaxe

nonce="value"; element.nonce; element.nonce = value

nonce označuje kryptografickou hodnotu použitou jednou, kterou mohou zásady Content Security Policy (CSP) využít při rozhodování, zda povolit načtení prostředku. Samotný atribut bezpečnostní zásady nedefinuje.

Rozlišujte mezi atributem HTML nonce a vlastností DOM element.nonce. Nastavení atributu aktualizuje interní hodnotu [[CryptographicNonce]]. Přečtení vlastnosti tuto hodnotu vrátí, přiřazení hodnoty vlastnosti však atribut neaktualizuje.

Když se prvek připojí ke kontextu prohlížení a seznam CSP obsahuje zásadu předanou v hlavičce HTTP, prohlížeč vyprázdní jeho neprázdný atribut a zachová přitom interní hodnotu nonce. Tím omezuje úniky přes selektory CSS; skripty mohou element.nonce stále číst. getAttribute('nonce') proto není spolehlivý způsob, jak přečíst aktuální hodnotu nonce.

Příklad ukazuje rozdíl mezi atributem a vlastností na odpojeném prvku. Pevné hodnoty slouží pouze k demonstraci, nikoli k zabezpečení obsahu.

Příklady

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'));

Výsledek

demo-only
changed-demo-only
demo-only

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje