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

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

Sam Dutton

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

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

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

試用版に登録すると、Chrome チームから試用版機能の使用に関する具体的なフィードバックを定期的にお尋ねします。機能によっては、フィードバックが組み込まれて調整されるため、複数のオリジン トライアルが行われる場合があります。

オリジン トライアルは Firefox と Microsoft 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）と一致している必要があります。

トークンと拡張機能

バックグラウンド スクリプト、ポップアップ、または画面外ドキュメント内でトライアル機能を使用するには、trial_token を manifest.json ファイルに追加します。

コンテンツ スクリプトは別の方法で処理されます。ある対象物を 1 つの世界に公開する操作は、わかりにくく、直感的でない場合があります。マニフェストの trial_token を使用する代わりに、declaritiveNetRequest を使用してヘッダーを挿入するか、プログラムでコンテンツ スクリプトに直接ヘッダーを挿入して、ページにトークンを追加します。トークンは特定のドメインに関連付けられるため、拡張機能 ID ではなく、コンテンツ スクリプトが実行されているドメインに対してトークンを登録することをおすすめします。

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

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

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

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

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

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

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

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

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

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

デコードされたオリジン トライアルの値を表示するオリジン トライアル デコーダツール。

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

補足説明