围栏:getNestedConfigs() 方法

实验性:这是一个实验性技术
在生产环境中使用此功能之前,请仔细查看浏览器兼容性表

getNestedConfigs() 方法是 Fence 接口的一部分,它返回加载到当前 <fencedframe> 内部嵌入的 <fencedframe> 中的 FencedFrameConfig

语法

js
getNestedConfigs()

参数

无。

返回值

getNestedConfigs() 有两种可能的返回值

  • 如果当前 <fencedframe> 的配置是使用支持嵌套配置的 API 创建的(例如 受保护的受众),则为 20 个 FencedFrameConfig 对象的数组。 在这 20 个配置中,前 N 个配置是通过 API 注册的,其余的是填充配置,将导航到 about:blank,以便配置的数量是隐藏的,不会泄露任何信息。
  • 如果当前 <fencedframe> 的配置是使用不支持嵌套配置的 API 创建的(例如 共享存储),则为 null

示例

js
// Run inside a <fencedframe>

// Retrieve the configs of embedded fenced frames
const configs = window.fence.getNestedConfigs();

// Set a new fenced frame's config to equal one of the retrieved configs
const frame = document.createElement("fencedframe");
frame.config = configs[0];

规范

规范
围栏框架
# dom-fence-getnestedconfigs

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