オプション - Selenium画面
This screen allows you to manage the browsers which can be launched from ZAP.
設定オプション
Browsers
This section allows you to configure all browsers, including the built-in browsers (Chrome, Edge, Firefox) and any custom browsers you add.
The table displays the following information for each browser:
- Name: The browser name
- Driver: The path to the WebDriver executable (e.g., ChromeDriver, geckodriver)
- Binary: The path to the browser binary executable (optional, for using a specific version)
- Type: The browser type - either Chromium-based or Firefox-based
Built-in Browsers
The built-in browsers (Chrome, Edge, and Firefox) are automatically included in the table and cannot be removed.
You can modify their configuration (driver path, binary path, and arguments) by selecting a browser and clicking the Modify... button.
If you attempt to remove a built-in browser, a warning message will be displayed.
Custom Browsers
You can add your own custom browsers by clicking the Add... button. Custom browsers allow you to:
- Specify a custom name for the browser
- Set the WebDriver path (e.g., for a custom Chromium or Firefox build)
- Set the browser binary path
- Choose the browser type (Chromium or Firefox)
- Add custom browser arguments
If you leave the driver or binary path empty for a custom browser, the default WebDriver and binary paths
configured for the corresponding built-in browser (Chrome/Edge for Chromium type, Firefox for Firefox type) will be used.
Custom browsers can be modified or removed using the Modify... and Remove buttons.
Custom browsers are saved in the configuration and will persist across ZAP restarts.
Custom browsers can be accessed programmatically using the keys:
custom.<name>
custom.<name>-headless
Note: Custom browsers automatically support headless mode for automation purposes.
When using automation tools that support headless browsers, you will see two options for each custom browser:
one with the browser name and one with the browser name followed by " Headless".
Browser Arguments
Each browser (built-in or custom) can have additional (CLI) arguments specified through the Arguments... button in the modify dialog.
注: Adding invalid arguments might cause the browser to fail to start. ZAP already adds some arguments (e.g. headless mode arguments).
Browser Preferences
Each browser (built-in or custom) can have name/value preferences configured via the Preferences... button in the modify dialog.
Preferences are applied when the browser is launched:
- Chrome / Edge: Preferences are passed as the
prefs experimental option. Use dotted names (e.g. profile.default_content_setting_values.notifications). Values can be text, numbers, or true/false.
- Firefox: Preferences are set via
about:config-style names (e.g. network.proxy.type). Values are coerced to string, integer, or boolean as appropriate.
Only enabled preferences are applied. Duplicate preference names are not allowed when adding or modifying an entry.
Browser Profiles
You can choose which Firefox profile to use by default for Firefox browsers.
The <temporary> profile is one which is created by Selenium each time the browser is launched.
注: 「client」アドオンは zap-client-profile というプロファイルを作成します。別のプロファイルを選択した場合、「Client」アドオンは手動設定なしでは機能しません。
System Properties
It's also possible to set browser driver and binary locations using Java system properties, in which case the options will be
overridden and those values shown instead. The system properties are:
webdriver.chrome.driver - ChromeDriver path
webdriver.edge.driver - EdgeDriver path
webdriver.gecko.driver - geckodriver (Firefox) path
selenium.chromeBinary - Chrome binary path
selenium.edgeBinary - Edge binary path
selenium.firefoxBinary - Firefox binary path
同梱されたWebDriver群の詳細は、概要ページで確認できます。
ブラウザ拡張機能
この画面の関連ボタンを使用して、ブラウザ拡張機能を追加、削除、有効化、または無効化できます。
サポートされているブラウザと拡張機能は以下の通りです：
- Firefox: .xpi
- Chrome/Edge: unpacked（拡張機能ファイルを含むディレクトリ）
アドオンも新しいブラウザ拡張機能を追加できます。 この画面から拡張機能を削除しても、アドオンによって再度追加されます。そのため、拡張機能を完全に削除するには、無効化するか、アドオン自体をアンインストールしてください。
関連情報