Documentation
Modules
use/http

Module: use/http

Interfaces

Server/http

HandlerOptions

Ƭ HandlerOptions<Context>: HandlerOptions<IncomingMessage, RequestContext, Context>

Type parameters

NameType
Contextextends OperationContext = undefined

Defined in

src/use/http.ts:18


createHandler

createHandler<Context>(options): (req: IncomingMessage, res: ServerResponse) => Promise<void>

The ready-to-use handler for Node’s http.

Errors thrown from the provided options or callbacks (or even due to library misuse or potential bugs) will reject the handler or bubble to the returned iterator. They are considered internal errors and you should take care of them accordingly.

For production environments, its recommended not to transmit the exact internal error details to the client, but instead report to an error logging tool or simply the console.

import http from 'http';
import { createHandler } from 'graphql-sse/lib/use/http';
import { schema } from './my-graphql';
 
const handler = createHandler({ schema });
 
const server = http.createServer(async (req, res) => {
  try {
    await handler(req, res);
  } catch (err) {
    console.error(err);
    res.writeHead(500).end();
  }
});
 
server.listen(4000);
console.log('Listening to port 4000');

Type parameters

NameType
Contextextends OperationContext = undefined

Parameters

NameType
optionsHandlerOptions<Context>

Returns

fn

▸ (req, res): Promise<void>

Parameters
NameType
reqIncomingMessage
resServerResponse
Returns

Promise<void>

Defined in

src/use/http.ts:55