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

HTMLFencedFrameElement:config 属性

· 52CE 我爱测

HTMLFencedFrameElement 的 **`config`** 属性包含一个 FencedFrameConfig 对象,表示 fencedframe 的导航,即其中将显示什么内容。`FencedFrameConfig` 是从诸如受保护的受众 API 等来源返回的。

Fenced Frame API

HTMLFencedFrameElement 的 config 属性包含一个 FencedFrameConfig 对象,表示 fencedframe 的导航,即其中将显示什么内容。FencedFrameConfig 是从诸如受保护的受众 API 等来源返回的。

值

config 的初始值为 null。

当值设置为 FencedFrameConfig 对象实例,FencedFrameConfig 的内部属性(例如 mappedURL)将决定所关联的 <fencedframe> 内部加载的内容。此外:

  • 导航类型将是 "replace"(参见 NavigateEvent.navigationType),这意味着当前历史记录条目将被新条目替换,而不是为其添加一个新的历史记录条目。
  • 导航的 Referrer-Policy 被设置为 "no-referrer"。

示例

要设置将在 <fencedframe> 中显示的内容,使用 API(如受保护的受众或共享存储)生成一个 FencedFrameConfig 对象,然后将其设置为 <fencedframe> 的 config 属性值。

以下示例从受保护的受众 API 的广告拍卖中获取一个 FencedFrameConfig,然后使用它在 <fencedframe> 中显示获胜的广告:

const frameConfig = await navigator.runAdAuction({
  // 拍卖配置
  resolveToConfig: true,
});

const frame = document.createElement("fencedframe");
frame.config = frameConfig;

[!NOTE] 在调用 runAdAuction() 时,必须传入 resolveToConfig: true 以获得 FencedFrameConfig 对象。如果没有设置,则所得的 Promise 将兑现为一个 URN,该 URN 只能在 iframe 中使用。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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