Skip to content

Commit a7046ec

Browse files
committed
Update generated doc for release 6.0.0
1 parent eafdad9 commit a7046ec

File tree

3 files changed

+27
-30
lines changed

3 files changed

+27
-30
lines changed

docs/img/seljup-vnc.png

-30.2 KB
Loading

docs/index.html

Lines changed: 27 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
<meta charset="UTF-8">
55
<meta http-equiv="X-UA-Compatible" content="IE=edge">
66
<meta name="viewport" content="width=device-width, initial-scale=1.0">
7-
<meta name="generator" content="Asciidoctor 2.0.20">
7+
<meta name="generator" content="Asciidoctor 2.0.23">
88
<meta name="author" content="Boni García">
99
<title>Selenium-Jupiter</title>
1010
<style>
@@ -783,7 +783,7 @@
783783
<h1>Selenium-Jupiter</h1>
784784
<div class="details">
785785
<span id="author" class="author">Boni García</span><br>
786-
<span id="revdate">Version 5.1.1</span>
786+
<span id="revdate">Version 6.0.0</span>
787787
</div>
788788
<div id="toc" class="toc2">
789789
<div id="toctitle">Table of Contents</div>
@@ -942,7 +942,7 @@ <h2 id="setup"><a class="anchor" href="#setup"></a>2. Setup</h2>
942942
<pre class="CodeRay highlight"><code data-lang="xml"><span class="tag">&lt;dependency&gt;</span>
943943
<span class="tag">&lt;groupId&gt;</span>io.github.bonigarcia<span class="tag">&lt;/groupId&gt;</span>
944944
<span class="tag">&lt;artifactId&gt;</span>selenium-jupiter<span class="tag">&lt;/artifactId&gt;</span>
945-
<span class="tag">&lt;version&gt;</span>5.1.1<span class="tag">&lt;/version&gt;</span>
945+
<span class="tag">&lt;version&gt;</span>6.0.0<span class="tag">&lt;/version&gt;</span>
946946
<span class="tag">&lt;scope&gt;</span>test<span class="tag">&lt;/scope&gt;</span>
947947
<span class="tag">&lt;/dependency&gt;</span></code></pre>
948948
</div>
@@ -953,7 +953,7 @@ <h2 id="setup"><a class="anchor" href="#setup"></a>2. Setup</h2>
953953
<div class="listingblock">
954954
<div class="content">
955955
<pre class="CodeRay highlight"><code data-lang="json"><span class="error">d</span><span class="error">e</span><span class="error">p</span><span class="error">e</span><span class="error">n</span><span class="error">d</span><span class="error">e</span><span class="error">n</span><span class="error">c</span><span class="error">i</span><span class="error">e</span><span class="error">s</span> {
956-
<span class="error">t</span><span class="error">e</span><span class="error">s</span><span class="error">t</span><span class="error">I</span><span class="error">m</span><span class="error">p</span><span class="error">l</span><span class="error">e</span><span class="error">m</span><span class="error">e</span><span class="error">n</span><span class="error">t</span><span class="error">a</span><span class="error">t</span><span class="error">i</span><span class="error">o</span><span class="error">n</span><span class="error">(</span><span class="string"><span class="delimiter">&quot;</span><span class="content">io.github.bonigarcia:selenium-jupiter:5.1.1</span><span class="delimiter">&quot;</span></span><span class="error">)</span>
956+
<span class="error">t</span><span class="error">e</span><span class="error">s</span><span class="error">t</span><span class="error">I</span><span class="error">m</span><span class="error">p</span><span class="error">l</span><span class="error">e</span><span class="error">m</span><span class="error">e</span><span class="error">n</span><span class="error">t</span><span class="error">a</span><span class="error">t</span><span class="error">i</span><span class="error">o</span><span class="error">n</span><span class="error">(</span><span class="string"><span class="delimiter">&quot;</span><span class="content">io.github.bonigarcia:selenium-jupiter:6.0.0</span><span class="delimiter">&quot;</span></span><span class="error">)</span>
957957
}</code></pre>
958958
</div>
959959
</div>
@@ -1129,7 +1129,7 @@ <h3 id="conditional-tests"><a class="anchor" href="#conditional-tests"></a>3.2.
11291129

