大网数据广告活动
Web 标准与前端开发

Permissions-Policy: geolocation directive

· 52CE 我爱测

The HTTP Permissions-Policy header `geolocation` directive controls whether the current document is allowed to use the Geolocation Interface.

The HTTP Permissions-Policy header geolocation directive controls whether the current document is allowed to use the Geolocation Interface.

Specifically, where a defined policy blocks use of this feature, calls to Geolocation.getCurrentPosition and Geolocation.watchPosition will cause those functions' callbacks to be invoked with a GeolocationPositionError code of PERMISSION_DENIED.

Syntax

Permissions-Policy: geolocation=<allowlist>;
  • <allowlist>

Default policy

The default allowlist for geolocation is self. The top-level browsing context and same-origin iframes are allowed access to the geolocation feature by default.

Examples

Basic usage

SecureCorp Inc. wants to disallow geolocation within all cross-origin iframes except those whose origin is https://example.com. It can do so by delivering the following HTTP response header to define a Permissions Policy:

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

SecureCorp Inc. must also include an iframe attribute on each <iframe> element where geolocation is to be allowed:

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

[!NOTE] Specifying the Permissions-Policy header in this manner disallows geolocation for other origins, even if they are allowed by the <iframe> allow attribute.

Using the default policy

If an allowlist for geolocation is not defined by a Permissions-Policy response header, user agents will apply the default allowlist self. In this mode, geolocation is automatically allowed in the top-level browsing context and same-origin iframes, but not in cross-origin iframes.

To allow geolocation in a cross-origin iframe, include an iframe attribute on the <iframe> element:

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

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。