CKTIS / HTML
O atributo nonce
O atributo nonce contém um valor textual criptográfico utilizado pela Content Security Policy (CSP). A propriedade element.nonce disponibiliza-o aos scripts, mesmo quando o navegador oculta o valor do atributo.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
nonce="value"; element.nonce; element.nonce = valuenonce representa um valor criptográfico de utilização única que a Content Security Policy (CSP) pode usar para decidir se permite o carregamento de um recurso. O atributo, por si só, não define uma política de segurança.
Distingue o atributo HTML nonce da propriedade DOM element.nonce. Definir o atributo atualiza o valor interno [[CryptographicNonce]]. Ler a propriedade devolve esse valor, mas atribuir-lhe um valor não atualiza o atributo.
Quando um elemento fica ligado a um contexto de navegação e a lista CSP contém uma política fornecida num cabeçalho HTTP, o navegador esvazia o atributo não vazio, preservando o valor interno do nonce. Isto limita fugas através de seletores CSS; os scripts continuam a poder ler element.nonce. Por conseguinte, getAttribute('nonce') não é uma forma fiável de ler o valor atual do nonce.
O exemplo demonstra a diferença entre o atributo e a propriedade num elemento desligado. Os valores fixos servem apenas para demonstração, não para proteger conteúdo.
Exemplos
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'));Resultado
demo-only changed-demo-only demo-only
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.