TeamDev-IP · vlad-lubenskyi · Sep 4, 2025 · Sep 4, 2025 · Sep 4, 2025 · Sep 4, 2025
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -31,7 +31,7 @@ plugins {
     id("org.jetbrains.kotlin.plugin.compose") version "2.0.0"
 }
 
-val jxBrowserVersion by extra { "8.11.0" } // The version of JxBrowser used in the examples.
+val jxBrowserVersion by extra { "8.12.0" } // The version of JxBrowser used in the examples.
 val guavaVersion by extra { "29.0-jre" } // Some of the examples use Guava.
 
 repositories {

diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DispatchKeyEvents.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DispatchKeyEvents.java
@@ -83,8 +83,8 @@ public void windowClosing(WindowEvent e) {
 
     private static void loadHtmlAndWait(Browser browser, String html) {
         var latch = new CountDownLatch(1);
-        browser.mainFrame().ifPresent(mainFrame -> mainFrame.loadHtml(html));
         browser.navigation().on(FrameLoadFinished.class, event -> latch.countDown());
+        browser.navigation().loadHtml(html);
         awaitUninterruptibly(latch);
     }
 

diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DispatchMouseEvents.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DispatchMouseEvents.java
@@ -96,8 +96,8 @@ public void windowClosing(WindowEvent e) {
 
     private static void loadHtmlAndWait(Browser browser, String html) {
         var latch = new CountDownLatch(1);
-        browser.mainFrame().ifPresent(mainFrame -> mainFrame.loadHtml(html));
         browser.navigation().on(FrameLoadFinished.class, event -> latch.countDown());
+        browser.navigation().loadHtml(html);
         awaitUninterruptibly(latch);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DomForm.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DomForm.java
@@ -66,11 +66,15 @@ public void windowClosing(WindowEvent e) {
                     element.findElementByName("lastName").ifPresent(lastName ->
                             lastName.attributes().put("value", "Doe"));
                 }));
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("<html><body><form name=\"myForm\">" +
-                        "First name: <input type=\"text\" name=\"firstName\"/><br/>" +
-                        "Last name: <input type=\"text\" name=\"lastName\"/><br/>" +
-                        "<input type=\"button\" value=\"Save\"/>" +
-                        "</form></body></html>"));
+        browser.navigation().loadHtml("""
+                <html>
+                <body>
+                <form name="myForm">
+                  First name: <input type="text" name="firstName"/><br/>
+                  Last name: <input type="text" name="lastName"/><br/>
+                  <input type="button" value="Save"/></form>
+                </body>
+                </html>
+                """);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DomGetAttributes.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DomGetAttributes.java
@@ -36,8 +36,14 @@ public static void main(String[] args) {
         try (var engine = Engine.newInstance(OFF_SCREEN)) {
             var browser = engine.newBrowser();
 
-            browser.mainFrame().ifPresent(mainFrame -> mainFrame.loadHtml(
-                    "<html><body><a href='#' id='link' title='link title'>Link</a></body></html>"));
+            browser.navigation().loadHtml("""
+                <html>
+                    <body>
+                        <a href='#' id='link' title='link title'>Link</a>
+                    </body>
+                </html>
+            """);
+
             browser.mainFrame()
                     .flatMap(Frame::document)
                     .flatMap(Document::documentElement)

diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DomKeyEvents.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DomKeyEvents.java
@@ -93,7 +93,7 @@ private static void printEventDetails(Event event) {
     private static void loadHtmlAndWait(Browser browser) {
         var latch = new CountDownLatch(1);
         browser.navigation().on(FrameLoadFinished.class, event -> latch.countDown());
-        browser.mainFrame().ifPresent(mainFrame -> mainFrame.loadHtml(HTML));
+        browser.navigation().loadHtml(HTML);
         awaitUninterruptibly(latch);
     }
 

diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DomMouseEvents.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DomMouseEvents.java
@@ -94,7 +94,7 @@ private static void printEventDetails(Event event) {
     private static void loadHtmlAndWait(Browser browser) {
         var latch = new CountDownLatch(1);
         browser.navigation().on(FrameLoadFinished.class, event -> latch.countDown());
-        browser.mainFrame().ifPresent(mainFrame -> mainFrame.loadHtml(HTML));
+        browser.navigation().loadHtml(HTML);
         awaitUninterruptibly(latch);
     }
 

diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DomQuerySelector.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DomQuerySelector.java
@@ -63,11 +63,16 @@ public void windowClosing(WindowEvent e) {
                 event.frame().document().flatMap(Document::documentElement).ifPresent(element ->
                         element.findElementsByCssSelector("p").forEach(paragraph ->
                                 System.out.println("innerHTML " + paragraph.innerHtml()))));
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("<html><body><div id='root'>" +
-                        "<p>paragraph1</p>" +
-                        "<p>paragraph2</p>" +
-                        "<p>paragraph3</p>" +
-                        "</div></body></html>"));
+        browser.navigation().loadHtml("""
+            <html>
+                <body>
+                    <div id='root'>
+                        <p>paragraph1</p>
+                        <p>paragraph2</p>
+                        <p>paragraph3</p>
+                    </div>
+                </body>
+            </html>
+        """);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/DomSelectOption.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/DomSelectOption.java
@@ -70,12 +70,17 @@ public void windowClosing(WindowEvent e) {
                             ((OptionElement) options[2]).select();
                             System.out.println(selectElement.innerHtml());
                         }));
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("<html><body><select id='select-tag'>\n" +
-                        "  <option value=\"volvo\">Volvo</option>\n" +
-                        "  <option value=\"saab\">Saab</option>\n" +
-                        "  <option value=\"opel\">Opel</option>\n" +
-                        "  <option value=\"audi\">Audi</option>\n" +
-                        "</select></body></html>"));
+        browser.navigation().loadHtml("""
+            <html>
+                <body>
+                    <select id="select-tag">
+                        <option value="volvo">Volvo</option>
+                        <option value="saab">Saab</option>
+                        <option value="opel">Opel</option>
+                        <option value="audi">Audi</option>
+                    </select>
+                </body>
+            </html>
+        """);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/FileUpload.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/FileUpload.java
@@ -64,8 +64,9 @@ public void windowClosing(WindowEvent e) {
         browser.set(OpenFileCallback.class, (params, tell) ->
                 tell.open(Paths.get("file.txt")));
 
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("Please specify a file, or a set of files:<br>\n" +
-                        "<input type='file' name='datafile' size='40'>"));
+        browser.navigation().loadHtml("""
+            Please specify a file, or a set of files:<br/>
+            <input type='file' name='datafile' size='40' />
+        """);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/LoadHtml.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/LoadHtml.java
@@ -57,7 +57,12 @@ public void windowClosing(WindowEvent e) {
             frame.setVisible(true);
         });
 
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("<html><body><h1>Hello there!</h1></body></html>"));
+        browser.navigation().loadHtml("""
+            <html>
+                <body>
+                    <h1>Hello there!</h1>
+                </body>
+            </html>
+        """);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/PrintFromJavaScript.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/PrintFromJavaScript.java
@@ -57,9 +57,13 @@ public void windowClosing(WindowEvent e) {
             frame.setLocationRelativeTo(null);
             frame.setVisible(true);
 
-            browser.mainFrame().ifPresent(mainFrame ->
-                    mainFrame.loadHtml("<html><body><a href='#' onclick='window.print();'>" +
-                            "Print</a></body></html>"));
+            browser.navigation().loadHtml("""
+                <html>
+                    <body>
+                        <a href="#" onclick="window.print();">Print</a>
+                    </body>
+                </html>
+            """);
         });
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/SpellCheckEvents.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/SpellCheckEvents.java
@@ -64,10 +64,14 @@ public void windowClosing(WindowEvent e) {
                     System.out.println("Error start index: " + checkResult.location());
                     System.out.println("Error length: " + checkResult.length());
                 }));
