HTMLFencedFrameElement: config-Eigenschaft

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 vor der Verwendung auf produktiven Webseiten.

Die config-Eigenschaft des HTMLFencedFrameElement enthält ein FencedFrameConfig-Objekt, das die Navigation eines <fencedframe> repräsentiert, also den Inhalt, der darin angezeigt wird. Ein FencedFrameConfig wird von einer Quelle wie der Protected Audience API zurückgegeben.

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:

js
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

Specification
Fenced Frame
# dom-htmlfencedframeelement-config

Browser-Kompatibilität

Siehe auch