Skip to content

Commit 2fd15c0

Browse files
committed
List known issues with selenium manager (#1471)
[deploy site] 876e726
1 parent 26ae10c commit 2fd15c0

File tree

23 files changed

+167
-87
lines changed

23 files changed

+167
-87
lines changed

documentation/_print/index.html

+16-6
Original file line numberDiff line numberDiff line change
@@ -9720,7 +9720,17 @@
97209720
INFO Driver path: C:\Users\boni\.cache\selenium\chromedriver\win64\117.0.5938.22\chromedriver.exe
97219721
INFO Browser path: C:\Users\boni\.cache\selenium\chrome\win64\117.0.5938.22\chrome.exe
97229722
</code></pre><h2 id=selenium-grid>Selenium Grid</h2><p>Selenium Manager allows you to configure the drivers automatically when setting up Selenium Grid. To that aim, you need to include the argument <code>--selenium-manager true</code> in the command to start Selenium Grid. For more details, visit the <a href=https://www.selenium.dev/documentation/grid/getting_started/>Selenium Grid starting page</a>.</p><p>Moreover, Selenium Manager also allows managing Selenium Grid releases automatically. For that, the argument <code>--grid</code> is used as follows:</p><pre tabindex=0><code>$ ./selenium-manager --grid
9723-
</code></pre><p>After this command, Selenium Manager discovers the latest version of Selenium Grid, storing the <code>selenium-server.jar</code> in the local cache.</p><p>Optionally, the argument <code>--grid</code> allows to specify a Selenium Grid version (<code>--grid &lt;GRID_VERSION></code>).</p><h2 id=roadmap>Roadmap</h2><p>You can trace the work in progress in the <a href=https://github.com/orgs/SeleniumHQ/projects/5>Selenium Manager project dashboard</a>. Moreover, you can check the new features shipped with each Selenium Manager release in its <a href=https://github.com/SeleniumHQ/selenium/blob/trunk/rust/CHANGELOG.md>changelog file</a>.</p></div><div class=td-content style=page-break-before:always><h1 id=pg-7414868d1046cd940a63280030df7f9f>7 - Test Practices</h1><div class=lead>Some guidelines and recommendations on testing from the Selenium project.</div><p>A note on &ldquo;Best Practices&rdquo;: We&rsquo;ve intentionally avoided the phrase &ldquo;Best
9723+
</code></pre><p>After this command, Selenium Manager discovers the latest version of Selenium Grid, storing the <code>selenium-server.jar</code> in the local cache.</p><p>Optionally, the argument <code>--grid</code> allows to specify a Selenium Grid version (<code>--grid &lt;GRID_VERSION></code>).</p><h2 id=known-limitations>Known Limitations</h2><h3 id=custom-package-managers>Custom package managers</h3><p>If you are using a linux package manager (Anaconda, snap, etc) that requires a specific driver be used for your browsers,
9724+
you&rsquo;ll need to either specify the
9725+
<a href=https://www.selenium.dev/documentation/webdriver/drivers/service/#driver-location>driver location</a>,
9726+
the <a href>browser location</a>,
9727+
or both, depending on the requirements.</p><h3 id=alternative-architecture>Alternative Architecture</h3><p>Selenium supports all five architectures managed by Google&rsquo;s Chrome for Testing, and all six drivers provided for Microsoft Edge.</p><p>Each release of the Selenium bindings comes with three separate Selenium Manager binaries — one for Linux, Windows, and Mac.</p><ul><li>The Mac version supports both x64 and aarch64 (Intel and Apple).</li><li>The Windows version should work for both x86 and x64 (32-bit and 64-bit OS).</li><li>The Linux version has only been verified to work for x64.</li></ul><p>Reasons for not supporting more architectures:</p><ol><li>Neither Chrome for Testing nor Microsoft Edge supports additional architectures, so Selenium Manager would need to
9728+
manage something unofficial for it to work.</li><li>We currently build the binaries from existing GitHub actions runners, which do not support these architectures</li><li>Any additional architectures would get distributed with all Selenium releases, increasing the total build size</li></ol><p>If you are running linux on arm64/aarch64, 32-bit architecture, or a Raspberry Pi, Selenium Manager will not work for you.
9729+
The biggest issue for people is that they used to get custom-built drivers and put them on PATH and have them work.
9730+
Now that Selenium Manager is responsible for locating drivers on PATH, this approach no longer works, and users
9731+
need to use a <code>Service</code> class and <a href=https://www.selenium.dev/documentation/webdriver/drivers/service/#driver-location>set the location directly</a>.
9732+
There are a number of advantages to having Selenium Manager look for drivers on PATH instead of managing that logic
9733+
in each of the bindings, so that&rsquo;s currently a trade-off we are comfortable with.</p><h2 id=roadmap>Roadmap</h2><p>You can trace the work in progress in the <a href=https://github.com/orgs/SeleniumHQ/projects/5>Selenium Manager project dashboard</a>. Moreover, you can check the new features shipped with each Selenium Manager release in its <a href=https://github.com/SeleniumHQ/selenium/blob/trunk/rust/CHANGELOG.md>changelog file</a>.</p></div><div class=td-content style=page-break-before:always><h1 id=pg-7414868d1046cd940a63280030df7f9f>7 - Test Practices</h1><div class=lead>Some guidelines and recommendations on testing from the Selenium project.</div><p>A note on &ldquo;Best Practices&rdquo;: We&rsquo;ve intentionally avoided the phrase &ldquo;Best
97249734
Practices&rdquo; in this documentation. No one approach works for all situations.
97259735
We prefer the idea of &ldquo;Guidelines and Recommendations.&rdquo; We encourage
97269736
you to read through these and thoughtfully decide what approaches
@@ -13358,7 +13368,7 @@
1335813368
No patent liability is assumed with respect
1335913369
to the use of the information contained herein.</p><h2 id=attributions>Attributions</h2><h4 id=selenium-main-repositorygithubcomseleniumhqselenium><a href=//github.com/SeleniumHQ/selenium/>Selenium Main Repository</a></h4><style type=text/css>.ghContributors{display:flex;flex-flow:wrap;align-content:flex-start}.ghContributors>div{width:50%;display:inline-flex;margin-bottom:5px}.ghContributors>div label{padding-left:4px}.ghContributors>div span{font-size:x-small;padding-left:4px}</style><div class=ghContributors><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/28229?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1336013370
<label><a href=https://github.com/shs96c>@shs96c</a></label>
13361-
<span class=contributions>5201 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
13371+
<span class=contributions>5206 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1336213372
<label><a href=https://github.com/barancev>@barancev</a></label>
1336313373
<span class=contributions>3352 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/352840?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1336413374
<label><a href=https://github.com/jimevans>@jimevans</a></label>
@@ -13368,7 +13378,7 @@
1336813378
<label><a href=https://github.com/jarib>@jarib</a></label>
1336913379
<span class=contributions>1299 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/128518?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1337013380
<label><a href=https://github.com/AutomatedTester>@AutomatedTester</a></label>
13371-
<span class=contributions>1214 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/96150?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
13381+
<span class=contributions>1215 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/96150?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1337213382
<label><a href=https://github.com/dfabulich>@dfabulich</a></label>
1337313383
<span class=contributions>1175 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1131704?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1337413384
<label><a href=https://github.com/illicitonion>@illicitonion</a></label>
@@ -13644,7 +13654,7 @@
1364413654
<label><a href=https://github.com/peter-kehl>@peter-kehl</a></label>
1364513655
<span class=contributions>1 commits</span></div></div><h4 id=docker-seleniumgithubcomseleniumhqdocker-selenium><a href=//github.com/SeleniumHQ/docker-selenium/>Docker Selenium</a></h4><style type=text/css>.ghContributors{display:flex;flex-flow:wrap;align-content:flex-start}.ghContributors>div{width:50%;display:inline-flex;margin-bottom:5px}.ghContributors>div label{padding-left:4px}.ghContributors>div span{font-size:x-small;padding-left:4px}</style><div class=ghContributors><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/5992658?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1364613656
<label><a href=https://github.com/diemol>@diemol</a></label>
13647-
<span class=contributions>524 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/2972876?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
13657+
<span class=contributions>525 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/2972876?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1364813658
<label><a href=https://github.com/ddavison>@ddavison</a></label>
1364913659
<span class=contributions>134 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3331063?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1365013660
<label><a href=https://github.com/selenium-ci>@selenium-ci</a></label>
@@ -13654,7 +13664,7 @@
1365413664
<label><a href=https://github.com/kayabendroth>@kayabendroth</a></label>
1365513665
<span class=contributions>50 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/in/29110?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1365613666
<label><a href=https://github.com/apps/dependabot>@dependabot[bot]</a></label>
13657-
<span class=contributions>29 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/111569?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
13667+
<span class=contributions>30 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/111569?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1365813668
<label><a href=https://github.com/elgalu>@elgalu</a></label>
1365913669
<span class=contributions>24 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/191885?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1366013670
<label><a href=https://github.com/luisfcorreia>@luisfcorreia</a></label>
@@ -13850,7 +13860,7 @@
1385013860
<label><a href=https://github.com/selenium-ci>@selenium-ci</a></label>
1385113861
<span class=contributions>323 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/777185?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1385213862
<label><a href=https://github.com/titusfortner>@titusfortner</a></label>
13853-
<span class=contributions>161 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3264250?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
13863+
<span class=contributions>163 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3264250?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1385413864
<label><a href=https://github.com/alaahong>@alaahong</a></label>
1385513865
<span class=contributions>101 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1148325?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
1385613866
<label><a href=https://github.com/kzhirata>@kzhirata</a></label>

documentation/about/_print/index.html

+5-5
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
No patent liability is assumed with respect
3737
to the use of the information contained herein.</p><h2 id=attributions>Attributions</h2><h4 id=selenium-main-repositorygithubcomseleniumhqselenium><a href=//github.com/SeleniumHQ/selenium/>Selenium Main Repository</a></h4><style type=text/css>.ghContributors{display:flex;flex-flow:wrap;align-content:flex-start}.ghContributors>div{width:50%;display:inline-flex;margin-bottom:5px}.ghContributors>div label{padding-left:4px}.ghContributors>div span{font-size:x-small;padding-left:4px}</style><div class=ghContributors><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/28229?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
3838
<label><a href=https://github.com/shs96c>@shs96c</a></label>
39-
<span class=contributions>5201 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
39+
<span class=contributions>5206 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/617090?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
4040
<label><a href=https://github.com/barancev>@barancev</a></label>
4141
<span class=contributions>3352 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/352840?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
4242
<label><a href=https://github.com/jimevans>@jimevans</a></label>
@@ -46,7 +46,7 @@
4646
<label><a href=https://github.com/jarib>@jarib</a></label>
4747
<span class=contributions>1299 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/128518?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
4848
<label><a href=https://github.com/AutomatedTester>@AutomatedTester</a></label>
49-
<span class=contributions>1214 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/96150?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
49+
<span class=contributions>1215 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/96150?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
5050
<label><a href=https://github.com/dfabulich>@dfabulich</a></label>
5151
<span class=contributions>1175 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1131704?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
5252
<label><a href=https://github.com/illicitonion>@illicitonion</a></label>
@@ -322,7 +322,7 @@
322322
<label><a href=https://github.com/peter-kehl>@peter-kehl</a></label>
323323
<span class=contributions>1 commits</span></div></div><h4 id=docker-seleniumgithubcomseleniumhqdocker-selenium><a href=//github.com/SeleniumHQ/docker-selenium/>Docker Selenium</a></h4><style type=text/css>.ghContributors{display:flex;flex-flow:wrap;align-content:flex-start}.ghContributors>div{width:50%;display:inline-flex;margin-bottom:5px}.ghContributors>div label{padding-left:4px}.ghContributors>div span{font-size:x-small;padding-left:4px}</style><div class=ghContributors><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/5992658?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
324324
<label><a href=https://github.com/diemol>@diemol</a></label>
325-
<span class=contributions>524 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/2972876?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
325+
<span class=contributions>525 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/2972876?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
326326
<label><a href=https://github.com/ddavison>@ddavison</a></label>
327327
<span class=contributions>134 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3331063?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
328328
<label><a href=https://github.com/selenium-ci>@selenium-ci</a></label>
@@ -332,7 +332,7 @@
332332
<label><a href=https://github.com/kayabendroth>@kayabendroth</a></label>
333333
<span class=contributions>50 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/in/29110?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
334334
<label><a href=https://github.com/apps/dependabot>@dependabot[bot]</a></label>
335-
<span class=contributions>29 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/111569?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
335+
<span class=contributions>30 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/111569?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
336336
<label><a href=https://github.com/elgalu>@elgalu</a></label>
337337
<span class=contributions>24 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/191885?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
338338
<label><a href=https://github.com/luisfcorreia>@luisfcorreia</a></label>
@@ -528,7 +528,7 @@
528528
<label><a href=https://github.com/selenium-ci>@selenium-ci</a></label>
529529
<span class=contributions>323 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/777185?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
530530
<label><a href=https://github.com/titusfortner>@titusfortner</a></label>
531-
<span class=contributions>161 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3264250?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
531+
<span class=contributions>163 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/3264250?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
532532
<label><a href=https://github.com/alaahong>@alaahong</a></label>
533533
<span class=contributions>101 commits</span></div><div style=padding:10px><img src="https://avatars.githubusercontent.com/u/1148325?v=4" class=inline width=100 height=100 style=height:100px;height:100px;margin-bottom:.25em;vertical-align:middle>
534534
<label><a href=https://github.com/kzhirata>@kzhirata</a></label>

0 commit comments

Comments
 (0)