wasm

func AddClass ¶

func AddClass(id, className string)

func AddEventListener ¶

func AddEventListener(el JSValue, event string, fn func())

AddEventListener attaches a persistent event listener to el for the given event name. fn is called with no arguments each time the event fires. The listener stays alive for the lifetime of the page — it is never removed automatically.

Common use cases: reacting to browser events (click, input, toggle) or framework events (htmx:afterSwap, htmx:beforeSwap) on any JSValue element including Document() and Window().

Example:

body := Document().Get("body")
AddEventListener(body, "htmx:afterSwap", func() {
    // re-sync DOM after HTMX swaps content
})

details := QuerySelector("details#menu")
AddEventListener(details, "toggle", func() {
    // react to open/close state changes
})

func AddEventListenerWithEvent ¶

func AddEventListenerWithEvent(el JSValue, event string, fn func(JSValue))

AddEventListenerWithEvent attaches a persistent event listener to el for the given event name. fn receives the browser Event object as a JSValue, giving access to event properties and methods. Use this when you need to inspect or interact with the event itself — call preventDefault, read event.target, event.key, event.clientX, event.detail, etc. The listener stays alive for the lifetime of the page — it is never removed automatically.

Example:

AddEventListenerWithEvent(form, "submit", func(e JSValue) {
    e.Call("preventDefault")               // stop the default form submission
    val := e.Get("target").Get("value").String()
})

AddEventListenerWithEvent(Document(), "keydown", func(e JSValue) {
    if e.Get("key").String() == "Escape" {
        // close modal, etc.
    }
})

func AppendChild ¶

func AppendChild(parent, child JSValue)

Element tree helpers — server-side no-ops.

func ClickElement ¶

func ClickElement(el JSValue)

func ConsoleLog ¶

func ConsoleLog(args ...any)

func CookieDelete ¶

func CookieDelete(key string)

func CookieGet ¶

func CookieGet(key string) string

func CookieSet ¶

func CookieSet(key, value string, opts ...CookieOptions)

Cookie helpers — server-side no-ops.

func CopyBytesToGo ¶

func CopyBytesToGo(dst []byte, src JSValue) int

func CopyBytesToJS ¶

func CopyBytesToJS(dst JSValue, src []byte) int

func CreateTopic ¶

func CreateTopic[T any](zero T, cfg TopicConfig) func() interface{}

CreateTopic declares a topic. The CLI AST scanner detects this call and generates the concrete typed accessor. Server-side this is a no-op stub.

func CreateWasmBoolFunc ¶

func CreateWasmBoolFunc(name string, fn func(bool))

func CreateWasmFunc ¶

func CreateWasmFunc(name string, fn func())

func CreateWasmStringFunc ¶

func CreateWasmStringFunc(name string, fn func(string))

func ExecJS ¶

func ExecJS(script string)

ExecJS executes a JavaScript snippet in the browser. Server-side no-op.

func ExtractRuntime ¶

func ExtractRuntime(destDir string) error

ExtractRuntime writes the embedded WASM runtime source files into destDir so TinyGo can compile against them. The resulting layout is:

destDir/
  go.mod          (module wasm-runtime, go 1.21)
  runtime/
    signal.go
    effect.go
    ...

The caller is responsible for removing destDir when the build is done.

func Fetch ¶

func Fetch(url string, config ...FetchConfig) (string, error)

Fetch makes an HTTP request using the browser's fetch API and blocks until complete. Config is optional — omit for a simple GET request. Must be called from inside a goroutine or CreateWasmFunc handler.

Example:

body, err := Fetch("https://api.example.com/todos/1")

body, err := Fetch("https://api.example.com/todos", FetchConfig{
    Method:  "POST",
    Headers: map[string]string{"Content-Type": "application/json"},
    Body:    `{"title":"foo"}`,
})

func FetchBytes ¶

func FetchBytes(url string, config ...FetchConfig) ([]byte, error)

FetchBytes makes an HTTP request and returns the response as raw bytes. Use this instead of Fetch when the response is binary (images, PDFs, ZIPs, etc.). Config is optional — omit for a simple GET. Must be called from inside a goroutine or CreateWasmFunc handler.

func GetFileBytes ¶

func GetFileBytes(id string) []byte

GetFileBytes reads the contents of the first file selected in a <input type="file"> element. Returns nil if the element is not found, no file is selected, or reading fails.

func GetValue ¶

func GetValue(id string) string

func GoBack ¶

func GoBack()

func LocalStorageGet ¶

func LocalStorageGet(key string) string

func LocalStorageRemove ¶

func LocalStorageRemove(key string)

func LocalStorageSet ¶

func LocalStorageSet(key, value string)

LocalStorage helpers — server-side no-ops.

func Navigate ¶

func Navigate(url string)

Navigation helpers — server-side no-ops.

func PushState ¶

func PushState(url, title string)

func Reload ¶

func Reload()

func RemoveClass ¶

func RemoveClass(id, className string)

func RemoveElement ¶

func RemoveElement(el JSValue)

func SessionStorageGet ¶

func SessionStorageGet(key string) string

func SessionStorageRemove ¶

func SessionStorageRemove(key string)

func SessionStorageSet ¶

func SessionStorageSet(key, value string)

SessionStorage helpers — server-side no-ops.

func SetAttr ¶

func SetAttr(id, attr, value string)

func SetHTML ¶

func SetHTML(id, html string)

func SetStyle ¶

func SetStyle(id, property, value string)

func SetText ¶

func SetText(id, value string)

func SetValue ¶

func SetValue(id, value string)

func ToggleClass ¶

func ToggleClass(id, className string)

func TriggerDownload ¶

func TriggerDownload(filename string, data []byte, mimeType string)

TriggerDownload prompts the browser to download `data` as a file named `filename` with the given MIME type. Server-side no-op.

func WriteClipboard ¶

func WriteClipboard(text string)

WriteClipboard writes text to the system clipboard. Server-side no-op.