功能和EdgeOptions

2025-06-21

功能是您可以用來自定義和設定工作階段的 EdgeDriver 選項。若要瞭解如何啟動新的 EdgeDriver 會話，請參閱自動化 Microsoft Edge。本文說明 Microsoft Edge 的所有支援功能，並提供將功能傳遞至 EdgeDriver 會話的詳細數據。

功能會以 JSON 對應的形式傳遞至 WebDriver 會話，但不需要或建議以這種方式進行設定。 Selenium (等 WebDriver 測試架構) 提供通常具有便利方法的語言系結，因此您不需要自行設定 JSON 對應。例如，Selenium 會透過 EdgeOptions 類別設定功能。

若要深入瞭解如何設定功能，請參閱您慣用 WebDriver 測試架構的檔。如需詳細資訊，請參閱選擇 WebDriver 測試架構。

使用 EdgeOptions 類別

建立的 EdgeOptions實例，以提供便利的方法來設定Microsoft Edge 特定功能。 EdgeOptions設定物件之後，請傳EdgeOptions入EdgeDriver建構函式。

var options = new EdgeOptions();
options.AddExtensions("/path/to/extension.crx");
var driver = new EdgeDriver(options);

若要使用沒有相關聯便利性方法的功能，請使用 AddAdditionalEdgeOption 方法。您必須傳遞功能的完整名稱，以及具有正確類型的值。如需接受的功能和實值類型的完整清單，請參閱 EdgeOptions物件。

options.AddAdditionalEdgeOption("wdpAddress", "remotehost:50080");

辨識的功能

如需 EdgeDriver 接受的標準功能，請參閱 Selenium 檔和 W3C WebDriver 標準。本文僅列出 Microsoft Edge 專屬的功能。

EdgeOptions 物件

大部分Microsoft Edge 特定功能都是透過 EdgeOptions 對象公開。在某些語言中，這些功能是由類別實作 EdgeOptions 。在其他語言中，這些功能會儲存在DesiredCapabilities的ms:edgeOptions字典下。

功能	類型	詳細資料
`args`	字串清單	要在啟動時傳遞至Microsoft Edge進程的命令行自變數清單。具有相關聯值的自變數應該以 `=` 符號 (分隔，例如， `['start-maximized', 'user-data-dir=/tmp/temp_profile']`) 。如果您要啟動 WebView2 應用程式，則這些自變數會傳遞至您的應用程式，而不是基礎Microsoft Edge 瀏覽器程式。若要在啟動 WebView2 應用程式時將自變數傳遞至瀏覽器程式，請改用 webviewOptions.additionalBrowserArguments 。
`binary`	字串	要在macOS上使用 (的 Microsoft Edge 二進位檔路徑，路徑應該是實際的二進位檔，而不只是應用程式。例如， `/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge`) 。
`debuggerAddress`	字串	要連接之除錯程式伺服器的位址，格式 `hostname/ip:port`為，例如 `127.0.0.1:38947`。
`detach`	布林值	預設值 = `false`。如果 `false`為，Microsoft Edge 會在 WebDriver 服務關閉時結束，即使 WebDriver 本機端尚未關閉工作階段也一般。如果 `true`為，Microsoft只有在 WebDriver 本機端關閉工作階段時，Edge 才會結束。如果 `true`和 WebDriver 本機端未關閉工作階段， `EdgeDriver` 則不會清除 Microsoft Edge 實例所使用的暫存使用者資料資料資料夾。
`excludeSwitches`	字串清單	啟動 Microsoft Edge 時，預設會切換Microsoft Edge 命令行參數來排除該 EdgeDriver。避免參數 `--` 的前置詞。
`extensions`	字串清單	要在啟動時安裝的擴充功能清單。清單中的每個項目都應該是base-64編碼的封裝延伸模組 (`.crx`) 。
`localState`	字典	字典，其中每個專案都包含喜好設定的名稱和值。喜好設定會套用至用戶數據資料夾中的本機狀態檔案。
`minidumpPath`	字串	要儲存Microsoft Edge 小型傾印的目錄。 (僅在Linux.) 上支援
`mobileEmulation`	字典	具有的值或和值`deviceName`的`deviceMetricsuserAgent`字典。
`perfLoggingPrefs`	字典	指定效能記錄喜好設定的選擇性字典。如需詳細資訊，請參閱 perfLoggingPrefs 物件。
`prefs`	字典	字典，其中每個專案都包含喜好設定的名稱和值。喜好設定只會套用至使用中的使用者配置檔。如需範例，請參閱 `Preferences` Microsoft Edge 使用者數據資料夾中的檔案。
`wdpAddress`	字串	要連線的 Windows Device Portal 伺服器位址，格式 `hostname/ip:port`為，例如 `127.0.0.1:50080`。如需詳細資訊，請參閱遠端偵錯 - Windows 10 裝置。
`wdpPassword`	字串	連接到 Windows Device Portal 伺服器時所要使用的選擇性密碼。如果伺服器已啟用驗證，則為必要專案。
`wdpUsername`	字串	連接到 Windows Device Portal 伺服器時要使用的選用使用者名稱。如果伺服器已啟用驗證，則為必要專案。
`wdpProcessId`	整數	附加至執行中的 WebView2 UWP 應用程式時所要使用的必要行程識別碼，例如 `36590`。您可以在上的 `http://<Device Portal URL>/msedge`中`browserProcessId`找到這項資訊。
`webviewOptions`	字典	選擇性字典，可用來在啟動 WebView2 應用程式時設定 WebView2 環境。如需詳細資訊，請參閱 webviewOptions 物件。
`windowsApp`	字串	要啟動之 Microsoft Edge 應用程式套件的應用程式使用者模型識別碼，例如 `Microsoft.MicrosoftEdge.Stable_8wekyb3d8bbwe!MSEDGE`。使用 `windowsApp` Windows 裝置入口網站連線到 Windows 10X 裝置或模擬器時，請使用，而不是 `binary` 。
`windowTypes`	字串清單	視窗控點清單中顯示的視窗類型清單。若要存取 Android Webview 元素，請包含 `webview` 在清單中。

