wails/website/docs/reference/runtime
Lea Anthony 01b661f6a5
feat(v2): add runtime.ResetSignalHandlers() for Linux panic recovery (#4921)
* feat(v2): add runtime.ResetSignalHandlers() for Linux panic recovery

Add a new runtime function that allows users to reset signal handlers
before code that might panic from nil pointer dereferences.

On Linux, WebKit installs signal handlers without the SA_ONSTACK flag,
which prevents Go from properly recovering from panics caused by
SIGSEGV and other signals. This function adds SA_ONSTACK to the
relevant signal handlers (SIGSEGV, SIGBUS, SIGFPE, SIGABRT).

Usage:
```go
go func() {
    defer func() {
        if err := recover(); err != nil {
            log.Printf("Recovered: %v", err)
        }
    }()
    runtime.ResetSignalHandlers()
    // Code that might panic...
}()
```

The function is a no-op on macOS and Windows.

Fixes #3965

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* test(v2): add panic-recovery-test example

Add an example that demonstrates the Linux signal handler issue (#3965)
and verifies the fix using runtime.ResetSignalHandlers().

The example includes:
- A Greet function that triggers a nil pointer dereference after a delay
- Auto-call from frontend after 5 seconds
- README with reproduction steps

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 18:55:57 +11:00
..
_category_.json [v2] Docs update 2021-09-27 19:35:30 +10:00
browser.mdx feat: optimize documentation website (#1849) 2022-09-18 22:01:50 +10:00
clipboard.mdx Add common text clipboard support (#2228) 2023-01-05 16:41:07 +11:00
dialog.mdx docs: fix and sync documents (#2135) 2022-11-28 20:13:22 +11:00
draganddrop.mdx Fix Drag & Drop JS runtime (#3516) 2024-06-10 15:15:28 +10:00
events.mdx fix: add missing EventsOffAll export to runtime templates (#4883) 2026-01-25 13:10:24 +11:00
intro.mdx feat(v2): add runtime.ResetSignalHandlers() for Linux panic recovery (#4921) 2026-02-02 18:55:57 +11:00
log.mdx docs: fix and sync documents (#2135) 2022-11-28 20:13:22 +11:00
menu.mdx docs: fix and sync documents (#2135) 2022-11-28 20:13:22 +11:00
screen.mdx Update Screen docs 2023-08-04 08:18:34 +10:00
window.mdx Fix typos (#3628) 2024-08-20 19:22:43 +10:00