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

CKTIS / HTML

allow — funcionalidades disponíveis numa iframe

`allow` em `iframe` restringe ou delega funcionalidades através de Permissions Policy; não concede o consentimento do utilizador.

Versão: HTML Living Standard

Sintaxe

<iframe allow="geolocation 'none'; camera 'none'"></iframe>

O valor contém diretivas separadas por ponto e vírgula, como geolocation 'none'; camera 'none'. Cada uma identifica uma funcionalidade e origens permitidas; 'none' proíbe-a. A gramática difere do cabeçalho HTTP Permissions-Policy. Não é uma lista de elementos HTML.

A iframe não obtém funcionalidades proibidas pela política de um documento ascendente. O uso pode ainda exigir contexto seguro, ativação ou autorização do utilizador. allow não substitui sandbox nem remove restrições entre origens.

O exemplo carrega apenas srcdoc local e lê a política efetiva através de featurePolicy, disponível no Chromium testado. Câmara e geolocalização ficam proibidas. Não ativa sensores nem pede permissões; esta interface de diagnóstico não é portável a todos os navegadores.

Exemplos

<!doctype html><meta charset="utf-8">
<iframe id="frame" title="Restricted content" allow="geolocation 'none'; camera 'none'"
  srcdoc="<p>Local content</p>"></iframe>
<output id="result"></output>
<script>
document.querySelector('#frame').addEventListener('load', event => {
  const policy = event.target.contentDocument.featurePolicy;
  document.querySelector('#result').textContent =
    'geolocation=' + policy.allowsFeature('geolocation') +
    '; camera=' + policy.allowsFeature('camera');
});
</script>

Resultado

geolocation=false; camera=false

O resultado provém da política do documento dentro da iframe, não apenas da cadeia de texto do atributo.

Fontes