Navigator: метод deprecatedReplaceInURN()

Метод deprecatedReplaceInURN() интерфейса Navigator заменяет указанные строки внутри сопоставленного URL, соответствующего заданному непрозрачному URN или внутреннему свойству FencedFrameConfig url.

Непрозрачный URN возвращается из источника, например, из метода Protected Audience API runAdAuction(), и затем устанавливается в качестве значения для HTMLFencedFrameElement.config. Соответствующий URL-адрес содержимого FencedFrameConfig или непрозрачного URN отображается внутри браузера и недоступен через JavaScript.

Однако вы можете заменить части этого внутреннего URL-адреса. Это распространенный подход для передачи данных выполнения в креативы рекламы для использования при рендеринге. deprecatedReplaceInURN() был предоставлен как временная мера для включения такой замены для URL-адресов fenced frame, помогая поставщикам рекламной технологии мигрировать существующие реализации в API песочницы конфиденциальности.

UrnOrConfig

Объект FencedFrameConfig или непрозрачный URN, для которого вы хотите заменить части соответствующего внутреннего URL-адреса.

replacements

Объект, содержащий одну или несколько свойств, представляющих замены, которые вы хотите внести во внутренний URL. Каждый ключ свойства — это часть URL, которую вы хотите заменить, а каждое значение свойства — это строка, на которую вы хотите ее заменить. Обратите внимание, что:

• Части URL-адреса для замены должны быть в одном из следующих форматов:
  • ${string}
  • %%string%%
• Если часть URL-адреса имеет правильный формат, но часть не найдена в URL-адресе, возвращаемое promise все равно выполняется, но замена не выполняется.

Promise, которое выполняется с undefined.

TypeError DOMException

Выбрасывается, если:

• UrnOrConfig не является допустимым объектом FencedFrameConfig или непрозрачным URN.
• Любой из указанных ключей замены не соответствует разрешенным форматам.

Следующий вызов может быть использован для возвращения непрозрачного URN:

const exampleURN = await navigator.runAdAuction({
  ...auctionConfig,
  resolveToConfig: false,
});

Затем вы можете заменить части URL-адреса с помощью вызова deprecatedReplaceInURN() следующим образом:

await navigator.deprecatedReplaceInURN(exampleURN, {
  "${foo}": "1",
  "${bar}": "2",
  "%%baz%%": "3",
});

Если начальный внутренний URL, связанный с URN, имеет вид:

https://example.com/a=${foo}&b=${bar}&c=%%baz%%

После замены он станет:

https://example.com/a=1&b=2&c=3

• API fenced frame