Web サイトからの Microsoft Edge の検出

[アーティクル]
01/04/2024

Microsoft Edge を使用すると、Web サイトでユーザーエージェント情報を取得できます。ユーザーエージェント情報を使用して、各ユーザーのブラウザーの Web ページを正しく表示します。ブラウザーは、Web サイトがブランド、バージョン番号、ホストオペレーティングシステムなどのブラウザー情報を検出するためのメカニズムを提供します。

ユーザーエージェントクライアントヒント は、ブラウザー情報を取得するための最良の方法です。以下の「ユーザーエージェントクライアントヒント」を参照してください。
ユーザーエージェント文字列 は、ブラウザー情報を取得するための従来の方法です。これらは古く、Web サイトの互換性の問題を引き起こした歴史があります。以下の「ユーザーエージェント文字列」を参照してください。

ブラウザーに基づいてユーザーにさまざまなエクスペリエンスを提供したい場合があります。たとえば、サイトで使用するように Microsoft Edge または別のブラウザーを構成する方法に関する手順を含める場合は、ブラウザーを検出して適切なコンテンツを表示できます。

ブラウザー検出のメカニズム:

メカニズム	サーバー側	クライアント側
ユーザーエージェントクライアントヒント (推奨)	`Sec-CH-UA` HTTPS ヘッダー	`navigator.userAgentData` JavaScript メソッド
ユーザーエージェント文字列 (レガシ)	`User-Agent` HTTPS ヘッダー	`navigator.userAgent` JavaScript メソッド

機能の検出

Microsoft では、ブラウザーを検出するのではなく、可能な限りブラウザーで機能がサポートされているかどうかを検出することをお勧めします。

ブラウザーを検出する必要がある場合は、次のように、User-Agent クライアントヒントと機能検出を使用することをお勧めします。

クライアントヒントの User-Agent

Microsoft Edge では、User-Agent クライアントヒントがサポートされています。

User-Agent クライアントヒントは、Web ページがブラウザー名、バージョン番号、プラットフォームなどのブラウザー情報を検出できるようにしながら、プライバシーに関する問題に対処する方法です。間もなく、User-Agent 文字列は固定され、さまざまなブラウザーによって非推奨になります。たとえば、Chrome プラットフォームの状態サイトでは、「機能: ユーザーエージェントの文字列情報を減らす」の変更について説明します。

次の場合 User-Agent クライアントヒントを使用します。

新しいブラウザーアクティビティが想定されるユーザーからのかどうかを判断します。
ユーザーがこのサイトを初めて使用する場合は、ヒントまたは手順をカスタマイズします。

User-Agent クライアントヒントを使用して次の手順を実行しないでください。

サポートされていないブラウザーをブロックします。
サイト上の機能へのアクセスを制限します。

詳細については、「 W3C コミュニティグループドラフトレポート: User-Agent クライアントヒント」の仕様を参照してください。

User-Agent クライアントヒント HTTPS ヘッダー

Microsoft Edge は、HTTPS 要求をサーバーに送信すると、クライアントヒントヘッダー User-Agent 低エントロピのセットを送信します。詳細については、「低エントロピヒントテーブル」を参照してください。サーバーでブラウザーに関するより詳細な情報が必要な場合、その応答にはヘッダーが Accept-CH 含まれます。その応答ヘッダーの値は、サーバーがブラウザーから必要とするすべてのクライアントヒント要求ヘッダー (など Accept-CH: Sec-CH-UA-Full-Version,Sec-CH-UA-Platform-Version) のコンマ区切りのリストです。サーバーに対する次の Microsoft Edge HTTPS 要求には、指定された User-Agent クライアントヒントヘッダーが含まれます。

既定では、Microsoft Edge は、、、および Sec-CH-UA-Platform 要求ヘッダーを次の形式で送信Sec-CH-UASec-CH-UA-Mobileします。

Sec-CH-UA: "Chromium";v="92", "Microsoft Edge";v="92", "Placeholder;Browser Brand";v="99"
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Platform: "Windows"

次の表は、使用可能なすべてのヒント要求ヘッダーとサンプル値を示しています。

User-Agent 要求ヘッダー	応答値 User-Agent 例
`Sec-CH-UA`	`"Not_A Brand";v="8", "Chromium";v="120", "Microsoft Edge";v="120"`
`Sec-CH-UA-Mobile`	`?0`
`Sec-CH-UA-Full-Version`	`120.0.2210.91`
`Sec-CH-UA-Platform`	`Windows`
`Sec-CH-UA-Platform-Version`	`15.0.0`
`Sec-CH-UA-Arch`	`x86`
`Sec-CH-UA-Bitness`	`64`
`Sec-CH-UA-Model`	`Surface Pro`

User-Agent クライアントヒントは、を使用して HTTPSセキュリティで保護された接続経由でのみ送信されます。

User-Agent クライアントヒント JavaScript API

クライアント側 User-Agent JavaScript を使用して、クライアントヒントにアクセスできます。既定 navigator.userAgentDataを呼び出すと、次の応答が返されます。

