Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

allow — polityka funkcji osadzonej ramki

Atrybut `allow` na `iframe` ogranicza lub deleguje funkcje przeglądarki w ramach Permissions Policy; nie udziela zgody użytkownika.

Wersja: HTML Living Standard

Składnia

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

Wartość zawiera dyrektywy rozdzielone średnikami, np. geolocation 'none'; camera 'none'. Każda wskazuje funkcję i listę dozwolonych źródeł; 'none' blokuje funkcję. To inna składnia niż nagłówek HTTP Permissions-Policy. Nie jest to lista elementów HTML.

Ramka nie może dostać uprawnienia, którego zabrania polityka dokumentu nadrzędnego. Ostateczne działanie może dodatkowo wymagać bezpiecznego kontekstu, gestu lub zgody użytkownika. allow nie zastępuje sandbox i nie znosi ograniczeń dostępu między różnymi źródłami.

Przykład ładuje wyłącznie lokalne srcdoc i odczytuje efektywną politykę przez dostępne w testowanym Chromium featurePolicy. Geolokalizacja i kamera są zablokowane. Nie są uruchamiane czujniki ani wyświetlane prośby o uprawnienia; ten interfejs diagnostyczny nie jest przenośnym API dla wszystkich przeglądarek.

Przykłady

<!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>

Wynik

geolocation=false; camera=false

Wynik pochodzi z polityki dokumentu wewnątrz ramki, a nie wyłącznie z odczytu tekstu atrybutu.

Źródła