Директива geolocation заголовка HTTP Permissions-Policy управляет тем, разрешено ли текущему документу использовать интерфейс Geolocation.

В частности, если определённая политика блокирует использование этой функции, вызовы getCurrentPosition() и watchPosition() приведут к вызову соответствующих функций обратного вызова с кодом GeolocationPositionError PERMISSION_DENIED.

Синтаксис

Permissions-Policy: geolocation=<allowlist>;

<allowlist>

Список источников, которым разрешено использовать эту функцию. Подробнее см. в разделе Permissions-Policy > Синтаксис.

Политика по умолчанию

Список разрешённых источников по умолчанию для geolocation — self. Контекст просмотра верхнего уровня и iframe с тем же источником по умолчанию имеют доступ к функции geolocation.

Примеры

Основное использование

Компания SecureCorp Inc. хочет запретить geolocation во всех iframe с отличным от исходного источником, кроме тех, источник которых — https://example.com. Для этого она может отправить следующий заголовок HTTP-ответа, задающий политику разрешений:

Permissions-Policy: geolocation=(self "https://example.com")

Компания SecureCorp Inc. также должна добавить атрибут allow к каждому элементу <iframe>, в котором должна быть разрешена функция geolocation:

<iframe src="https://example.com/map" allow="geolocation"></iframe>

Использование политики по умолчанию

Если список разрешённых источников для geolocation не задан заголовком ответа Permissions-Policy, пользовательские агенты применят список разрешённых источников по умолчанию self. В этом режиме geolocation автоматически разрешена в контексте просмотра верхнего уровня и iframe с тем же источником, но не в iframe с отличным от исходного источником.

Чтобы разрешить geolocation в iframe с отличным от исходного источником, добавьте атрибут allow к элементу <iframe>:

<iframe src="https://other.com/store-locator" allow="geolocation"></iframe>

Спецификации

Совместимость с браузерами

См. также

• Заголовок Permissions-Policy
• Политика разрешений