Valeur

La valeur par défaut de config est null.

Lorsque sa valeur est définie sur une instance d'objet FencedFrameConfig, les propriétés internes du FencedFrameConfig (par exemple mappedURL) déterminent ce qui est chargé à l'intérieur du <fencedframe> associé. De plus :

• Le type de navigation sera "replace" (voir NavigateEvent.navigationType), ce qui signifie que l'entrée d'historique courante est remplacée par la nouvelle, au lieu d'ajouter une nouvelle entrée d'historique.
• La Referrer-Policy de la navigation est définie sur "no-referrer".

Exemples

Pour définir le contenu affiché dans un <fencedframe>, une API d'utilisation (comme Protected Audience ou Shared Storage) génère un objet FencedFrameConfig, qui est ensuite affecté à la propriété config du <fencedframe>.

L'exemple suivant récupère un FencedFrameConfig depuis une enchère publicitaire de l'API Protected Audience, qui est ensuite utilisé pour afficher la publicité gagnante dans un <fencedframe> :

const frameConfig = await navigator.runAdAuction({
  // … configuration de l'enchère
  resolveToConfig: true,
});

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

Note : Il faut passer resolveToConfig: true à l'appel de runAdAuction() pour obtenir un objet FencedFrameConfig. Si ce n'est pas le cas, la promesse (Promise) résultante renverra un URN qui ne peut être utilisé que dans un élément HTML <iframe>.

Spécifications

Compatibilité des navigateurs

Voir aussi

• Les cadres protégés sur privacysandbox.google.com
• Le bac à sable de la vie privée sur privacysandbox.google.com