Content Handling

HTTP Range Requests

Support partial content requests for streaming large files, videos, and media with efficient byte-range handling.

Basic Range Request Support

MoroJS provides built-in HTTP range request middleware for efficient streaming of large files and media content.

Enable Range Requests

typescript

1import { range } from '@morojs/moro';
2import fs from 'fs/promises';
3
4// Enable range requests
5app.use(range({
6  acceptRanges: 'bytes',
7  maxRanges: 5
8}));
9
10// Serve video with range support
11app.get('/videos/:id', async (req, res) => {
12  const videoPath = `./videos/${req.params.id}.mp4`;
13  const stats = await fs.stat(videoPath);
14  
15  // sendRange handles partial content automatically
16  res.sendRange(videoPath, stats);
17});

Range Request Features

Support for HTTP Range header (bytes)
Automatic partial content responses (206)
Content-Range header generation
Efficient streaming of large files
Support for multiple ranges
Video and media streaming support

Advanced Usage

Range Support for Custom Data

typescript

1import { range } from '@morojs/moro';
2
3// Range support for custom data
4app.get('/api/data', (req, res) => {
5  const data = getLargeData();
6  
7  if (req.headers.range) {
8    const range = parseRange(req.headers.range, data.length);
9    res.status(206); // Partial Content
10    res.setHeader('Content-Range', `bytes ${range.start}-${range.end}/${data.length}`);
11    res.setHeader('Accept-Ranges', 'bytes');
12    res.setHeader('Content-Length', range.end - range.start + 1);
13    return data.slice(range.start, range.end + 1);
14  }
15  
16  return data;
17});
18
19// Streaming large files
20app.get('/download/:file', async (req, res) => {
21  const filePath = `./files/${req.params.file}`;
22  const stats = await fs.stat(filePath);
23  
24  // Automatically handles range requests
25  res.sendRange(filePath, stats);
26});

Best Practices

Do

Enable range requests for large files
Use range requests for video streaming
Set appropriate maxRanges limits
Handle range errors gracefully
Use Content-Range headers correctly
Support resume downloads

Don't

Enable range for small files
Skip range validation
Allow unlimited ranges
Ignore range errors
Use range for dynamic content
Skip Content-Range headers