Response Object

HTTP Response

Status Code

res.status(code)

Set HTTP status code.

Headers

res.setHeader(name, value)  // Set response header
res.getHeader(name)         // Get response header
res.getHeaders()            // Get all response headers

Content Types

JSON Response

res.json(data)

Send JSON response with Content-Type: application/json.

HTML Response

res.html(content)

Send HTML response with Content-Type: text/html.

Text Response

res.text(content)

Send plain text response with Content-Type: text/plain.

XML Response

res.xml(content)

Send XML response with Content-Type: application/xml.

Generic Response

res.send(data)

Send generic response with automatic content type detection.

End Response

res.end(data?)

End response with optional data.

Set Content Type

res.setContentType(string)

Set content type for end and send methods.

File Operations

Send File

res.sendFile(file)

Send uploaded file.

Send Multiple Files

res.sendFiles(files)

Send multiple files.

Send Buffer

res.sendBuffer(buffer, contentType?, size?)

Send binary data.

Send Multipart

res.sendMultipart(data)

Send multipart data.

Download File

res.download(filepath, filename?)

Trigger file download.

Attachment

res.attachment(filename?)

Set attachment header.

Redirects

Redirect

res.redirect(url, status?)

Redirect to URL with optional status code (default: 302).

Cookies

Set Cookie

res.setCookie(name, value, options?)

Set response cookie with advanced options.

Cookie Options

res.setCookie('sessionId', 'abc123', {
  httpOnly: true,
  secure: true,
  sameSite: 'Strict',
  maxAge: 24 * 60 * 60, // 24 hours
  path: '/',
  domain: 'example.com'
});

Get Cookie

res.getCookie(name)

Get response cookie value.

Get All Cookies

res.getCookies()

Get all response cookies as object.

Remove Cookie

res.removeCookie(name, path?, domain?)

Remove cookie by setting expiration.

Clear Cookies

res.clearCookies()

Remove all cookies from response.

Example Usage

app.get('/api/user/{id}', (req, res) => {
  const { id } = req.params;
  
  // Set custom headers
  res.setHeader('X-User-ID', id);
  res.setHeader('Cache-Control', 'no-cache');
  
  // Set cookies
  res.setCookie('lastViewed', id, {
    httpOnly: true,
    maxAge: 3600
  });
  
  // Send response
  res.json({
    id,
    name: 'John Doe',
    email: 'john@example.com'
  });
});

app.post('/api/upload', (req, res) => {
  if (req.hasFile('document')) {
    const file = req.getFile('document');
    
    // Send file as download
    res.download(file.filepath, file.filename);
  } else {
    res.status(400).json({ error: 'No file uploaded' });
  }
});