11301130
<span class="annotation">@Test</span>
11311131
<span class="type">void</span> test(
1132-
<span class="annotation">@DockerBrowser</span>(type = CHROME, version = <span class="string"><span class="delimiter">&quot;</span><span class="content">beta</span><span class="delimiter">&quot;</span></span>, args = <span class="string"><span class="delimiter">&quot;</span><span class="content">--disable-gpu,--no-sandbox</span><span class="delimiter">&quot;</span></span>) WebDriver driver) {
1132+
<span class="annotation">@DockerBrowser</span>(type = CHROME, version = <span class="string"><span class="delimiter">&quot;</span><span class="content">beta</span><span class="delimiter">&quot;</span></span>) WebDriver driver) {
11331133
driver.get(<span class="string"><span class="delimiter">&quot;</span><span class="content">https://bonigarcia.dev/selenium-webdriver-java/</span><span class="delimiter">&quot;</span></span>);
11341134
assertThat(driver.getTitle()).contains(<span class="string"><span class="delimiter">&quot;</span><span class="content">Selenium WebDriver</span><span class="delimiter">&quot;</span></span>);
11351135
}
@@ -1274,7 +1274,7 @@ <h3 id="docker-browsers"><a class="anchor" href="#docker-browsers"></a>3.4. Dock
12741274
</div>
12751275
</div>
12761276
<div class="paragraph">
1277-
<p>The used Docker images by Selenium-Jupiter have been created and maintained by <a href="https://aerokube.com/selenoid/">Aerokube</a> (you can check the available versions on the <a href="https://aerokube.com/images/latest/">browser images</a> page). Therefore, the available browsers to be executed as Docker containers in WebDriverManager are <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerChromeTest.java">Chrome</a>, <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerFirefoxTest.java">Firefox</a>, <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerEdgeTest.java">Edge</a>, <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerOperaTest.java">Opera</a>, <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerSafariTest.java">Safari</a>, and <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerChromeMobileTest.java">Chrome Mobile</a>.</p>
1277+
<p>As of version 6, WebDriverManager uses the official Docker browser images created and maintained by the Selenium project, i.e., <a href="https://github.com/SeleniumHQ/docker-selenium">docker-selenium</a>. Therefore, the available browsers to be executed as Docker containers in Selenium-Jupiter are <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerChromeTest.java">Chrome</a>, <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerFirefoxTest.java">Firefox</a>, <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerEdgeTest.java">Edge</a>, and <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerChromiumTest.java">Chromium</a>.</p>
12781278
</div>
12791279
<div class="admonitionblock note">
12801280
<table>
@@ -1283,19 +1283,7 @@ <h3 id="docker-browsers"><a class="anchor" href="#docker-browsers"></a>3.4. Dock
12831283
<i class="fa icon-note" title="Note"></i>
12841284
</td>
12851285
<td class="content">
1286-
The case of Safari is particular since a real Safari browser can only be executed under a Mac OS machine. This way, the Safari Docker containers use the <a href="https://webkit.org/">WebKit engine</a>. This engine is the same used in browser containers, and therefore, from a functional point of view, both browsers (a real Safari and this Docker image) should behave in the same way.
1287-
</td>
1288-
</tr>
1289-
</table>
1290-
</div>
1291-
<div class="admonitionblock warning">
1292-
<table>
1293-
<tr>
1294-
<td class="icon">
1295-
<i class="fa icon-warning" title="Warning"></i>
1296-
</td>
1297-
<td class="content">
1298-
Notice you will need hardware virtualization (hypervisor) or a virtual machine with nested virtualization support to run Chrome Mobile images.
1286+
Some <em>dockerized</em> browsers (e.g., Chromium and Edge) are supported in ARM64 architecture. See the <a href="https://github.com/SeleniumHQ/docker-selenium">docker-selenium</a> README for further information.
12991287
</td>
13001288
</tr>
13011289
</table>
@@ -1314,13 +1302,13 @@ <h4 id="browser-versions"><a class="anchor" href="#browser-versions"></a>3.4.1.
13141302
<p><code>"latest"</code> : To specify the latest version explicitly (default option).</p>
13151303
</li>
13161304
<li>
1317-
<p><code>"latest-N"</code> : Where <code>N</code> is an integer value to be subtracted from the current stable version. For example, if we specify <code>latest-1</code> (i.e., <em>latest version minus one</em>), the previous version to the stable release will be used (see an example <a href="https://github.com/bonigarcia/selenium-jupiter/blob/master/src/test/java/io/github/bonigarcia/seljup/test/docker/DockerChromeLatestMinusOneTest.java">here</a>).</p>
1305+
<p><code>"latest-N"</code> : Where <code>N</code> is an integer value to be subtracted from the current stable version. For example, if we specify <code>latest-1</code> (i.e., <em>latest version minus one</em>), the previous version to the stable release will be used (see an example <a href="https://github.com/bonigarcia/webdrivermanager/blob/master/src/test/java/io/github/bonigarcia/wdm/test/docker/DockerChromeVersionsTest.java">here</a>).</p>
13181306
</li>
13191307
<li>
1320-
<p><code>"beta"</code>: To use the beta version. This version is only available for Chrome and Firefox, thanks to the Docker images maintained by <a href="https://hub.docker.com/r/twilio/selenoid/">Twilio</a> (a fork of the Aerokube images for the beta and development versions of Chrome and Firefox).</p>
1308+
<p><code>"beta"</code>: To use the beta version.</p>
13211309
</li>
13221310
<li>
1323-
<p><code>"dev"</code>: To use the development version (again, for Chrome and Firefox).</p>
1311+
<p><code>"dev"</code>: To use the development version.</p>
13241312
</li>
13251313
</ul>
13261314
</div>
@@ -1346,7 +1334,7 @@ <h4 id="browser-versions"><a class="anchor" href="#browser-versions"></a>3.4.1.
13461334

13471335
<span class="annotation">@Test</span>
13481336
<span class="type">void</span> test(
1349-
<span class="annotation">@DockerBrowser</span>(type = CHROME, version = <span class="string"><span class="delimiter">&quot;</span><span class="content">beta</span><span class="delimiter">&quot;</span></span>, args = <span class="string"><span class="delimiter">&quot;</span><span class="content">--disable-gpu,--no-sandbox</span><span class="delimiter">&quot;</span></span>) WebDriver driver) {
1337+
<span class="annotation">@DockerBrowser</span>(type = CHROME, version = <span class="string"><span class="delimiter">&quot;</span><span class="content">beta</span><span class="delimiter">&quot;</span></span>) WebDriver driver) {
13501338
driver.get(<span class="string"><span class="delimiter">&quot;</span><span class="content">https://bonigarcia.dev/selenium-webdriver-java/</span><span class="delimiter">&quot;</span></span>);
13511339
assertThat(driver.getTitle()).contains(<span class="string"><span class="delimiter">&quot;</span><span class="content">Selenium WebDriver</span><span class="delimiter">&quot;</span></span>);
13521340
}
@@ -2122,10 +2110,10 @@ <h3 id="chrome-devtools"><a class="anchor" href="#chrome-devtools"></a>3.9. Chro
21222110
<span class="keyword">import</span> <span class="include">org.openqa.selenium.By</span>;
21232111
<span class="keyword">import</span> <span class="include">org.openqa.selenium.chrome.ChromeDriver</span>;
21242112
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.DevTools</span>;
2125-
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v126.dom.model.Rect</span>;
2126-
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v126.page.Page</span>;
2127-
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v126.page.Page.GetLayoutMetricsResponse</span>;
2128-
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v126.page.model.Viewport</span>;
2113+
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v133.dom.model.Rect</span>;
2114+
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v133.page.Page</span>;
2115+
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v133.page.Page.GetLayoutMetricsResponse</span>;
2116+
<span class="keyword">import</span> <span class="include">org.openqa.selenium.devtools.v133.page.model.Viewport</span>;
21292117
<span class="keyword">import</span> <span class="include">org.openqa.selenium.support.ui.ExpectedConditions</span>;
21302118
<span class="keyword">import</span> <span class="include">org.openqa.selenium.support.ui.WebDriverWait</span>;
21312119

@@ -2594,6 +2582,15 @@ <h2 id="further-documentation"><a class="anchor" href="#further-documentation"><
25942582
<div class="ulist">
25952583
<ul>
25962584
<li>
2585+
<p>Leotta, M., et al., "<a href="https://www.sciencedirect.com/science/article/pii/S0950584924002003">A family of experiments to quantify the benefits of adopting WebDriverManager and Selenium-Jupiter</a>." <em>Information and Software Technology</em> 178 (2025): 107595.</p>
2586+
</li>
2587+
<li>
2588+
<p>García, Boni, et al. "<a href="https://link.springer.com/chapter/10.1007/978-3-031-70245-7_10">Exploring Browser Automation: A Comparative Study of Selenium, Cypress, Puppeteer, and Playwright</a>." <em>International Conference on the Quality of Information and Communications Technology</em>. Springer Nature Switzerland, 2024.</p>
2589+
</li>
2590+
<li>
2591+
<p>Leotta, M., et al. "<a href="https://dl.acm.org/doi/10.1145/3661167.3661192">AI-generated test scripts for web E2E testing with ChatGPT and Copilot: a preliminary study</a>." Proceedings of the <em>28th International Conference on Evaluation and Assessment in Software Engineering</em>. 2024.</p>
2592+
</li>
2593+
<li>
25972594
<p>García, Boni, et al. "<a href="https://www.sciencedirect.com/science/article/pii/S0164121223001188">Enhancing Web Applications Observability through Instrumented Automated Browsers</a>." <em>Journal of Systems and Software</em> (2023): 111723.</p>
25982595
</li>
25992596
<li>
@@ -2631,15 +2628,15 @@ <h2 id="further-documentation"><a class="anchor" href="#further-documentation"><
26312628
<h2 id="about"><a class="anchor" href="#about"></a>10. About</h2>
26322629
<div class="sectionbody">
26332630
<div class="paragraph">
2634-
<p>Selenium-Jupiter (Copyright © 2017-2024) is an open-source project created and maintained by <a href="https://bonigarcia.dev/">Boni García</a> (<a href="https://twitter.com/boni_gg">@boni_gg</a>), licensed under the terms of <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. This documentation (also available in <a href="selenium-jupiter.pdf">PDF</a>) is released under the terms of <a href="https://creativecommons.org/licenses/by-nc-sa/2.0/">CC BY-NC-SA 2.0</a>.</p>
2631+
<p>Selenium-Jupiter (Copyright © 2017-2025) is an open-source project created and maintained by <a href="https://bonigarcia.dev/">Boni García</a> (<a href="https://twitter.com/boni_gg">@boni_gg</a>), licensed under the terms of <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. This documentation (also available in <a href="selenium-jupiter.pdf">PDF</a>) is released under the terms of <a href="https://creativecommons.org/licenses/by-nc-sa/2.0/">CC BY-NC-SA 2.0</a>.</p>
26352632
</div>
26362633
</div>
26372634
</div>
26382635
</div>
26392636
<div id="footer">
26402637
<div id="footer-text">
2641-
Version 5.1.1<br>
2642-
Updated on 24-06-2024
2638+
Version 6.0.0<br>
2639+
Updated on 19-03-2025
26432640
</div>
26442641
</div>
26452642
</body>

docs/selenium-jupiter.pdf

-52.9 KB
Binary file not shown.

0 commit comments

Comments
 (0)