# vev > tiny HTTP request lib base on Fetch AP Latest version **0.0.4** (published 2020-06-26) · MIT license · 0 weekly downloads ## Install ```sh npm install vev pnpm add vev yarn add vev bun add vev ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support; pre 1.0. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.0.4 | | Published | 2020-06-26 | | First published | 2020-06-26 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 0 | | Unpacked size | 35 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Author | buuer | | Maintainers | buuer | | Keywords | fetch | ## Links - npm: https://www.npmjs.com/package/vev - npm.io page: https://npm.io/package/vev ## Alternatives - [gamedig](https://npm.io/package/gamedig.md) — 29.3K weekly downloads - [join-monster](https://npm.io/package/join-monster.md) — 12.8K weekly downloads - [masked](https://npm.io/package/masked.md) — 5.5K weekly downloads - [@comunica/actor-query-process-explain-logical](https://npm.io/package/@comunica/actor-query-process-explain-logical.md) — 4.7K weekly downloads - [@veracity/vui](https://npm.io/package/@veracity/vui.md) — 4.6K weekly downloads ## Recent versions - 0.0.4 (latest) — 2020-06-26 - 0.0.3 — 2020-06-26 - 0.0.2 — 2020-06-26 ## README # vev \ | inspired by [koa](https://github.com/koajs/koa) [axios](https://github.com/axios/axios) [redaxios](https://github.com/developit/redaxios) --- ## start ```html ``` ## usage ```js // import { vev } form 'vev' // const { vev } = require('vev/dist/index.common.js') vev.get('/user') vev.get('/user?id=3') vev.get('/user', { params: { id: 3 } }) // POST /user body: {"id":3,"name":foo } vev.post('/user', { id: 3, name: 'foo' }) // POST /user body: id=3&name=foo vev.post('/user', { id: 3, name: 'foo' }, { requestType: 'formData' }) vev.put( '/user', { name: 'foo' }, { headers: { token: 'token' }, params: { origin: '1' }, } ) vev.requset({ method: 'post', body: { name: 'name', id: '1' }, }) const vevUser = vev.mapConfig({ baseUrl: '/user', params: { pageNum: 1 } }) vevUser.get('/post', { params: { id: 1 } }) // GET /user/post?id=1&pageNum=1 const vevNewUser = vevUser.mapConfig({ baseUrl: '/newUser', params: { pageNum: 0 } }) vevNewUser.requset({ parmas: { id: 2 } }) // GET /newUser?id=2¶ms=0 // import fetch as fetchpolyfill from 'node-fetch' import { fetch as fetchPolyfill } from 'whatwg-fetch' const vevPolyfill = vev.mapConfig({ fetch: fetchPolyfill }) vevPolufill.get('/post') const vevPolyfillNewUSer = vevPolyfill.map(...vevNewUser.middleware()) ``` --- ## api ### vevConfig ```ts interface VevConf extends RequestInit { // RequestInit method?: httpMethod headers?: RequestInit['headers'] body?: RequestInit['body'] | plainObject // add plainObject mode?: 'cors' | 'no-cors' | 'same-origin' | 'navigate' credentials?: 'omit' | 'same-origin' | 'include' cache?: boolean redirect?: 'error' | 'follow' | 'manual' referrer?: string integrity?: string keepalive?: boolean signal?: AbortSignal referrerPolicy?: ReferrerPolicy // config url?: string baseUrl?: string params?: string | Record | URLSearchParams fetch?: Window['fetch'] responseType?: 'json' | 'arrayBuffer' | 'blob' | 'formData' | 'text' | 'row' // add row, default json requestType?: 'json' | 'formData' // default json, autoset headers['Conent-Type'] timeout?: number } ``` ### vev ```ts type middleware = (conf: VevConf | undefined, next) => Promise type middlewareConf = (conf: VevConf) => VevConf | Promise type middlewareRes = (err: null | any, res?: any) => Promise type resWithBody = { response: Response status: Response['status'] headers: Response['headers'] body: Response['body'] | any } export type Vev = { middleware: () => middleware[] version: () => string // configuration map: (...mid: middleware[]) => Vev mapConfig: (mid: VevConf | middlewareConf) => Vev mapResponse: (mid: middlewareRes) => Vev // request request: (config?: VevConf) => Promise get: (url: string, config?: VevConf) => Promise // head: ... post: (url: string, body?: B, config?: VevConf) => Promise // options: ... // delete: ... // put: ... // patch: ... } ``` --- ## middleware - withLoding ```js const withLoding = (config, next) => { const cancel = startLoading() return next(config).finally(() => cancel()) } const vevWithLoding = vev.map(withLoding) ``` - withToken ```js const vevWithToken = vev.mapConfig({ headers: { authToken: getToken() } }) // async const withToken = async (config) => { const token = await getToken() config.headers = Object.assgin({}, config.headers, { token }) return config } const vevWithToken = vev.mapConfig(withToken) ``` - gotoLogin ```js const gotoLogin = (err, res) => { if (!err) return res return err?.status === 401 ? gotoLogin() : Promise.reject(err) } const vevToLogin = vev.mapResponse(gotoLogin) ``` - withAuth ```js // compose const vevWithAuth = vev.map(withLoading).mapConfig(withToken).mapResponse(gotoLogin) const vevWithAuth = vevWithToken.map(withLoading).mapResponse(gotoLogin) ``` --- ## build ```bash esbuild --bundle ./src/index.ts --target=es6 --minify --format=esm --outfile=./dist/index.js esbuild --bundle ./src/index.ts --target=es6 --minify --format=cjs --outfile=./dist/index.common.js # test Deno test ./test.ts ``` ### about vev Fetch just like a shuttle, switch between client and server. vev in Norwegian means loom, it's sort and cute :p --- _Source: https://npm.io/package/vev · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._