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

Permissions-Policy: local-network directive

· 52CE 我爱测

The HTTP Permissions-Policy header `local-network` directive controls whether the current document is allowed to make network requests to local addresses.

The HTTP Permissions-Policy header local-network directive controls whether the current document is allowed to make network requests to local addresses.

A local address is only accessible on the local network; its target will differ on different networks. For example, 192.168.0.1.

Specifically, where a defined policy blocks use of this feature, requests to local addresses will always fail.

See Local Network Access for more details.

Syntax

Permissions-Policy: local-network=<allowlist>;
  • <allowlist>

Default policy

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

Examples

Basic usage

SecureCorp Inc. wants to disallow local-network 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: local-network=(self "https://example.com")

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

<iframe src="https://example.com/lna" allow="local-network"></iframe>

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

Using the default policy

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

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

<iframe src="https://other.com/lna" allow="local-network"></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

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

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