-        browser.mainFrame().ifPresent(mainFrame -> {
-            mainFrame.loadHtml("<html><body>" +
-                    "<textarea autofocus rows='20' cols='30'>Smple text with mitake.</textarea>" +
-                    "</body></html>");
-        });
+        browser.navigation().loadHtml("""
+            <html>
+                <body>
+                    <textarea autofocus rows='20' cols='30'>
+                        Smple text with mitake.
+                    </textarea>
+                </body>
+            </html>
+        """);
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/SpellCheckSuggestions.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/SpellCheckSuggestions.java
@@ -106,10 +106,15 @@ public void windowClosing(WindowEvent e) {
             var location = params.location();
             popupMenu.show(view, location.x(), location.y());
         });
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("<html><body><textarea rows='20' cols='30'>" +
-                        "Smple text with mitake.</textarea></body></html>"));
-
+        browser.navigation().loadHtml("""
+            <html>
+                <body>
+                    <textarea rows='20' cols='30'>
+                        Smple text with mitake.
+                    </textarea>
+                </body>
+            </html>
+        """);
     }
 
     private static BrowserView view;

diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/SuppressKey.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/SuppressKey.java
@@ -72,6 +72,6 @@ public void windowClosing(WindowEvent e) {
             frame.setVisible(true);
         });
 
