Update net.serve docs for address change (#149)

This commit is contained in:
vocksel 2024-02-03 11:43:40 -08:00 committed by GitHub
parent fe4ba1db02
commit 347da823b7
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -113,12 +113,28 @@ type ServeWebSocketHandler = (socket: WebSocket) -> ()
Configuration for `net.serve`.
This may contain one of, or both of the following callbacks:
This may contain one of or more of the following values:
* `address` for setting the IP address to serve from. Defaults to the loopback interface (`http://localhost`).
* `handleRequest` for handling normal http requests, equivalent to just passing a function to `net.serve`
* `handleWebSocket` for handling web socket requests, which will receive a `WebSocket` object as its first and only parameter
When setting `address`, the `handleRequest` callback must also be defined.
```lua
net.serve(8080, {
address = "http://0.0.0.0",
handleRequest = function(request)
return {
status = 200,
body = "Echo:\n" .. request.body,
}
end
})
```
]=]
export type ServeConfig = {
address: string?,
handleRequest: ServeHttpHandler?,
handleWebSocket: ServeWebSocketHandler?,
}