Fence: getNestedConfigs() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental:This is anexperimental technology
Check theBrowser compatibility table carefully before using this in production.

ThegetNestedConfigs() method of theFence interface returns theFencedFrameConfigs loaded into<fencedframe>s embedded inside the current<fencedframe>.

Syntax

getNestedConfigs()

Parameters

None.

Return value

getNestedConfigs() has two possible return values:

An array of 20FencedFrameConfig objects, if the current<fencedframe>'s config was created using an API that supports nested configs (for exampleProtected Audience). Of these 20 configs, the first N configs are those registered through the API and the rest are padding configs that will navigate toabout:blank, so that the number of configs is hidden and cannot leak any information.
null if the current<fencedframe>'s config was created using an API that does not support nested configs (for exampleShared Storage).

Examples

// Run inside a <fencedframe>// Retrieve the configs of embedded fenced framesconst configs = window.fence.getNestedConfigs();// Set a new fenced frame's config to equal one of the retrieved configsconst frame = document.createElement("fencedframe");frame.config = configs[0];