The most advanced HTTP Client and Url Builder with Functional Chaining, Async/Await, Delay, Fork, Infinite Chaining and Repeat for building your Complex APIs easily.
Alternative to Requests, Axios, and Got.
npm install url-request --save
const Url = require('url-request')
Look Examples
Building a Ping server was never as easy! This pings at an interval of 1s and let's you know if you're connected or not.
Url('https://postman-echo.com/get')
.get()
.then(() => console.log('Ping Successful! Internet is up 🤟'))
.catch(() => console.log('Ping Failed! Internet is down 😭'))
.repeat(1000, 100) // time 1000ms
Send a GET request with an access token, then display the result or catch errors.
GET https://my-json-server.typicode.com/typicode/demo/posts/comments
Url('https://my-json-server.typicode.com')
.go('typicode/demo')
.go('posts')
.query({ access_token: 'MyAccessToken' })
.get() // GET Request
.then(json => console.log(json))
.catch(err => console.error('[Error]', err))
[{ id: 1, post: 'Post 1' },
{ id: 2, post: 'Post 2' }]
Build Complex Urls with deep paths, multiple queries (lists are supported) and fragments.
const url = Url('https://api.workpay.com')
.go('rooms', 'open', 'users')
.query({ id: [10, 12, 13, 14] })
.query({ access_token: 'my-token', password: 'password'})
.fragment('bio')
.url
// https://api.workpay.com//rooms/open/users?id=10,12,13,14&
// access_token=my-token&password=password#bio
Url('https://postman-echo.com')
.invoke('go', 'post')
.invoke('encodeResponse', null) // To Get Full Response Object
.invoke('post', { foo1: 'bar1', foo2: 'bar2' })
.execute()
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err))
const userApi = Url('https://api.workpay.com')
.go('user', 123)
const subscriptionsApi = userApi
.fork()
.fragment('subscriptions')
const achievementsApi = userApi
.fork()
.fragment('achievements')
[ userApi, subscriptionsApi, achievementsApi ]
.forEach(api => api
.then(json => console.log(json))
.catch(err => console.log(err)))
A POST request with a body { subscrbe: 'Apple Music' }
at https://api.workpay.com/user/123#subscriptions
Url('https://api.workpay.com')
.go('user', 123)
.fragment('subscriptions')
.post({ subscrbe: 'Apple Music' })
.then(json => console.log(json)) // { success: true }
.catch(err => console.error(err))
const post = async () => {
const request = Url('https://postman-echo.com')
.go('post')
.post({ foo1: 'bar1', foo2: 'bar2' })
return await request
}
Delay your requests!
Url('https://postman-echo.com/post')
.delay(2000, () => console.log('Wait 2s'))
.post({ foo1: 'bar1', foo2: 'bar2' })
Url('https://my-json-server.typicode.com')
.go('typicode/demo')
.go('posts')
.get()
.then(json => console.log('[1]', json))
.catch(err => console.error('[Error]', err))
.go(1)
.get()
.then(json => console.log('[2]', json))
.catch(err => console.error('[Error]', err))
.post()
.post()
... // Keep on going!
class Url {
// Url Construction
constructor (baseUri) // Start with the baseUri
go (...paths) // Go to Sub Path
query (q) // q is query object
fragment (f) // add fragments like #profile
// Fork
fork ()
// default encoding is 'json', can be null, 'string', 'buffer'
encodeResponse (encoding)
// Set headers
header (headers)
// get the formed url as a string
get url ()
// Requests
get (body, statusCode) // GET Request
post (body, statusCode) // POST Request
put (body, statusCode) // PUT Request
delete (body, statusCode) // DELETE Request
patch (body, statusCode) // PATCH Request
then (func)
catch (func)
finally (func)
delay (time, func)
repeat (time, count)
// Command Control, Lazy Execution
invoke (command, ...args)
execute (invokeCommands)
}
- OAuth
- HTTP2
- Proxy
- Compression
- Timeout Handling
- Custom Hooks
- Request Cancellation