Fence: getNestedConfigs()-Methode

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die getNestedConfigs()-Methode der Fence-Schnittstelle gibt die FencedFrameConfigs zurück, die in <fencedframe>-Elementen geladen wurden, welche innerhalb des aktuellen <fencedframe> eingebettet sind.

Syntax

js
getNestedConfigs()

Parameter

Keine.

Rückgabewert

getNestedConfigs() hat zwei mögliche Rückgabewerte:

  • Ein Array von 20 FencedFrameConfig-Objekten, wenn die Konfiguration des aktuellen <fencedframe> mit einer API erstellt wurde, die verschachtelte Konfigurationen unterstützt (zum Beispiel Protected Audience). Von diesen 20 Konfigurationen sind die ersten N diejenigen, die durch die API registriert wurden, und der Rest sind Auffüllkonfigurationen, die zu about:blank navigieren, sodass die Anzahl der Konfigurationen verborgen bleibt und keine Informationen lecken können.
  • null, wenn die Konfiguration des aktuellen <fencedframe> mit einer API erstellt wurde, die keine verschachtelten Konfigurationen unterstützt (zum Beispiel Shared Storage).

Beispiele

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

Spezifikationen

Specification
Fenced Frame
# dom-fence-getnestedconfigs

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch