围栏: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 的浏览器中加载。