perfLoggingPrefs 物件

字 perfLoggingPrefs 典具有下列格式。所有索引鍵都是選擇性的。

機碼	類型	預設值	詳細資料
`bufferUsageReportingInterval`	正整數	1000	DevTools 追蹤緩衝區使用事件之間的要求毫秒數。例如，如果 1000，則每秒一次，DevTools 會報告追蹤緩衝區的完整程度。如果報表指出緩衝區使用量為 100%，則會發出警告。
`enableNetwork`	布林值	真	收集 (或不從網路網域收集) 事件。
`enablePage`	布林值	真	收集 (或不從Page網域收集) 事件。
`traceCategories`	字串	(空)	要收集追蹤事件的Microsoft Edge 追蹤類別的逗號分隔字串。未指定或空的字串會停用追蹤。

webviewOptions 物件

此 webviewOptions 字典用來在啟動 WebView2 應用程式時設定 WebView2 環境。它具有下列格式。所有索引鍵都是選擇性的。

機碼	類型	預設值	詳細資料
`browserExecutableFolder`	字串	(空)	包含要使用之固定版本 WebView2 執行時間的資料夾路徑。如需搭配 WebView2 使用固定版本運行時間散發的詳細資訊，請參閱散發 WebView2 應用程式和 WebView2 運行時間。
`userDataFolder`	字串	(空)	WebView2 將使用的用戶資料資料夾路徑。如果 `userDataFolder` 未指定，Microsoft Edge WebDriver 會建立暫時的用戶數據資料夾。如需使用 WebView2 管理使用者資料資料資料夾的詳細資訊，請參閱管理使用者資料資料資料夾。
`additionalBrowserArguments`	字串清單		WebView2 將在啟動時傳遞至瀏覽器進程的命令行自變數清單。具有相關聯值的自變數應該以 `=` 符號 (分隔，例如， `['start-maximized', 'log-level=0']`) 。
`releaseChannelPreference`	字串		要使用的慣用 WebView2 常青運行時間發佈。可以是 `"stable"` 或 `"canary"`。

傳回的功能

下列清單包含建立新會話時傳回的所有Microsoft Edge 特定功能 EdgeDriver 。

功能	類型	詳細資料
`msedge.msedgedriverVersion`	字串	EdgeDriver 的版本。
`msedge.userDataDir`	字串	Microsoft Edge 實例所使用的用戶資料資料夾路徑。

共用方式為