Microsoft Edge で配信元試用版を使用する
配信元の試用版を使用して、限られた期間、独自のライブ サイトで試験的な API を試します。 配信元試用版を使用する場合、サイトにアクセスする Microsoft Edge のユーザーは、試験的な API を使用するコードを実行できます。
使用可能な配信元試用版の一覧を表示し、配信元の試用版を試すために配信元を登録するには、「 Microsoft Edge 配信元試用版」を参照してください。 Web サイトで試験的な API を使用する適合性を評価するには、Microsoft Edge の最小バージョン要件をチェックし、試用版の有効期限をチェックします。
ブラウザー機能のリポジトリの [問題 ] タブを使用して、機能の API の設計、ユース ケース、または機能の API の使用経験に関するフィードバックをブラウザー機能エンジニアと Web 標準コミュニティに提供できます。
配信元の試用版トークンのしくみ
配信元試用版メカニズムを使用すると、Web ページのユーザーは、機能の既定外の状態にもかかわらず、Microsoft Edge ブラウザーで配信元試用版の試験的な機能 API を使用できます。 ユーザーの Microsoft Edge ブラウザーは、配信元試用版のトークンを検出し、トークンが有効な配信元試用版に対応するブラウザーの機能フラグを自動的にオンにします。 ユーザーは Microsoft Edge で edge://flags
を設定する必要はありません。
Web サイトでの配信元試用版の試験的 API の使用をサポートするには:
試験的な機能を使用する配信元ドメイン (たとえば、
https://example.com
) を登録すると、配信元の試用版トークンが自動的に生成されます。トークンを
<head>/<meta>
要素内、またはOrigin-Trial
HTTP サーバー応答ヘッダー内の Web ページにコピーします。Microsoft Edge ユーザーが Web ページにアクセスし、ブラウザーで配信元試用版トークンが見つかると、ブラウザーは関連する配信元試用版機能をオンにします。
配信元試用版の登録
配信元試用版に登録するには:
Microsoft Edge Origin 試用版に移動します。
Ad Selection API 配信元試用版にサインアップするには、代わりに「 Ad Selection API にサインアップする」を参照してください。
アクティブな試用版を選択します。
[ 利用規約に同意する ] ボタンをクリックします。
メッセージが表示されたら、サインインします。 たとえば、GitHub にサインインし、 Microsoft Edge Origin Trials ページでアカウント のサインインを使用することを承認します。
[新しい配信元試用版登録] フォームが開きます。
[ ドメイン ] テキスト ボックスに、ドメイン URL (
https://example.com
など) またはサブドメイン URL (https://beta.example.com
など) を入力します。配信元試用版トークンは、次のいずれかをサポートするように構成できます。
- サブドメインをサポートせずに、
https://example.com
などの 1 つのドメイン。 -
https://beta.example.com
などの単一のサブドメイン。 -
https://example.com
などのドメインとそのサブドメイン (https://beta.example.com
など)。
末尾のパスとクエリ パラメーターはサポートされていません。
https://example.com/path/new-feature
などの後続パスまたはクエリ パラメーターを持つ URI を入力すると、ルート ドメイン (https://example.com
など) またはサブドメインが登録され、後続のパスやクエリ パラメーターは無視されます。- サブドメインをサポートせずに、
[ サブドメインのトークンを有効にする] トグルを設定します 。
サブドメイン (
https://beta.example.com
など) をサポートせずにドメイン (https://example.com
など) で配信元試用版を使用できるようにするには、[サブドメインのトークンを有効にする] トグルがオフになっていることを確認します。特定のサブドメイン (
https://beta.example.com
など) でのみ配信元試用版の使用を有効にするには、[ サブドメインのトークンを有効にする] トグルがオフになっていることを確認します。ドメイン (
https://example.com
など) とそのサブドメイン (https://beta.example.com
など) で配信元試用版の使用を有効にするには、[ サブドメインのトークンを有効にする] トグルをオンにします。
[ 送信 ] ボタンをクリックします。
配信元試用版トークンが生成され、[新しい配信元試用版登録] フォームの近くの [登録] セクションに表示されます。
[ コピー ] ボタンをクリックし、配信元の試用版トークンを安全な場所に貼り付け、目的のドメインに注目します。 この情報は、後でこの Web ページで確認することもできます。
Web サイトでの配信元試用版トークンの使用
次のいずれかの方法で、Web サイトでトークンを使用します。
オプション 1: Web ページの <head> 要素内の<meta> タグ
Web ページの <head>
要素内に、次の <meta>
タグを含めます。
<meta http-equiv="origin-trial" content="EXAMPLE_TOKEN">
EXAMPLE_TOKEN
をトークンに置き換えます。
オプション 2: HTTP サーバー応答の HTTP ヘッダー
HTTP サーバー応答で、次の HTTP ヘッダーを追加します。
Origin-Trial: EXAMPLE_TOKEN
EXAMPLE_TOKEN
をトークンに置き換えます。
配信元の試用実験のオプトアウト
登録されている実験 (配信元試用版) をオプトアウトするには、配信元試用版トークンを <meta>
タグまたはサーバー応答ヘッダーから削除します。
機能検出の実行と正常なフォールバックの提供
配信元の試用版を試験的として扱う。 ベスト プラクティスとして、Web サイト コードで機能検出を実行し、これらのケースに適切なフォールバックを提供します。
- 実験用機能 API がユーザーのブラウザーで使用できない場合。
- 配信元試用版トークンの有効期限が切れた場合。
- Microsoft Edge 機能チームが配信元の試用版を終了した場合。
MDN での機能検出の実装 に関するページを参照してください。
配信元の試用版のテスト localhost
localhost
で配信元と試用版の機能をテストするには、[edge://flags
] に移動し、適切な機能フラグをオンにします。
Microsoft Edge の配信元試用版トークンを検出して使用するメカニズムは、SSL 対応ドメインでのみサポートされ、 localhost
ではサポートされません。
配信元試用版トークンの更新
配信元の試用版トークンの有効期限は、既定では 6 週間です。 配信元試用版トークンの有効期限が切れた場合は、トークンを更新する必要があります。つまり、この配信元試用版の新しい新しいトークンを生成することを意味します。 有効期限が切れる前にトークンを更新できます。
配信元の試用版トークンを更新するには:
Microsoft Edge Origin 試用版に移動します。
Ad Selection API 配信元の試用版については、代わりに「 Ad Selection API にサインアップする」を参照してください。
[ My Registered Trial]\(マイ 登録済み試用版\) セクションで 、配信元の試用版を選択します。
[ 登録 ] セクションで、 期限切れの バッジを含むトークン行で、[ 更新 ] ボタンをクリックします。
新しいトークンが生成され、表示されます。
新しいトークンを含む行で、[ コピー ] ボタンをクリックし、新しいトークンをコードに貼り付けます。
配信元試用版の期間
配信元の試用版は、予定された有効期限日まで続く場合や、早期に終了する場合があります。
スケジュールされた有効期限日
試用版に登録した後、トークンは、配信元試用版の情報カードに表示される試用版の有効期限まで有効なままになります。 配信元試用版の有効期限が切れた後、トークンは機能しなくなり、配信元試用版に関連付けられている機能は出荷の準備ができていると見なされるか、追加の開発のために機能が保留されます。
アーリー エンド
Microsoft Edge 機能チームは、試用の有効期限が切れる前に、実験を早期に終了することを決定できます。例えば:
- セキュリティ インシデントが機能によって発生した場合。
- 機能チームが十分なフィードバックを収集し、現在提案されている API が Web 開発者のニーズを満たしていないと結論付け、大規模な再設計が行われる必要がある場合。
実験が早期に終了した場合、配信元試用版を所有する機能チームは、実験に登録されているすべての開発者に電子メールを送信します。
配信元の試用版に関するフィードバックの提供
実験機能に関するフィードバックをお寄せください。 機能の GitHub リポジトリの [ 問題 ] タブを使用すると、機能の使いやすさと安定性に関するパブリックな談話が可能になります。
配信元の試用版に関するフィードバックを提供するには:
Microsoft Edge Origin 試用版に移動します。
アクティブな試用版を選択します。
[ フィードバック ] ボタンをクリックします。 製品の GitHub リポジトリの [ 問題 ] タブが開きます。
問題を表示します。
新しい問題が必要な場合は、[ 新しい問題 ] ボタンをクリックします。
Ad Selection API 配信元試用版については、「Ad Selection API にサインアップする」の配信元試用版に関するフィードバックを提供する方法に関するページを参照してください。
関連項目
- Microsoft Edge Origin 試用版 - Developer.microsoft.com。
- PWA の実験機能と配信元試用版 - プログレッシブ Web Apps (PWA) の配信元試用版。
広告選択 API:
-
Ad Selection API にサインアップする
- Microsoft Edge Origin Trial - Github.io のポータル(Ad Selection API 配信元試用版のみ)。
外:
- 機能検出の実装 - MDN。
- 配信元の試用版の概要 - Chrome ドキュメント。