HTMLFencedFrameElement: config-Eigenschaft
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates.
Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the <fencedframe> element and related APIs.
Die config-Eigenschaft des HTMLFencedFrameElement enthält ein FencedFrameConfig-Objekt, das die Navigation eines <fencedframe> darstellt, also welchen Inhalt es anzeigen wird. Ein FencedFrameConfig wird aus einer Quelle wie der Protected Audience API zurückgegeben.
Wert
Der anfängliche Wert von config ist null.
Wenn sein Wert auf eine Instanz eines FencedFrameConfig-Objekts gesetzt wird, bestimmen die internen Eigenschaften des FencedFrameConfig (zum Beispiel mappedURL), was im zugehörigen <fencedframe> geladen wird. Zusätzlich:
- Der Navigationstyp wird
"replace"sein (sieheNavigateEvent.navigationType), was bedeutet, dass der aktuelle Verlaufs-Eintrag durch den neuen Eintrag ersetzt wird, anstatt einen neuen Verlaufs-Eintrag hinzuzufügen. - Die Navigations-
Referrer-Policyist auf"no-referrer"gesetzt.
Beispiele
Um festzulegen, welcher Inhalt in einem <fencedframe> angezeigt wird, generiert eine nutzende 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 von einer Anzeigenausschreibung der Protected Audience API, das dann verwendet wird, um die gewonnene Anzeige in einem <fencedframe> anzuzeigen:
const frameConfig = await navigator.runAdAuction({
// … auction configuration
resolveToConfig: true,
});
const frame = document.createElement("fencedframe");
frame.config = frameConfig;
Spezifikationen
| Spezifikation |
|---|
| Fenced Frame # dom-htmlfencedframeelement-config |
Browser-Kompatibilität
Siehe auch
- Fenced frames auf privacysandbox.google.com
- The Privacy Sandbox auf privacysandbox.google.com