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

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

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 のいずれかです。

トークンと拡張機能

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

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

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

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

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

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

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

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

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

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

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

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

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

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

リソース

Chrome のコンセプトに関するドキュメントを引き続きご覧ください。

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

他のブラウザの場合

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

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