ContextQMD
Back to Content

Fence: getNestedConfigs() method

files/en-us/web/api/fence/getnestedconfigs/index.md

latest1.6 KB
Original Source

{{SeeCompatTable}}{{APIRef("Fenced Frame API")}}

The getNestedConfigs() method of the {{domxref("Fence")}} interface returns the {{domxref("FencedFrameConfig")}}s loaded into <fencedframe>s embedded inside the current <fencedframe>.

Syntax

js-nolint
getNestedConfigs()

Parameters

None.

Return value

getNestedConfigs() has two possible return values:

  • An array of 20 {{domxref("FencedFrameConfig")}} objects, if the current <fencedframe>'s config was created using an API that supports nested configs (for example Protected Audience). Of these 20 configs, the first N configs are those registered through the API and the rest are padding configs that will navigate to about: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 example Shared Storage).

Examples

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];

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also