Skip to content

Response

O objeto res contém dados a serem passados ​​como resposta e também helper que você também pode encadear entre os mesmos.

res: Response

typescript
interface Response extends ServerResponse {
    /**
     * Enviar resposta como application/json.
     *
     * Exemplos:
     *
     *     res.json(null);
     *     res.json({ fruit: 'apple' });
     *     res.status(200).json('oh we are here!');
     * @param body Informação a ser transformada em JSON
     * @returns Response
     */
    json: (body?: any) => Response

    /**
     * Setar um `código` de status.
     * @param code HTTP status code e.g. 200, 201, 400, 404...
     * @returns Response
     */
    status: (code: number) => Response

    /**
     * Enviar uma resposta text/plain.
     *
     * Exemplos:
     *
     *     res.text('hello world!');
     *     res.status(200).text('oh we are here!');
     * @param body Data to be transformed on text.
     * @returns Response
     */
    text: (body: unknown) => Response
}
interface Response extends ServerResponse {
    /**
     * Enviar resposta como application/json.
     *
     * Exemplos:
     *
     *     res.json(null);
     *     res.json({ fruit: 'apple' });
     *     res.status(200).json('oh we are here!');
     * @param body Informação a ser transformada em JSON
     * @returns Response
     */
    json: (body?: any) => Response

    /**
     * Setar um `código` de status.
     * @param code HTTP status code e.g. 200, 201, 400, 404...
     * @returns Response
     */
    status: (code: number) => Response

    /**
     * Enviar uma resposta text/plain.
     *
     * Exemplos:
     *
     *     res.text('hello world!');
     *     res.status(200).text('oh we are here!');
     * @param body Data to be transformed on text.
     * @returns Response
     */
    text: (body: unknown) => Response
}

PS: A interface ServerResponse faz parte da node:http api

json()

É um helper que permitirá retornar uma resposta JSON dentro de sua requisição.

typescript
lotto.get('/ping', ({ res }) => {
  return res.json({
    message: 'pong'
  })
  ...
})
lotto.get('/ping', ({ res }) => {
  return res.json({
    message: 'pong'
  })
  ...
})

PS: Você não precisa chamar um middleware para parsear json na solicitação, pois já fazemos isso internamente com nosso middleware @lottojs/body-parser.

status()

É um helper que permite definir um código de status para a resposta da sua solicitação.

typescript
lotto.get('/ping', ({ res }) => {
  return res.status(200).json({
    message: 'pong'
  })
  ...
})
lotto.get('/ping', ({ res }) => {
  return res.status(200).json({
    message: 'pong'
  })
  ...
})

text()

Em vez de retornar um json, você também pode definir uma resposta de texto.

typescript
lotto.get('/ping', ({ res }) => {
  return res.status(200).text('pong.')
  ...
})
lotto.get('/ping', ({ res }) => {
  return res.status(200).text('pong.')
  ...
})