{
  "brands": [
    {
      "brand": "Not_A Brand",
      "version":"8"
    },
    {
      "brand": "Chromium",
      "version":"120"
    },
    {
      "brand": "Microsoft Edge",
      "version":"120"
    }
  ],
  "mobile": false,
  "platform": "Windows"
}

など platform、より詳細な情報を要求を送信するには、次のコードを使用します。

navigator.userAgentData.getHighEntropyValues([
  "architecture",
  "platform",
  "platformVersion",
  "uaFullVersion"
]).then(ua => {
  console.log(ua)
});

応答の形式は次のとおりです。

{
  "architecture": "x86",
  "brands": [
    {
      "brand": "Not_A Brand",
      "version": "8"
    },
    {
      "brand": "Chromium",
      "version": "120"
    },
    {
      "brand": "Microsoft Edge",
      "version": "120"
    }
  ],
  "mobile": false,
  "platform": "Windows",
  "platformVersion": "15.0.0",
  "uaFullVersion": "120.0.2210.91"
}

詳細については、MDN の NavigatorUAData: getHighEntropyValues() メソッドに関するページを参照してください。

platformVersion ヒント

ヘッダーのUser-Agentオペレーティングシステムバージョントークンは、Windows 11用に更新されておらず、引き続きを報告しますWindows NT 10.0。

Windows 10とWindows 11を区別するには、Microsoft Edge でクライアントヒントをplatformVersion要求します。とを含む1.0.0値は12.0.0Windows 10のリリースを表し、以降の14.0.0値はWindows 11のリリースを表します。

User-Agent クライアントヒントと機能検出の組み合わせ

User-Agent クライアントヒントと機能検出を組み合わせることは、互換性のある Web コンテンツを配信するための効果的な方法です。 Microsoft では、次のパターンを使用することをお勧めします。

コードの保守性を向上させます。
コードの脆弱性を軽減します。
User-Agent 文字列への変更によるコードの破損を減らします。

Chrome に似たブラウザーをチェックする必要がある場合は、Microsoft Edge を強化するChromiumエンジンである、を検出することをお勧めします。

ブランドを確認し、影響をChromium受けるすべてのChromium ベースのブラウザーに検出を適用するには、次の方法を使用します。

function isChromium() {
  for (brand_version_pair of navigator.userAgentData.brands) {
    if (brand_version_pair.brand == "Chromium"){
      return true;
    }
  }
  return false;
}

上記の方法を使用して、特定のインデックスでのブランドのハードコーディングチェックを回避します。ブランド名の表示順序は、時間の経過と同時に変更される可能性があります。

機能検出を使用できない場合は、検証に既知のChromium ベースのブラウザーのハードコーディングされた一覧を使用しないでください。ハードコーディングされたブラウザー名の例には Microsoft Edge 、とがあります Google Chrome。以降のバージョンのChromiumバグの修正は避ける必要があり、影響を受けるブラウザーの検出が困難であるため、機能検出を利用できない場合があります。

User-Agent 文字列

User-Agent 文字列は古く、Web サイトの互換性の問題を引き起こした長い歴史があります。

可能な限り、Microsoft では、User-Agent 文字列に基づく Microsoft Edge ブラウザー検出ロジックの使用を最小限に抑えることが推奨されます。ブラウザーを検出する理由が十分にある場合、Microsoft Edge チームは、ユーザーエージェントクライアントヒントをプライマリ検出ロジックとして使用することをお勧めします。また、ユーザーエージェントクライアントヒントを使用すると、ブラウザー検出コードの複雑さが軽減されます。

レガシ参照の場合は、次の情報が User-Agent 文字列に含まれていました。

Windows では、HTTP 要求ヘッダーには次のものが User-Agent 含まれます。

Mozilla/5.0 (Windows NT 10.0; Win64; x64)
AppleWebKit/537.36 (KHTML, like Gecko)
Chrome/120.0.0.0
Safari/537.36
Edg/120.0.0.0

Android では、HTTP 要求ヘッダーには次のものが User-Agent 含まれます。

Mozilla/5.0 (Linux; Android 10; K)
AppleWebKit/537.36 (KHTML, like Gecko)
Chrome/120.0.0.0
Mobile Safari/537.36
EdgA/120.0.0.0

メソッドからの navigator.userAgent 応答値は、次の形式を使用します。

"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0"

プラットフォーム識別子はオペレーティングシステムに基づいて変更され、バージョン番号は時間の経過と同時に増加します。形式は、Chromium ユーザーエージェントと同じであり、最後に新Edgしいトークンが追加されます。 Microsoft は、以前に Edg EdgeHTML に基づく従来の Microsoft Edge ブラウザーで使用されていた文字列による Edge 互換性の問題を回避するために、トークンを選択しました。トークンは Edg 、iOS と Android に使用される既存のトークンとも一致します。

さまざまなプラットフォームでの Microsoft Edge の識別子

デスクトップオペレーティングシステムでは、Microsoft Edge は通常、User-Agent 文字列内のトークンによって Edg 識別されます。ただし、一部のデバイスプラットフォームでは、次のように、Microsoft Edge 用の別のトークンが使用されます。

