Skip to content
This repository was archived by the owner on Mar 25, 2025. It is now read-only.

Commit 6acf8f8

Browse files
committed
Added documentation for RemoteFactory
1 parent b341773 commit 6acf8f8

File tree

1 file changed

+23
-1
lines changed

1 file changed

+23
-1
lines changed

documentation/chapters/browser-factories.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ In case you just want to get started, we provide factories for the most common b
1111
- `FirefoxFactory`
1212
- `MarionetteFactory` (new Firefox driver)
1313
- `InternetExplorerFactory`
14+
- `RemoteFactory`
1415

1516
All of these are provided by the `webtester-core` module, but need you to provide the corresponding Selenium `WebDriver` dependencies yourself.
1617

@@ -91,7 +92,28 @@ The path to the executable must be declared as a system or environment property
9192
**Additional Information:**
9293
- https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver
9394

95+
## RemoteFactory
96+
97+
This `BrowserFactory` uses the `RemoteWebDriver` to connect to a
98+
[Selenium Grid](https://github.com/SeleniumHQ/selenium/wiki/Grid2).
99+
100+
### Default Driver Configuration
101+
In order to optimize testing the following properties are set when creating a
102+
`WebDriver` using the `RemoteFactory`:
103+
104+
- Native events are disabled -> Selenium does not simulate human typing.
105+
- Untrusted certificates are always accepted.
106+
- Selenium Grid Host: `localhost:4444`
107+
- Default Browser: `firefox` with Marionette activated
108+
109+
The connection to the Selenium Grid can be configured in two ways:
110+
111+
1. Set properties in configuration file (see [Configuration](configuration.md)
112+
for a full list of properties).
113+
2. Set system properties to override the configuration at runtime
114+
(eg. `-Dremote.browser.name=chrome`).
115+
94116
# Linked Documentation
95117

96118
- [Browser](browser.md)
97-
119+
- [Configuration](configuration.md)

0 commit comments

Comments
 (0)