util/wsTest - WebSocket Test Server

Reference for extensions/util/wsTest.lua. Runs a local WebSocket server for testing GE Lua execution, reloads, and bandwidth measurements from a browser.

Exports

Supported Commands

Internals

• Server setup: Uses wsUtils.createOrGetWS('any', 8083, ...) with protocol 'bng-test' and serves static files from ./ui/entrypoints/util_wsTest/.
• Lua execution: exec(cmd) wraps loadstring("return " .. cmd) in xpcall with stack trace for safe evaluation.
• Bandwidth test: Generates random data chunks (size/100 repeated 10x) and sends as JSON with type "bandwidthUp", followed by "done".
• Event loop: onUpdate polls server:getPeerEvents(), handles data events (type 'D'), and calls server:update().

How It Works

1. Load via extensions.load('util_wsTest').
2. Opens a WebSocket server on port 8083 accessible at http://<address>:8083.
3. Browser clients connect and send JSON commands.
4. Server processes commands and sends JSON responses back.

-- Load the test server
extensions.load('util_wsTest')
-- Access via browser: http://localhost:8083
-- Send from browser: {"type": "execGELua", "cmd": "1+1"}
-- Receive: {"result": 2}

Additional Exports

• M.onExtensionLoaded - (undocumented)
• M.onExtensionUnloaded - (undocumented)
• M.onUpdate - (undocumented)