Navigator: deprecatedReplaceInURN() method

Syntax

deprecatedReplaceInURN(UrnOrConfig, replacements)

Parameters

UrnOrConfig

A FencedFrameConfig object or an opaque URN for which you want to substitute parts of the corresponding internal URL.

replacements

An object containing one or more properties representing the substitutions you wish to make in the internal URL. Each property key is a URL subsection you wish to replace, and each property value is the string to replace it with. Note that:

• The URL subsections to replace must be in one of the following formats:
  • ${string}
  • %%string%%
• If a URL subsection is in a correct format, but the subsection is not found in the URL, the returned promise still fulfills but no substitution is made.

Return value

A Promise that fulfills with undefined.

Exceptions

TypeError DOMException

Thrown if:

• UrnOrConfig is not a valid FencedFrameConfig object or opaque URN.
• Any of the specified replacement keys do not match the allowed formats.

Examples

The following call could be used to return an opaque URN:

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

You can then substitute URL subsections using a deprecatedReplaceInURN() call like the following:

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

If the internal URL associated with the URN is initially:

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

After the substitution it will become:

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

Specifications

Browser compatibility

See also

• Fenced Frame API