feat!: Implement sobek script engine

This removes the experimental Goja JavaScript engine and replaces it
with Sobek, a fork of Goja, but with ESM support

Author: stroiman

.gitignore

@@ -1,3 +1,4 @@
 # Temporary files while running tests
 *.test
 node_modules/
+*.log

dom/event/event_target.go

@@ -227,5 +227,5 @@ func (e *eventTarget) logger() (res *slog.Logger) {
 	if res == nil {
 		res = log.Default()
 	}
-	return res
+	return
 }

go.mod

@@ -7,6 +7,7 @@ require (
 	github.com/gost-dom/css v0.1.0
 	github.com/gost-dom/fixture v0.1.0
 	github.com/gost-dom/v8go v0.0.0-20250712111039-fd213ddc42d7
+	github.com/grafana/sobek v0.0.0-20251113105955-976a34df9c09
 	github.com/onsi/gomega v1.38.2
 	github.com/stretchr/testify v1.11.1
 	golang.org/x/net v0.47.0

go.sum

@@ -24,6 +24,10 @@ github.com/gost-dom/fixture v0.1.0 h1:7PnEpkuww1QBOh4gyoR8updPfyosHJfxmFRY+2t05+
 github.com/gost-dom/fixture v0.1.0/go.mod h1:7mSGaBhOfi/NO+YiD426CQ1DTkko62vYxoSVRmveqqY=
 github.com/gost-dom/v8go v0.0.0-20250712111039-fd213ddc42d7 h1:l8UeevV8eXNZ3t40WrxoT6cfeGyYShV+I4mjfuOcSPc=
 github.com/gost-dom/v8go v0.0.0-20250712111039-fd213ddc42d7/go.mod h1:IiR7SWCB6ZLT7HgLd0TCjEaSHdGJvJqhhfujJMrv0Qk=
+github.com/grafana/sobek v0.0.0-20251103154147-6b40183f38e5 h1:Xq3nZfEjUR6E1TndDx+/8jkvX1x6ENDBvCV0zEW71wo=
+github.com/grafana/sobek v0.0.0-20251103154147-6b40183f38e5/go.mod h1:YtuqiJX1W3XvRSilL/kUZzduJG3phPJWyzM9DiIEfBo=
+github.com/grafana/sobek v0.0.0-20251113105955-976a34df9c09 h1:7hKNwELLbDrtpAggI21fqlVnbXS98zJ0pJIEs2t61wM=
+github.com/grafana/sobek v0.0.0-20251113105955-976a34df9c09/go.mod h1:YtuqiJX1W3XvRSilL/kUZzduJG3phPJWyzM9DiIEfBo=
 github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0=
 github.com/kr/pretty v0.3.0/go.mod h1:640gp4NfQd8pI5XOwp5fnNeVWj67G7CFk/SaSQn7NBk=
 github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=

internal/clock/clock.go

@@ -124,12 +124,21 @@ func New(options ...NewClockOption) *Clock {
 	return c
 }
 
+func (c *Clock) setLogger(l *slog.Logger) *slog.Logger {
+	if l == nil {
+		l = log.Default()
+	}
+	l = l.With("pkg", "gost-dom/clock")
+	c.Logger = l
+	return l
+}
+
 func (c *Clock) logger() *slog.Logger {
 	l := c.Logger
 	if l == nil {
-		l = log.Default()
+		l = c.setLogger(nil)
 	}
-	return l.With("pkg", "gost-dom/clock")
+	return l
 }
 
 // runMicrotasksAndFlush runs first microtasks, e.g., tasks added using
@@ -198,6 +207,7 @@ func (c *Clock) runWhile(predicate func() bool) []error {
 // Returns an error if any of the added tasks generate an error. Panics if the
 // task list doesn't decrease in size. See [Clock] documentation for more info.
 func (c *Clock) Advance(d time.Duration) error {
+	c.logger().Debug("Clock.Advance", "duration", d, "clock", c)
 	endTime := c.Time.Add(d)
 	errs := c.runMicrotasksAndFlush()
 	errs = append(errs, c.runWhile(func() bool {
@@ -207,6 +217,13 @@ func (c *Clock) Advance(d time.Duration) error {
 	return errors.Join(errs...)
 }
 
+func (c *Clock) LogValue() slog.Value {
+	return slog.GroupValue(
+		slog.Int("noMicrotasks", len(c.microtasks)),
+		slog.Int("noTasks", len(c.tasks)),
+	)
+}
+
 // Tick runs all tasks scheduled for immediate execution. This is synonymous
 // with calling Advance(0).
 func (c *Clock) Tick() error { return c.Advance(0) }
@@ -421,7 +438,9 @@ func (c *Clock) RunAll() error {
 // NewClockOption are used to initialize a new [Clock]
 type NewClockOption func(*Clock)
 
-func WithLogger(l *slog.Logger) NewClockOption { return func(c *Clock) { c.Logger = l } }
+func WithLogger(l *slog.Logger) NewClockOption {
+	return func(c *Clock) { c.setLogger(l) }
+}
 
 // Initializes the clock's simulated time from a concrete [time.Time] value.
 func OfTime(t time.Time) NewClockOption {

internal/test/integration/test-app/content/public/datastar/datastar.rc6.js

@@ -1879,4 +1879,3 @@ export {
   I as stopPeeking,
   he as watcher,
 };
-//# sourceMappingURL=datastar.js.map

internal/test/scripttests/datastar_suite.go

@@ -101,10 +101,12 @@ func RunDataStarTests(t *testing.T, e html.ScriptEngine) {
 		win.HTMLDocument().GetHTMLElementById("echo-input-field").Focus()
 		ctrl := controller.KeyboardController{Window: win}
 		ctrl.SendKey(key.RuneToKey('a'))
+		ctrl.SendKey(key.RuneToKey('b'))
+		ctrl.SendKey(key.RuneToKey('c'))
 		win.Clock().RunAll()
 
 		output := win.HTMLDocument().GetHTMLElementById("echo-output")
-		assert.Equal(t, "a", output.TextContent())
+		assert.Equal(t, "abc", output.TextContent())
 
 	})
 }

internal/test/scripttests/document_suite.go

@@ -71,3 +71,14 @@ func (s *DocumentTestSuite) TestNewDocument() {
 		s.MustEval("Object.getPrototypeOf(actual).constructor.name"),
 		"Actual constructor")
 }
+
+func (s *DocumentTestSuite) TestQuerySelectorAll() {
+	s.MustLoadHTML(
+		`<body><div>0</div><div data-key="1">1</div><div data-key="2">2</div></body>`,
+	)
+	s.Expect(
+		s.MustEval(
+			"Array.from(document.querySelectorAll('[data-key]')).map(x => x.outerHTML).join(',')",
+		),
+	).To(Equal(`<div data-key="1">1</div>,<div data-key="2">2</div>`))
+}

internal/test/scripttests/download_suite.go

@@ -0,0 +1,39 @@
+package scripttests
+
+import (
+	"testing"
+
+	"github.com/gost-dom/browser/html"
+	"github.com/gost-dom/browser/internal/testing/gosttest"
+	. "github.com/gost-dom/browser/testing/gomega-matchers"
+	"github.com/onsi/gomega"
+	"github.com/stretchr/testify/assert"
+)
+
+func RunDownloadScriptSuite(t *testing.T, e html.ScriptEngine) {
+	t.Run("Load script from source", func(t *testing.T) {
+		const indexHTML = `
+		<!DOCTYPE html>
+		<html>
+			<head><script src="module.js"></script></head>
+			<body>
+				<h1>Module test</h1>
+				<div id="tgt"></div>
+			</body>
+		</html>`
+		const moduleJS = `
+			document.addEventListener("DOMContentLoaded", () => {
+				document.getElementById("tgt").textContent="CONTENT";
+			})
+		`
+		server := gosttest.HttpHandlerMap{
+			"/index.html": gosttest.StaticHTML(indexHTML),
+			"/module.js":  gosttest.StaticJS(moduleJS),
+		}
+		win, err := initBrowser(t, e, server).Open("https://example.com/index.html")
+		assert.NoError(t, err)
+		g := gomega.NewWithT(t)
+		g.Expect(win.Document().GetElementById("tgt")).To(HaveTextContent("CONTENT"))
+
+	})
+}

internal/test/scripttests/htmx_suite.go

@@ -0,0 +1,98 @@
+package scripttests
+
+import (
+	"testing"
+
+	"github.com/gost-dom/browser/html"
+	app "github.com/gost-dom/browser/internal/test/integration/test-app"
+	"github.com/gost-dom/browser/internal/testing/browsertest"
+	. "github.com/gost-dom/browser/internal/testing/gomega-matchers"
+	"github.com/gost-dom/browser/internal/testing/htmltest"
+	. "github.com/gost-dom/browser/testing/gomega-matchers"
+	"github.com/onsi/gomega"
+)
+
+func RunHtmxTests(t *testing.T, e html.ScriptEngine) {
+	t.Run("Click to increment counter", func(t *testing.T) {
+		t.Parallel()
+
+		expect := gomega.NewWithT(t).Expect
+		server := app.CreateServer()
+		b := htmltest.NewBrowserHelper(t, browsertest.InitBrowser(t, server, e))
+		win, err := b.Open("/counter/index.html")
+		expect(err).ToNot(HaveOccurred())
+		counter := win.Document().GetElementById("counter").(html.HTMLElement)
+		expect(counter).To(HaveInnerHTML(Equal("Count: 1")))
+		counter.Click()
+		counter = win.Document().GetElementById("counter").(html.HTMLElement)
+		expect(counter).To(HaveInnerHTML(Equal("Count: 2")))
+	})
+
+	t.Run("Click hx-get link", func(t *testing.T) {
+		t.Parallel()
+
+		expect := gomega.NewWithT(t).Expect
+		server := app.CreateServer()
+		b := htmltest.NewBrowserHelper(t, browsertest.InitBrowser(t, server, e))
+		win := b.OpenWindow("/navigation/page-a.html")
+		expect(win.ScriptContext().Eval("window.pageA")).To(BeTrue())
+		expect(win.ScriptContext().Eval("window.pageB")).To(BeNil())
+
+		// Click an hx-get link
+		win.HTMLDocument().GetHTMLElementById("link-to-b").Click()
+
+		expect(
+			win.ScriptContext().Eval("window.pageA"),
+		).To(BeTrue(), "Script context cleared from first page")
+		expect(win.ScriptContext().Eval("window.pageB")).To(
+			BeTrue(), "Scripts executed on second page")
+		expect(win.Document()).To(
+			HaveH1("Page B"), "Page heading", "Heading updated, i.e. htmx swapped")
+		expect(win.Location().Pathname()).To(Equal("/navigation/page-a.html"), "Location updated")
+	})
+
+	t.Run("Clock boosted link", func(t *testing.T) {
+		t.Parallel()
+
+		expect := gomega.NewWithT(t).Expect
+		server := app.CreateServer()
+		b := htmltest.NewBrowserHelper(t, browsertest.InitBrowser(t, server, e))
+		win, err := b.Open("/navigation/page-a.html")
+		expect(err).ToNot(HaveOccurred())
+
+		// Click an hx-boost link
+		expect(win.ScriptContext().Eval("window.pageA")).ToNot(BeNil())
+		expect(win.ScriptContext().Eval("window.pageA")).To(BeTrue())
+		expect(win.ScriptContext().Eval("window.pageB")).To(BeNil())
+		win.Document().GetElementById("link-to-b-boosted").(html.HTMLElement).Click()
+
+		expect(win.ScriptContext().Eval("window.pageA")).ToNot(BeNil(), "A")
+		expect(win.ScriptContext().Eval("window.pageB")).ToNot(BeNil(), "B")
+		expect(win.ScriptContext().Eval("window.pageA")).To(
+			BeTrue(), "Script context cleared from first page")
+		expect(win.ScriptContext().Eval("window.pageB")).To(
+			BeTrue(), "Scripts executed on second page")
+		expect(win.Document()).To(
+			HaveH1("Page B"), "Page heading", "Heading updated, i.e. htmx swapped")
+		expect(win.Location().Pathname()).To(Equal("/navigation/page-b.html"), "Location updated")
+	})
+
+	t.Run("Form submit", func(t *testing.T) {
+		t.Parallel()
+
+		expect := gomega.NewWithT(t).Expect
+		server := app.CreateServer()
+		b := htmltest.NewBrowserHelper(t, browsertest.InitBrowser(t, server, e))
+		win, err := b.Open("/forms/form-1.html")
+		expect(err).ToNot(HaveOccurred())
+		i1 := win.Document().GetElementById("field-1")
+		i1.SetAttribute("value", "Foo")
+
+		btn := win.Document().GetElementById("submit-btn").(html.HTMLElement)
+		expect(len(server.Requests)).To(Equal(2), "No of requests _before_ click")
+		btn.Click()
+		expect(len(server.Requests)).To(Equal(3), "No of requests _after_ click")
+		elm := win.Document().GetElementById("field-value-1")
+		expect(elm).To(HaveTextContent("Foo"))
+	})
+}