Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Readme
Functional HTTP client for Node.js and Browsers with async/await.
Incredibly small browser version built on fetch with no external dependencies or polyfills.
const bent = require('bent')
const getJSON = bent('json')
const getBuffer = bent('buffer')
let obj = await getJSON('http://site.com/json.api')
let buffer = await getBuffer('http://site.com/image.png')
As you can see, bent is a function that returns an async function.
Bent takes options which constrain what is accepted by the client. Any response that falls outside the constraints will generate an error.
You can provide these options in any order, and Bent will figure out which option is which by inspecting the option's type and content.
const post = bent('http://localhost:3000/', 'POST', 'json', 200);
const response = await post('cars/new', {name: 'bmw', wheels: 4});
If you don't set a response encoding ('json'
, 'string'
or 'buffer'
)
then the native response object will be returned after the statusCode check.
In Node.js, we also add decoding methods that match the Fetch API (.json()
,
.text()
and .arrayBuffer()
).
const bent = require('bent')
const getStream = bent('http://site.com')
let stream = await getStream('/json.api')
// status code
stream.status // 200
stream.statusCode // 200
// optionally decode
const obj = await stream.json()
// or
const str = await stream.text()
The following options are available.
'GET'
, 'PUT'
, or any other ALLCAPS string will be
used to set the HTTP method. Defaults to 'GET'
.'string'
, 'buffer'
, and
'json'
. By default, the response object/stream will be returned instead
of a decoded response. Browser returns ArrayBuffer
instead of Buffer
.200
is the only acceptable status code. When any status codes
are provided, 200
must be included explicitly in order to be acceptable.The returned async function is used for subsequent requests.
When working with Binary this library uses different types in the browser and Node.js. In Node.js all binary must be done
using the Buffer
type. In the browser you can use ArrayBuffer or any ArrayBuffer view type (UInt8Array, etc).
async request(url[, body=null, headers={}])
const bent = require('bent')
const put = bent('PUT', 201)
await put('http://site.com/upload', Buffer.from('test'))
Or
const bent = require('bent')
const put = bent('PUT', 201, 'http://site.com')
await put('/upload', Buffer.from('test'))
NOTE: If the body
is passed as an object
, it will be treated
as JSON, stringified and the Content-Type
will be set to application/json
unless already set. A common requirement is to POST using form-urlencoded
.
This will require you to set the Content-Type
header to
application/x-www-form-urlencoded
and to encode the body yourself,
perhaps using
form-urlencoded.
FAQs
Functional HTTP client for Node.js w/ async/await.
The npm package bent receives a total of 217,455 weekly downloads. As such, bent popularity was classified as popular.
We found that bent demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.