Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Fence : méthode getNestedConfigs()

Obsolète
En cours de suppression

Cette fonctionnalité est en cours de suppression des navigateurs. L'utiliser maintenant peut entraîner un dysfonctionnement dans les futures mises à jour. 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.

La méthode getNestedConfigs() de l'interface Fence retourne les FencedFrameConfig chargés dans les éléments HTML <fencedframe> imbriqués à l'intérieur de l'élément HTML <fencedframe> courant.

Syntaxe

js
getNestedConfigs()

Paramètres

Aucun.

Valeur de retour

getNestedConfigs() a deux valeurs de retour possibles :

  • Un tableau de 20 objets FencedFrameConfig, si la configuration du <fencedframe> courant a été créée avec une API qui prend en charge les configs imbriquées (par exemple Protected Audience). Parmi ces 20 configs, les N premières sont celles enregistrées avec l'API et les autres sont des configs de remplissage qui naviguent vers about:blank, afin que le nombre réel de configs soit masqué et ne puisse pas fuiter d'information.
  • null si la configuration du <fencedframe> courant a été créée avec une API qui ne prend pas en charge les configs imbriquées (par exemple Shared Storage).

Exemples

js
// À exécuter dans un <fencedframe>

// Récupérer les configs des cadres protégés imbriqués
const configs = window.fence.getNestedConfigs();

// Définir la config d'un nouveau cadre protégé à l'une des configs récupérées
const frame = document.createElement("fencedframe");
frame.config = configs[0];

Spécifications

Spécification
Fenced Frame
# dom-fence-getnestedconfigs

Compatibilité des navigateurs

Voir aussi