url-request

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #go #android #rust #deep-learning #linux #macos #windows #kubernetes #mcp #openai

(★ 29)

The most advanced HTTP Client with Functional Chaining, Async/Await, Delay, Fork, Infinite Chaining and Repeat for building your Complex APIs easily.

url-request 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# url-request

[![Generic badge](https://img.shields.io/badge/build-1k-success.svg)](https://shields.io/) [![Generic badge](https://img.shields.io/badge/tests-100%25-brightgreen.svg)](https://shields.io/)
[![Generic badge](https://img.shields.io/badge/async/await-yes-0390fc.svg)](https://shields.io/) [![Generic badge](https://img.shields.io/badge/functional-yes-fa166a.svg)](https://shields.io/)

> _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.

## Installation

```sh
npm install url-request --save
```

## Initialize

```js
const Url = require('url-request')
```

## Examples

Look [Examples](/examples)

### Repeat

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.

```js
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
```

### GET Request w/ Promise

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`

```js
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))
```
```js
[{ id: 1, post: 'Post 1' },
 { id: 2, post: 'Post 2' }]
```

### Build A Complex Url

Build Complex Urls with deep paths, multiple queries (lists are supported) and fragments.

```js
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
```

### Invoke / Execute

```js
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))
```

### Fork

```js
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)))
```

### POST Request w/ Promise

A POST request with a body `{ subscrbe: 'Apple Music' }` at `https://api.workpay.com/user/123#subscriptions`

```js
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))
```

### Async/Await

```js
const post = async () => {
  const request = Url('https://postman-echo.com')
    .go('post')
    .post({ foo1: 'bar1', foo2: 'bar2' })
  
  return await request
}
```

### Delay

Delay your requests!

```js
Url('https://postman-echo.com/post')
  .delay(2000, () => console.log('Wait 2s'))
  .post({ foo1: 'bar1', foo2: 'bar2' })

```

### Infinite Chain

See [Infinite Chain Example](/examples/infinite-chain.js)

```js
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!
```

## Functions

```js
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)
}
```

## Upcoming

- [ ] OAuth
- [ ] HTTP2
- [ ] Proxy
- [ ] Compression
- [ ] Timeout Handling
- [ ] Custom Hooks
- [ ] Request Cancellation

url-request

url-request 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

url-request

url-request 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README