プラットフォーム	識別子トークン
デスクトップ (Windows/Mac/Linux)	`Edg`
iPhone/iPad	`EdgiOS`
Android (モバイル/タブレット)	`EdgA`

Microsoft Edge 従来版はサポートされなくなりました。詳細については、「Microsoft Edge 従来版」セクションを参照してください。

User-Agent 文字列を展開されたブラウザー名にマップする

User-Agent 文字列トークンを、コードで使用する人間が判読できるブラウザー名にマップします。この方法は、Web 全体で一般的です。トークンをEdgブラウザー名にマップする場合、Microsoft では、従来の Microsoft EdgeHTML ブラウザーで使用される名前とは異なる名前を使用して、Chromium ベースのブラウザーに適用されない従来の回避策を誤って適用しないようにすることをお勧めします。

User-Agent オーバーライド

Web サイトで Microsoft Edge ユーザーエージェントが認識されない場合があります。その結果、Web サイトの一連の機能が正しく動作しない可能性があります。問題の種類について Microsoft に通知されると、Microsoft はユーザー (Web サイトの所有者) に連絡し、更新されたユーザーエージェントについて通知します。

Microsoft によって報告された問題に対処するために、Web サイトのユーザーエージェント検出ロジックを更新してテストするために、さらに時間がかかる場合があります。ユーザーの互換性を最大化するために、Microsoft Edge Betaチャネルと安定チャネルでは、ユーザーエージェントのオーバーライドの一覧が使用されます。 Web サイトを更新するときに、ユーザーエージェントのオーバーライドを使用します。ユーザーエージェントのオーバーライドの一覧は、Microsoft によって提供されます。

オーバーライドでは、特定の Web サイトの既定のユーザーエージェントではなく、Microsoft Edge が送信する新しいユーザーエージェントの値を指定します。現在適用されているユーザーエージェントのオーバーライドの一覧を表示するには:

Microsoft Edge Betaまたは安定したチャネルを開きます。
edge://compat/useragentに移動します。

Microsoft Edge Canary チャネルと Dev チャネルは、現在、ユーザーエージェントのオーバーライドを受け取りません。 Microsoft Edge Canary および Dev チャネルには、既定の Microsoft Edge ユーザーエージェントを使用する環境が用意されています。 Microsoft Edge Canary チャネルと Dev チャネルを使用して、既定の Microsoft Edge ユーザーエージェントによる Web サイトの問題を再現します。

Microsoft Edge Betaまたは安定チャネルでユーザーエージェントのオーバーライドをオフにするには:

コマンドプロンプトを開きます。たとえば、Windows 検索テキストボックスに 「cmd 」と入力し、 コマンドプロンプト アプリを選択します。

次のコードをコピーします。

--disable-domain-action-user-agent-override

コピーしたコードを使用して、次のように Microsoft Edge アプリを実行します。
```
{path/to/microsoft/edge.ext} --disable-domain-action-user-agent-override
```

Microsoft Edge レガシ

従来のブラウザーに関する考慮事項:

Microsoft Edge 従来版ブラウザーはサポートされなくなりました。 Microsoft Edge 従来版を置き換えるには、ブログ記事「新しい Microsoft Edge」を参照してください。
Microsoft Edge 従来版はWindows 10でのみ使用できます。
この記事で説明するすべての User-Agent メカニズムのうち、Microsoft Edge 従来版でサポートされている唯一のブラウザー固有のメカニズムは、User-Agent 文字列です。
Microsoft Edge 従来版の User-Agent 文字列には、トークンがEdge含まれています。

Microsoft Edge 従来版 User-Agent文字列の完全な形式の例:Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.102 Safari/537.36 Edge/18.19582

次の方法で共有

Web サイトからの Microsoft Edge の検出

機能の検出

クライアントヒントの User-Agent

User-Agent クライアントヒント HTTPS ヘッダー

User-Agent クライアントヒント JavaScript API

platformVersion ヒント

User-Agent クライアントヒントと機能検出の組み合わせ

User-Agent 文字列

さまざまなプラットフォームでの Microsoft Edge の識別子

User-Agent 文字列を展開されたブラウザー名にマップする

User-Agent オーバーライド

Microsoft Edge レガシ

関連項目

フィードバック

その他のリソース

次の方法で共有

Web サイトからの Microsoft Edge の検出

機能の検出

クライアント ヒントの User-Agent

User-Agent クライアント ヒント HTTPS ヘッダー

User-Agent クライアント ヒント JavaScript API

platformVersion ヒント

User-Agent クライアント ヒントと機能検出の組み合わせ

User-Agent 文字列

さまざまなプラットフォームでの Microsoft Edge の識別子

User-Agent 文字列を展開されたブラウザー名にマップする

User-Agent オーバーライド

Microsoft Edge レガシ

関連項目

フィードバック

その他のリソース

クライアントヒントの User-Agent

User-Agent クライアントヒント HTTPS ヘッダー

User-Agent クライアントヒント JavaScript API

User-Agent クライアントヒントと機能検出の組み合わせ