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

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

Sam Dutton

オリジン トライアルでは、新しい機能や試験運用版の機能をご利用いただけます。一般公開に先立って、ユーザーが一定期間試用できる機能を構築できます。

Chrome で機能の試験運用版が提供されている場合は、試験運用版に登録して、オリジンのすべてのユーザーに対して機能を有効にできます。ユーザーがフラグを切り替えたり、別の Chrome ビルドに切り替えたりする必要はありません（ただし、アップグレードが必要な場合があります）。オリジン トライアルでは、デベロッパーは新しい機能を使用してデモやプロトタイプを構築できます。また、Chrome エンジニアは、新機能がどのように使用され、他のウェブ テクノロジーとどのように相互作用するかを理解するためにもトライアルを利用できます。

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

試用版に登録すると、Chrome チームから、試用版機能の使用に関する具体的なフィードバックを定期的にお願いするメッセージが届きます。一部の機能では、フィードバックを取り入れて調整を行い、複数のオリジン トライアルが行われる場合があります。

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

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

通常、オリジン トライアルはファースト パーティでのみ利用できます。登録済みの 1 つのオリジンでのみ機能します。サードパーティのオリジン トライアルを使用すると、埋め込みコンテンツのプロバイダは、オリジンごとにトークンを用意しなくても、複数のサイトで新機能を試すことができます。

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

非推奨トライアル

すべてのオリジン トライアルが新しい API のテスト用というわけではありません。一部のトライアルでは、非推奨の機能を一時的に再度有効にできます。これらは非推奨トライアルと呼ばれ、一部のコンテキストでは「リバース」オリジン トライアルと呼ばれています。

たとえば、Chrome 85 以降、Chrome で AppCache をデフォルトで使用できなくなりました。AppCache からの移行に時間を要する場合は、Chrome 93 までデプリケーション トライアルに登録して AppCache を引き続き使用できます。

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

  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 を使用する代わりに、declarativeNetRequest を使用してヘッダーを挿入するか、コンテンツ スクリプトにプログラムで直接トークンを追加します。トークンは特定のドメインに関連付けられているため、拡張機能 ID ではなく、コンテンツ スクリプトが実行されているドメインにトークンを登録する必要があります。

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

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

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

  1. [登録情報] ページに移動します。

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

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

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

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

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

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

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

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

補足説明