HTMLFencedFrameElement: свойство config

Свойство config элемента HTMLFencedFrameElement содержит объект FencedFrameConfig, который представляет навигацию фрейма <fencedframe>, то есть, какой контент будет отображаться в нём. Объект FencedFrameConfig возвращается из источника, такого как API защищённой аудитории.

Значение config по умолчанию null.

При установке значения в объект FencedFrameConfig, внутренние свойства FencedFrameConfig (например, mappedURL) определяют, что загружается внутри связанного <fencedframe>. Кроме того:

• Тип навигации будет "replace" (см. NavigateEvent.navigationType), что означает, что текущая запись истории заменяется новой записью, а не добавляется новая запись истории.
• Свойство Referrer-Policy навигации устанавливается в значение "no-referrer".

Для определения содержимого, которое будет отображаться в <fencedframe>, используемое API (например, Защищённая аудитория или Общий хранилище) генерирует объект FencedFrameConfig, который затем устанавливается как значение свойства <fencedframe> объекта config.

В следующем примере из аукциона объявлений API защищённой аудитории извлекается FencedFrameConfig, который затем используется для отображения выигравшего объявления в <fencedframe>:

const frameConfig = await navigator.runAdAuction({
  // ...auction configuration
  resolveToConfig: true,
});

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

• Фреймы на developers.google.com
• Песочница конфиденциальности на developers.google.com