FencedFrameConfig : méthode setSharedStorageContext()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La méthode setSharedStorageContext() de l'interface FencedFrameConfig transmet des données contextuelles du document parent au stockage partagé de l'élément HTML <fencedframe>.

Dans cet article

Une chaîne de caractères représentant les données contextuelles à transmettre au stockage partagé. Une fois définie, cette valeur sera stockée dans la configuration interne de l'instance FencedFrameConfig.

Valeur de retour

Aucune (Undefined).

Exemples

Passage de données contextuelles via setSharedStorageContext()

Vous pouvez utiliser l'API Private Aggregation pour créer des rapports combinant des données d'événement à l'intérieur des cadres protégés avec des données contextuelles du document parent. setSharedStorageContext() peut être utilisé pour transmettre des données contextuelles de l'intégrateur aux worklets de stockage partagé initiés par l'API Protected Audience.

Dans l'exemple suivant, nous stockons des données à la fois depuis la page intégratrice et depuis le cadre protégé dans le stockage partagé.

Dans la page intégratrice, nous allons définir un identifiant d'événement fictif comme contexte de stockage partagé à l'aide de setSharedStorageContext() :

js
const frameConfig = await navigator.runAdAuction({ resolveToConfig: true });

// Données de l'intégrateur à transmettre au worklet de stockage partagé
frameConfig.setSharedStorageContext("id-evenement-fictif");

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

À l'intérieur du cadre protégé, on ajoute le module worklet avec window.sharedStorage.worklet.addModule(), puis on envoie les données d'événement au worklet de stockage partagé via window.sharedStorage.run() (cela n'est pas lié aux données contextuelles du document parent) :

js
const frameData = {
  // Données disponibles uniquement dans le cadre protégé
};

await window.sharedStorage.worklet.addModule("reporting-worklet.js");

await window.sharedStorage.run("send-report", {
  data: {
    frameData,
  },
});

Dans le worklet reporting-worklet.js, on lit l'identifiant d'événement du document parent depuis sharedStorage.context et les données d'événement du cadre depuis l'objet data, puis on les rapporte via Private Aggregation :

js
class ReportingOperation {
  convertEventIdToBucket(eventId) {
    // …
  }
  convertEventPayloadToValue(info) {
    // …
  }

  async run(data) {
    // Données de l'intégrateur
    const eventId = sharedStorage.context;

    // Données du cadre protégé
    const eventPayload = data.frameData;

    privateAggregation.sendHistogramReport({
      bucket: convertEventIdToBucket(eventId),
      value: convertEventPayloadToValue(eventPayload),
    });
  }
}

register("send-report", ReportingOperation);

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

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 5 oct. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

API Fenced Frame
FencedFrameConfig
Méthodes d'instance
1. setSharedStorageContext()
Pages liées à Fenced Frame API
Guides
1. Communication avec les cadres intégrés

FencedFrameConfig : méthode setSharedStorageContext()

Dans cet article

Syntaxe

Paramètres

Valeur de retour

Exemples

Passage de données contextuelles via setSharedStorageContext()

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN