Registry / http-networking / simple-get

simple-get

JSON →
library4.0.1jsnpmunverified

simple-get is a minimalist HTTP client library for Node.js, providing the simplest way to make HTTP GET requests with essential features like HTTPS support, automatic redirect following, and gzip/deflate decompression. It focuses on being a lightweight wrapper (under 120 lines of code) around Node.js's native `http` and `https` modules, minimizing overhead. The current stable version is 4.0.1. It maintains a stable API, primarily using callback patterns, and is known for its reliability and efficiency in basic request scenarios. Key differentiators include its small footprint and stream-first approach, making it ideal for scenarios where a full-featured HTTP client is overkill, or when composing with other stream-based utilities.

http-networking
npm install simple-get
github ↗package ↗
INSTALL
IMPORT
SIG · SIMPLE-GET
S
simple-get
http-networkingjavascriptv4.0.1
Install
—
Import
—
Disk
—
Pass rate
0/ 6
Env Coverage0 / 6
glibc
18–22
musl
18–22
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18–226 runs
build_error
glibc
node 18–226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

get
✓ const get = require('simple-get')
✗ import get from 'simple-get'
simple-get is primarily a CommonJS module. While Node.js's CJS-ESM interoperability allows `import get from 'simple-get'`, the canonical and most reliable way to import it, especially for older Node.js versions or complex module setups, is `require`.
get.concat
✓ const get = require('simple-get'); get.concat('http://example.com', cb)
✗ import { concat } from 'simple-get'
The `concat` method is a property of the main `get` function, not a named export. It's used for convenience when buffering the entire response is desired instead of handling a stream.
get.post
✓ const get = require('simple-get'); get.post(opts, cb)
✗ import { post } from 'simple-get'
Similar to `concat`, `post` is a method attached to the default exported `get` function. `simple-get` uses this pattern for all HTTP methods beyond GET.

Demonstrates a basic GET request using `get.concat` to fetch and parse JSON data from a public API, including error handling for network issues and non-200 responses.

const get = require('simple-get'); async function fetchData() { const url = 'https://jsonplaceholder.typicode.com/posts/1'; console.log(`Fetching data from: ${url}`); return new Promise((resolve, reject) => { get.concat(url, function (err, res, data) { if (err) { console.error('Request failed:', err.message); return reject(err); } if (res.statusCode !== 200) { console.error(`Received status code ${res.statusCode}`); return reject(new Error(`Server responded with status ${res.statusCode}`)); } try { const json = JSON.parse(data.toString()); console.log('Received data successfully:'); console.log(json); resolve(json); } catch (parseErr) { console.error('Failed to parse JSON:', parseErr.message); reject(parseErr); } }); }); } fetchData().catch(e => console.error('Overall error:', e.message));
Debug
Known issues
gotchaBy default, `simple-get` returns an `IncomingMessage` stream object (res) for GET requests. If you don't consume or pipe this stream, the connection may hang or resources may not be released, especially in long-running applications. The `get.concat` method is provided for convenience to automatically buffer the entire response body.
fix
Always pipe or consume the `res` stream: `res.pipe(someStream)` or `res.on('data', ...)`, `res.on('end', ...)`. Alternatively, use `get.concat(url, callback)` to buffer the response automatically.
affects: >=1.0.0
gotcha`simple-get` uses a callback-based API, which can be less ergonomic for modern JavaScript projects that primarily use Promises or `async/await`. While the library itself doesn't provide a Promise-based interface, users often wrap it manually.
fix
Wrap `simple-get` calls in a Promise. For example: `new Promise((resolve, reject) => get.concat(opts, (err, res, data) => err ? reject(err) : resolve({ res, data })))`.
affects: >=1.0.0
gotchaThe `json: true` option for requests only handles automatic JSON serialization for the request `body` and parsing for the response `data`. It does not set the `Content-Type: application/json` header automatically for requests, which is crucial for many APIs.
fix
When sending JSON, explicitly set the `Content-Type` header in the `opts` object: `{ headers: { 'Content-Type': 'application/json' }, json: true, body: myObject }`.
affects: >=1.0.0
Errors
Common errors & fixes
Error: connect ECONNREFUSED 127.0.0.1:80
The client failed to connect to the specified host and port, likely because the server is not running or is inaccessible.
fix
Verify that the target server is online and listening on the correct IP address and port. Check firewall rules or network connectivity if connecting to a remote host.
Error: Request timed out
The request took longer than the specified `timeout` option to complete, causing `simple-get` to abort the connection.
fix
Increase the `timeout` option value in milliseconds to allow more time for the request to complete, or investigate why the server is slow to respond. `get({ url: '...', timeout: 5000 }, callback)`
TypeError: Cannot read properties of undefined (reading 'statusCode')
This typically occurs when the callback function is executed with an `err` object, but the code proceeds to access properties of the `res` (response) object without checking if `res` is undefined or null, which happens on network errors.
fix
Always check for an `err` object first in the callback: `get(opts, function (err, res) { if (err) { /* handle error */ return; } console.log(res.statusCode); });`
Upgrade
Version history
4.0.1latest on npm
Audit
Dependencies

No dependency data recorded yet.

Agent activity
12 hits · last 30 days
node
10
OpenAI (training)
1
Resources
githubhttps://github.com/feross/simple-get ↗
packagehttps://www.npmjs.com/package/simple-get ↗
simple-get — npm install simple-get · libregistry