Fence:getNestedConfigs() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

Fence 介面的 getNestedConfigs() 方法會返回載入到當前 <fencedframe> 中嵌入的 <fencedframe> 裡的 FencedFrameConfig 物件。

語法

js
getNestedConfigs()

引數

無。

返回值

getNestedConfigs() 有兩種可能的返回值:

  • 如果當前 <fencedframe> 的配置是使用支援巢狀配置的 API(例如 Protected Audience)建立的,則返回一個包含 20 個 FencedFrameConfig 物件的陣列。在這 20 個配置中,前 N 個配置是透過 API 註冊的配置,其餘的是填充配置,將導航到 about:blank,以隱藏配置數量並防止洩露任何資訊。
  • 如果當前 <fencedframe> 的配置是使用不支援巢狀配置的 API(例如 Shared Storage)建立的,則返回 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

瀏覽器相容性

另見