Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

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

Fontes