Navigator: deprecatedReplaceInURN() メソッド
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates.
Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the <fencedframe> element and related APIs.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
deprecatedReplaceInURN() は Navigator インターフェイスのメソッドで、指定された不透明 URN または FencedFrameConfig の内部 url プロパティに対応する割り当てられた URL 内の指定された文字列を置換します。
FencedFrameConfigまたは不透明なURNは、Protected Audience APIのrunAdAuction()メソッドなどのソースから返され、HTMLFencedFrameElement.config の値として設定します。FencedFrameConfig または不明な URN に関連付けられたコンテンツ URL は、ブラウザーに割り当てられたものとして内部的にマッピングされ、JavaScript でアクセスすることはできません。
しかし、その内部 URL の一部を置き換えることができる場合があります。これは、広告クリエイティブにレンダリングで使用する実行時データを渡す一般的な手法です。 deprecatedReplaceInURN() は、フェンス付きフレーム URL の置換を可能にする一時的な措置として利用できるようになりました。これにより、広告技術プロバイダーが既存の実装をプライバシーサンドボックス API に移行するのに役立ちます。
構文
deprecatedReplaceInURN(UrnOrConfig, replacements)
引数
UrnOrConfig-
対応する内部 URL の一部を置換したい
FencedFrameConfigオブジェクトまたは不透明な URN。 replacements-
内部 URL で置き換えたい内容を表す 1 つ以上のプロパティを持つオブジェクトです。それぞれのプロパティキーは、置き換えたい URL の一部、それぞれのプロパティ値は置き換え後の文字列です。以下の点に注意してください。
- 置き換える URL の一部は、以下のいずれかの形式に従う必要があります。
${string}%%string%%
- URL の一部が正しい形式で記述されているものの、その部分が URL から探し出せない場合、返されたプロミスは履行されますが、置換は行われません。
- 置き換える URL の一部は、以下のいずれかの形式に従う必要があります。
返値
例外
TypeErrorDOMException-
次の場合に発生します。
UrnOrConfigは有効なFencedFrameConfigオブジェクトまたは不明な URN ではない場合。- 指定した交換キーのいずれも、許可された形式と一致しない場合。
例
次の呼び出しを使用して、不透明な URN を返すことができます。
const exampleURN = await navigator.runAdAuction({
...auctionConfig,
resolveToConfig: false,
});
次のように deprecatedReplaceInURN() を呼び出すことで、URL の一部を置き換えることができます。
await navigator.deprecatedReplaceInURN(exampleURN, {
"${foo}": "1",
"${bar}": "2",
"%%baz%%": "3",
});
URN に結び付けられた内部 URL が最初は次のようになっていた場合、
https://example.com/a=${foo}&b=${bar}&c=%%baz%%
置換の後は次のようになります。
https://example.com/a=1&b=2&c=3
仕様書
| 仕様書 |
|---|
| Fenced Frame # dom-navigator-deprecatedreplaceinurn |