Wert

Der Wert von config ist zunächst null.

Wenn sein Wert auf eine Instanz eines FencedFrameConfig-Objekts gesetzt ist, bestimmen die internen Eigenschaften des FencedFrameConfig (zum Beispiel mappedURL), was innerhalb des zugehörigen <fencedframe> geladen wird. Zusätzlich:

• Der Navigationstyp wird "replace" sein (siehe NavigateEvent.navigationType), was bedeutet, dass der aktuelle Verlaufseintrag durch den neuen Eintrag ersetzt wird, anstatt einen neuen Verlaufseintrag hinzuzufügen.
• Die Referrer-Policy der Navigation ist auf "no-referrer" gesetzt.

Beispiele

Um festzulegen, welcher Inhalt in einem <fencedframe> angezeigt wird, erzeugt eine API (wie Protected Audience oder Shared Storage) ein FencedFrameConfig-Objekt, das dann als Wert der config-Eigenschaft des <fencedframe> gesetzt wird.

Das folgende Beispiel erhält ein FencedFrameConfig aus einer Anzeigenauktion der Protected Audience API, das dann verwendet wird, um die Gewinneranzeige in einem <fencedframe> anzuzeigen:

const frameConfig = await navigator.runAdAuction({
  // … auction configuration
  resolveToConfig: true,
});

const frame = document.createElement("fencedframe");
frame.config = frameConfig;

Hinweis:>resolveToConfig: true muss in den runAdAuction()-Aufruf übergeben werden, um ein FencedFrameConfig-Objekt zu erhalten. Wenn dies nicht gesetzt ist, wird das resultierende Promise in einen URN aufgelöst, der nur in einem <iframe> verwendet werden kann.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Eingezäunte Frames auf privacysandbox.google.com
• Die Privacy Sandbox auf privacysandbox.google.com