skills/bun-guides-websocket-simple/SKILL.md
Build a simple WebSocket server
npx skillsauth add jarle/bun-skills Bun Build a simple WebSocket serverInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Start a simple WebSocket server using Bun.serve.
Inside fetch, we attempt to upgrade incoming ws: or wss: requests to WebSocket connections.
const server = Bun.serve({
fetch(req, server) {
const success = server.upgrade(req);
if (success) {
// Bun automatically returns a 101 Switching Protocols
// if the upgrade succeeds
return undefined;
}
// handle HTTP request normally
return new Response("Hello world!");
},
websocket: {
// TypeScript: specify the type of ws.data like this
data: {} as { authToken: string },
// this is called when a message is received
async message(ws, message) {
console.log(`Received ${message}`);
// send back a message
ws.send(`You said: ${message}`);
},
},
});
console.log(`Listening on ${server.hostname}:${server.port}`);
development
Using TypeScript with Bun, including type definitions and compiler options
development
Learn how to write tests using Bun's Jest-compatible API with support for async tests, timeouts, and various test modifiers
testing
Learn how to use snapshot testing in Bun to save and compare output between test runs
testing
Learn about Bun test's runtime integration, environment variables, timeouts, and error handling