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()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

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 via l'API et les autres sont des configs de remplissage qui navigueront 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

Specification
Fenced Frame
# dom-fence-getnestedconfigs

Compatibilité des navigateurs

Voir aussi