-        browser.mainFrame().ifPresent(mainFrame -> mainFrame.loadHtml("<textarea></textarea>"));
+        browser.navigation().loadHtml("<textarea></textarea>");
     }
 }
diff --git a/examples/src/main/java/com/teamdev/jxbrowser/examples/SuppressMouse.java b/examples/src/main/java/com/teamdev/jxbrowser/examples/SuppressMouse.java
@@ -76,8 +76,15 @@ public void windowClosing(WindowEvent e) {
             frame.setVisible(true);
         });
 
-        browser.mainFrame().ifPresent(mainFrame ->
-                mainFrame.loadHtml("<button onclick=\"clicked()\">click holding shift</button>" +
-                        "<script>function clicked() {alert('clicked');}</script>"));
+        browser.navigation().loadHtml("""
+            <button onclick="clicked()">
+                Click holding shift
+            </button>
+            <script>
+                function clicked() {
+                    alert('clicked');
+                }
+            </script>
+        """);
     }
 }
diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DispatchKeyEvents.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DispatchKeyEvents.kt
@@ -25,7 +25,6 @@ import androidx.compose.ui.window.singleWindowApplication
 import com.google.common.util.concurrent.Uninterruptibles.awaitUninterruptibly
 import com.teamdev.jxbrowser.browser.Browser
 import com.teamdev.jxbrowser.dsl.Engine
-import com.teamdev.jxbrowser.dsl.browser.mainFrame
 import com.teamdev.jxbrowser.dsl.browser.navigation
 import com.teamdev.jxbrowser.dsl.subscribe
 import com.teamdev.jxbrowser.dsl.ui.event.KeyPressed
