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

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

オリジン トライアルでは、新しい機能や試験運用版の機能にアクセスして、一般公開前の期間限定でユーザーが試用できる機能を構築できます。

Chrome で機能のオリジン トライアルが提供されている場合、トライアルに登録すると、オリジンのすべてのユーザーに対して、フラグを切り替えたり、Chrome の代替ビルドに切り替えたりする必要はありません(アップグレードが必要になる場合があります)。オリジン トライアルでは、デベロッパーが新機能を使用してデモやプロトタイプを作成できます。トライアルは、Chrome エンジニアが新機能がどのように使用されているか、他のウェブ技術とどのように相互作用するかを理解するのにも役立ちます。

オリジン トライアルは一般公開されており、すべてのデベロッパーが利用できます。期間と使用には制限があります。参加はセルフマネージド プロセスであり、限られたドキュメントとサポートに限られます。参加者は、利用可能なドキュメントを使用して比較的自立して作業する意思と能力を持っている必要があります。この段階では、API の仕様と説明に限定されている可能性がありますが、可能な限りガイダンスを提供するよう努めています

試用に登録すると、Chrome チームから定期的に試用機能の使用に関するフィードバックをお願いすることがあります。一部の機能については、フィードバックの組み込みと調整により、複数のオリジン トライアルが適用される場合があります。

オリジン トライアルは FirefoxMicrosoft Edge でも利用できます。

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

オリジン トライアルは、通常、ファーストパーティ ベースでのみ利用できます。つまり、登録された単一のオリジンに対してのみ機能します。サードパーティのオリジン トライアルを利用すると、埋め込みコンテンツのプロバイダは、すべてのオリジンのトークンを必要とすることなく、複数のサイトで新機能を試すことができます。

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

非推奨トライアル

すべてのオリジン トライアルが新しい API のテストを目的としたわけではありません。トライアルでは、非推奨の機能を一時的に再度有効にできます。これは非推奨トライアルと呼ばれ、文脈によっては、「リバース オリジン トライアル」と呼ばれることもあります。

たとえば、Chrome 85 以降の AppCache は、デフォルトでは Chrome で使用できなくなりました。AppCache からの移行に時間を要するサイトは、Chrome 93 まで AppCache の使用を継続するための非推奨トライアルに登録できます。

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

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

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

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

プログラムでトークンを提供する

前述のように、トークンをページの HTML に HTTP ヘッダーまたはメタタグとして指定する代わりに、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 です。

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

オリジン トライアルが延長されると、トライアルに登録されているオリジンごとに、登録の更新と新しいトークンの提供を求める警告メールが届きます。

  1. [My Registrations] ページに移動します。

  2. 延長トライアルに登録されているオリジンごとに、[更新] ボタンをクリックします。 [更新] ボタンが表示されている Chrome オリジン トライアルの [マイ登録] ページのスクリーンショット

  3. 新しいトークンをコピーし、トライアルへの登録を維持するすべてのページで使用できるようにします。必要に応じて複数のトークンを指定できます。無効なトークンや期限切れのトークンは無視されます。

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

Chrome DevTools の [Application] パネルから、ページで使用できるオリジン トライアルに関する情報を確認できます。

Chrome DevTools の [Application] パネルのフレームの詳細ビューに表示された、サイトのオリジン トライアル情報。

オリジン トライアル トークン デコーダを使用して、トークンにエンコードされたデータを表示することもできます。

デコードされたオリジン トライアルの値が表示されているオリジン トライアル デコーダツール

オリジン トライアルのデモ

補足説明