功能和 EdgeOptions

功能是您可以用來自訂和設定會話的 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 為 ，則即使 WebDriver 本機端尚未關閉會話，Microsoft Edge 還是會在 WebDriver 服務關閉時結束。 如果 true 為 ，則只有在 WebDriver 本機端關閉會話時，Microsoft 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" 。

傳回的功能

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

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