Node.HTTP

data Server :: Type

The type of a HTTP server object

data Request :: Type

A HTTP request object

data Response :: Type

A HTTP response object

createServer :: (Request -> Response -> Effect Unit) -> Effect Server

Create a HTTP server, given a function to be executed when a request is received.

listen :: Server -> ListenOptions -> Effect Unit -> Effect Unit

Listen on a port in order to start accepting HTTP requests. The specified callback will be run when setup is complete.

close :: Server -> Effect Unit -> Effect Unit

Close a listening HTTP server. The specified callback will be run the server closing is complete.

type ListenOptions = { backlog :: Maybe Int, hostname :: String, port :: Int }

Options to be supplied to listen. See the Node API for detailed information about these.

listenSocket :: Server -> String -> Effect Unit -> Effect Unit

Listen on a unix socket. The specified callback will be run when setup is complete.

onUpgrade :: Server -> (Request -> Socket -> Buffer -> Effect Unit) -> Effect Unit

Listen to upgrade events on the server

httpVersion :: Request -> String

Get the request HTTP version

requestHeaders :: Request -> Object String

Get the request headers as a hash

requestMethod :: Request -> String

Get the request method (GET, POST, etc.)

requestURL :: Request -> String

Get the request URL

requestAsStream :: Request -> Readable ()

Coerce the request object into a readable stream.

setHeader :: Response -> String -> String -> Effect Unit

Set a header with a single value.

setHeaders :: Response -> String -> Array String -> Effect Unit

Set a header with multiple values.

setStatusCode :: Response -> Int -> Effect Unit

Set the status code.

setStatusMessage :: Response -> String -> Effect Unit

Set the status message.

responseAsStream :: Response -> Writable ()

Coerce the response object into a writable stream.