@@ -60,7 +59,7 @@ fun main() {
 private fun Browser.loadHtmlAndWait(html: String) {
     val latch = CountDownLatch(1)
     navigation.subscribe<FrameLoadFinished> { latch.countDown() }
-    mainFrame?.loadHtml(html)
+    navigation.loadHtml(html)
     awaitUninterruptibly(latch)
 }
 

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DispatchMouseEvents.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DispatchMouseEvents.kt
@@ -28,7 +28,6 @@ import androidx.compose.ui.window.singleWindowApplication
 import com.google.common.util.concurrent.Uninterruptibles.awaitUninterruptibly
 import com.teamdev.jxbrowser.browser.Browser
 import com.teamdev.jxbrowser.dsl.Engine
-import com.teamdev.jxbrowser.dsl.browser.mainFrame
 import com.teamdev.jxbrowser.dsl.browser.navigation
 import com.teamdev.jxbrowser.dsl.subscribe
 import com.teamdev.jxbrowser.dsl.ui.Point
@@ -87,7 +86,7 @@ private fun Browser.dispatchMouseEvent() {
 private fun Browser.loadHtmlAndWait() {
     val latch = CountDownLatch(1)
     navigation.subscribe<FrameLoadFinished> { latch.countDown() }
-    mainFrame?.loadHtml(ONCONTEXTMENU_CALLBACK)
+    navigation.loadHtml(ONCONTEXTMENU_CALLBACK)
     awaitUninterruptibly(latch)
 }
 

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomForm.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomForm.kt
@@ -23,7 +23,6 @@ package com.teamdev.jxbrowser.examples
 import androidx.compose.runtime.LaunchedEffect
 import androidx.compose.ui.window.singleWindowApplication
 import com.teamdev.jxbrowser.dsl.Engine
-import com.teamdev.jxbrowser.dsl.browser.mainFrame
 import com.teamdev.jxbrowser.dsl.browser.navigation
 import com.teamdev.jxbrowser.dsl.dom.documentElement
 import com.teamdev.jxbrowser.dsl.dom.getByName
@@ -47,7 +46,7 @@ fun main() {
         BrowserView(browser)
         LaunchedEffect(Unit) {
             browser.navigation.fillFormOnLoadFinished()
-            browser.mainFrame?.loadHtml(HTML_FORM)
+            browser.navigation.loadHtml(HTML_FORM)
         }
     }
 }

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomGetAttributes.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomGetAttributes.kt
@@ -20,25 +20,38 @@
 
 package com.teamdev.jxbrowser.examples
 
+import com.google.common.util.concurrent.Uninterruptibles.awaitUninterruptibly
+import com.teamdev.jxbrowser.browser.Browser
 import com.teamdev.jxbrowser.dsl.Engine
 import com.teamdev.jxbrowser.dsl.browser.mainFrame
+import com.teamdev.jxbrowser.dsl.browser.navigation
 import com.teamdev.jxbrowser.dsl.dom.documentElement
 import com.teamdev.jxbrowser.dsl.dom.findById
 import com.teamdev.jxbrowser.dsl.frame.document
+import com.teamdev.jxbrowser.dsl.subscribe
 import com.teamdev.jxbrowser.engine.RenderingMode
+import com.teamdev.jxbrowser.navigation.event.FrameLoadFinished
+import java.util.concurrent.CountDownLatch
 
 /**
  * This example demonstrates how to obtain the list of existing attributes
  * of a specified HTML element.
  */
 fun main(): Unit = Engine(RenderingMode.OFF_SCREEN).use { engine ->
     val browser = engine.newBrowser()
-    val mainFrame = browser.mainFrame?.also { it.loadHtml(HTML_LINK) }
-    val document = mainFrame?.document?.documentElement
+    browser.loadHtmlAndWait(HTML_LINK)
+    val document = browser.mainFrame?.document?.documentElement
     val link = document?.findById("link")!!
     link.attributes().asMap().forEach(::println)
 }
 
+private fun Browser.loadHtmlAndWait(html: String) {
+    val latch = CountDownLatch(1)
+    navigation.subscribe<FrameLoadFinished> { latch.countDown() }
+    navigation.loadHtml(html)
+    awaitUninterruptibly(latch)
+}
+
 private val HTML_LINK = """
     <html lang="en">
     <body>

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomKeyEvents.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomKeyEvents.kt
@@ -58,7 +58,7 @@ fun main() {
 private fun Browser.loadHtmlAndWait(html: String) {
     val latch = CountDownLatch(1)
     navigation.subscribe<FrameLoadFinished> { latch.countDown() }
-    mainFrame?.loadHtml(html)
+    navigation.loadHtml(html)
     awaitUninterruptibly(latch)
 }
 

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomMouseEvents.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomMouseEvents.kt
@@ -57,7 +57,7 @@ fun main() {
 private fun Browser.loadHtmlAndWait(html: String) {
     val latch = CountDownLatch(1)
     navigation.subscribe<FrameLoadFinished> { latch.countDown() }
-    mainFrame?.loadHtml(html)
+    navigation.loadHtml(html)
     awaitUninterruptibly(latch)
 }
 

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomQuerySelector.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomQuerySelector.kt
@@ -50,7 +50,7 @@ fun main() {
     singleWindowApplication(title = "DOM query selector") {
         BrowserView(browser)
         LaunchedEffect(Unit) {
-            browser.mainFrame?.loadHtml(HTML_PARAGRAPHS)
+            browser.navigation.loadHtml(HTML_PARAGRAPHS)
         }
     }
 }

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomSelectOption.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/DomSelectOption.kt
@@ -48,7 +48,7 @@ fun main() {
         select.options[2].select() // Selects "Opel".
     }
 
-    browser.mainFrame?.loadHtml(
+    browser.navigation.loadHtml(
         """
             <html lang="en">
             <body>

diff --git a/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/FileUpload.kt b/examples/src/main/kotlin/com/teamdev/jxbrowser/examples/FileUpload.kt
@@ -23,7 +23,7 @@ package com.teamdev.jxbrowser.examples
 import androidx.compose.ui.window.singleWindowApplication
 import com.teamdev.jxbrowser.browser.callback.OpenFileCallback
 import com.teamdev.jxbrowser.dsl.Engine
-import com.teamdev.jxbrowser.dsl.browser.mainFrame
+import com.teamdev.jxbrowser.dsl.browser.navigation
 import com.teamdev.jxbrowser.dsl.register
 import com.teamdev.jxbrowser.engine.RenderingMode
 import com.teamdev.jxbrowser.view.compose.BrowserView
@@ -42,7 +42,7 @@ fun main() {
         tell.open(Path("file.txt"))
     })
 
-    browser.mainFrame?.loadHtml(
+    browser.navigation.loadHtml(
         """
             Please specify a file, or a set of files:<br>
             <input type='file' name='datafile' size='40'>