A lightweight Node.js utility to extract query parameters and request body data from IncomingMessage. Supports common Content-Type formats and safe fallbacks.
- ✅ Extract query parameters from
GETrequests - ✅ Parse request body from
POSTrequests - ✅ Supports
application/json,x-www-form-urlencoded,text/plain,multipart/form-data, and others - ✅ Safe fallback parsing
- ✅ Zero dependencies
- ✅ Configurable parsing options: encoding, content-type override, raw mode, and custom error handling
npm install body-data
# or
pnpm add body-databodyData is a high-level utility that returns both params (query) and body data.
import http from 'node:http'
import { bodyData } from 'body-data'
http.createServer(async (req, res) => {
const data = await bodyData(req)
res.setHeader('Content-Type', 'application/json')
res.end(JSON.stringify(data))
}).listen(3000)Request Example:
curl "http://localhost:3000?name=lete&age=18" \
-X POST \
-H "Content-Type: application/json" \
-d '{"gender":"male"}'Response:
{
"params": {
"name": "lete",
"age": "18"
},
"body": {
"gender": "male"
}
}Use getParams to only extract query parameters from the URL.
import http from 'node:http'
import { getParams } from 'body-data'
http.createServer((req, res) => {
const params = getParams(req)
res.setHeader('Content-Type', 'application/json')
res.end(JSON.stringify({ params }))
}).listen(3000)Request Example:
A348
curl "http://localhost:3000?foo=bar&count=10"Response:
{
"params": {
"foo": "bar",
"count": "10"
}
}Use getBody to only extract the body from a POST request.
import http from 'node:http'
import { getBody } from 'body-data'
http.createServer(async (req, res) => {
const body = await getBody(req)
res.setHeader('Content-Type', 'application/json')
res.end(JSON.stringify({ body }))
}).listen(3000)Request Example:
curl "http://localhost:3000" \
-X POST \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "username=test&password=1234"Response:
{
"body": {
"username": "test",
"password": "1234"
}
}Returns an object with:
params: Query parameters (from URL)body: Parsed request body
Parses the query string from the request URL.
Parses the body of the request based on Content-Type. Supports:
application/jsonapplication/x-www-form-urlencodedtext/plainmultipart/form-data(returns raw string)- Fallback: returns
{ raw: string }
| Option | Type | Description |
|---|---|---|
raw |
boolean |
Return raw body string instead of parsing. Default: false |
encoding |
BufferEncoding |
Text encoding for reading the body. Default: 'utf-8' |
contentType |
string |
Force a specific Content-Type (overrides request headers) |
backContentType |
string |
Fallback Content-Type when none is provided |
onError |
(err: Error) => void |
Custom error handler for parse or stream errors |
const body = await getBody(req, {
raw: false,
encoding: 'utf-8',
contentType: 'application/json',
backContentType: 'text/plain',
onError: err => console.error('Body parse error:', err),
})pnpm test