オリジン トライアルを使ってみる

新しいウェブ プラットフォーム機能または試験運用版のウェブ プラットフォーム機能をテストします。

Sam Dutton

オリジン トライアルでは、新しい機能や試験運用版の機能をご利用いただけます。この機能をテストして、期間限定でユーザーに提供できます。トライアルが完了し、フィードバックが評価されると、Chrome はその機能をすべてのユーザーが利用できるようにするかどうかを決定します。

オリジン トライアルに登録すると、 オリジン上のすべてのユーザーに対して機能を有効にできます。ユーザーは、フラグを切り替えたり、Chrome の代替ビルドに切り替えたりする必要はありません（アップグレードが必要になる場合があります）。登録すると、デベロッパーは新機能を使用してデモやプロトタイプを作成できます。また、トライアルは、Chrome エンジニアが新機能の使用方法や、他のウェブ テクノロジーとの連携方法を把握するのに役立ちます。

対象

オリジン トライアルは一般公開されており、すべてのデベロッパーが参加できます。期間と使用量には上限があります。参加は自己管理プロセスであり、ドキュメントとサポートは限定的です。参加者は、現時点で API 仕様と解説に限定される可能性のあるドキュメントを使用して、比較的独立して作業できる必要があります。可能な限り ガイダンスを提供するよう努めています。

トライアルに登録すると、Chrome チームからトライアル機能の使用に関する具体的なフィードバックを定期的に求められます。フィードバックが組み込まれ、調整が行われるため、一部の機能では複数のオリジン トライアルが実施されることがあります。

オリジン トライアルは、 Firefox と Microsoft Edgeでも利用できます。

サードパーティのオリジン トライアル

デフォルトでは、オリジン トライアル機能は、トライアルに登録された オリジンでのみ使用できます。 一部のトライアルでは、登録時に サードパーティのマッチタイプ オプションが用意されています。これにより、埋め込みコンテンツやサービスのプロバイダは、オリジンごとにトークンを必要とせずに、複数のサイトで新機能を試すことができます。

詳細: サードパーティのオリジン トライアルとは

デプリケーション トライアル

一部のオリジン トライアルでは、非推奨の機能を一時的に再度有効にできます。 これらは「デプリケーション トライアル」と呼ばれます。 コンテキストによっては、「リバース」オリジン トライアルと呼ばれることもあります。

たとえば、ミューテーション イベントが削除されました 。Chrome 127 以降です。これらの イベントを削除するまでに時間がかかるサイトは、 デプリケーション トライアル に登録して、指定したサイトでイベントを一時的に再度有効にできます。

オリジン トライアルに参加する

  1. 有効なトライアルの 一覧からオリジン トライアルを 選択します。
  2. [登録] ボタンをクリックしてフォームに必要事項を記入し、トークンをリクエストします。
  3. トライアル機能を有効にするウェブページごとにトークンを指定します。
  4. 新機能を試してみます。
  5. フィードバックを送信します。オリジン トライアル サイトから送信してください。このフィードバックは公開されず、Chrome チームの一部のメンバーのみが利用できます。各トライアルには、コミュニティからの自発的なフィードバック用のリンクも用意されています。 通常、GitHub または他の公開チャンネルの機能にリンクしています。
  6. トークンの有効期限が切れると、更新リンクが記載されたメールが届きます。更新するには、フィードバックを再度送信する必要があります。

同じオリジン トライアルに複数のオリジンで複数回登録し、同じページに複数のトークンを含めることができます。これは、所有する複数のサイトに含まれるコードなど、異なるオリジンから提供されるリソースに対して有効なトークンを提供する必要がある場合に便利です。

オリジン トライアル フレームワークは、最初の有効なトークンを探し、他のすべてのトークンを無視します。これは Chrome DevTools で検証できます。

プログラムでトークンを指定する

前述のように、トークンを HTTP ヘッダーまたはページの HTML のメタタグとして指定する代わりに、JavaScript でトークンを挿入できます。

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

この方法は、サードパーティの トライアルに参加している場合に使用します。

トークンと iframe

iframe からトライアル機能にアクセスするには、 メタタグ、HTTP ヘッダー、またはプログラムでトライアル トークンを指定します。

すべてのトークンの使用と同様に、トークンに登録されたオリジンは、トライアル機能にアクセスする JavaScript の コンテキストと一致する必要があります。つまり、インライン スクリプトを含む ページのオリジン、または外部ファイルから含まれる JavaScript の <script> 要素の src です。

トークンと拡張機能

バックグラウンド スクリプト、 ポップアップ、 サイドパネル、または オフスクリーン ドキュメント内でトライアル機能を使用するには、 trial_tokens キーを manifest.json ファイルで使用します。

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

コンテンツ スクリプトの処理は 異なります。1 つの ワールドに機能を公開すると、 混乱を招き、直感的でなくなる可能性があります。マニフェストの trial_token を使用する代わりに、次のいずれかの方法でトークンをページに追加します。

トークンは特定のドメインに関連付けられているため、拡張機能 ID ではなく、コンテンツ スクリプトが実行されているドメインに登録する必要があります。

トライアルに拡張機能を登録するには、URL chrome-extension://YOUR_EXTENSION_ID（例: chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk）を使用します。

オリジン トライアルの登録を更新する

オリジン トライアルが延長された場合は、登録を更新し、トライアルに登録されているオリジンごとに新しいトークンを指定する必要があることを示すメールが届きます。

  1. [登録] に移動します。
  2. 延長されたトライアルに登録されているオリジンごとに、[**更新**] をクリックします。 [My Registrations] ページの例（[RENEW] ボタンが表示されている）
  3. 新しいトークンをコピーして、トライアルに登録したままにする必要があるすべてのページで使用できるようにします。必要に応じて、複数のトークンを指定できます。

無効なトークンまたは期限切れのトークンは無視されます。

オリジン トライアルの情報を表示する

サイトで利用可能なオリジン トライアルに関する情報は、 [Application] パネルで Chrome DevTools から確認できます。

Chrome DevTools の [Application] パネルのフレームの詳細ビュー。

オリジン トライアルの機能

以下は、現在実施中のオリジン トライアルの API のデモです。

リソース

Chrome のコンセプト ドキュメントをご覧ください。

Chrome のオリジン トライアルの詳細:

他のブラウザの場合

他のブラウザのオリジン トライアルを確認する:

前へ
Chrome のバリエーション
次へ
サードパーティのオリジン トライアル