Giter Site home page Giter Site logo

fetch-it's Introduction

fetch-it

An enhanced HTTP client based on fetch.

Blogpost: [fetch-it an enhanced http client based on fetch] (http://blog.tryolabs.com/2016/03/02/fetch-it-enhanced-http-client-based-on-fetch/)

Features

You can do all the same thing that you do with fetch, plus:

  • Add middleware, to intercept requests and responses
  • Create custom config instances

Installation

using npm:

$ npm install --save fetch-it

Examples

GET request

fetchIt.get('http://httpbin.org/get?param1=param1')
  .then((response) => response.json())
  .then((json) => console.log(json))
  .catch((error) => console.error(error));

POST request

fetchIt.post('http://httpbin.org/post?param1=param1', {
  param2: 'param2',
  param3: 'param3'
}).then((response) => response.json())
  .then((json) => console.log(json))
  .catch((error) => console.error(error));

API

Request methods

fetchIt.fetch(url[, options])

fetchIt.fetch(request)

You can perform requests the same way as you do with fetch().

fetchIt.fetch(url, {
  method: 'POST',
  body: JSON.stringify(data),
  headers: {
    'Content-Type': 'application/json'
  }
}).then((response) => {
  // handle response
}).catch((error) => {
  // handle error
});

And we provide some convenience aliases for the supported methods.

fetchIt.get(url[, options])

fetchIt.get(request)

fetchIt.post(url[, data[, options]])

fetchIt.post(request)

fetchIt.put(url[, data[, options]])

fetchIt.put(request)

fetchIt.patch(url[, data[, options]])

fetchIt.patch(request)

fetchIt.delete(url[, options])

fetchIt.delete(request)

fetchIt.head(url[, options])

fetchIt.head(request)

Creating custom config instances

You can create a custom config instance of fetchIt

fetchIt.create([options])

let apiFetch = fetchIt.create({
  headers: {
    'Authorization': 'Bearer ' + getAPIToken(),
    'X-My-Custom-Header': 'CustomHeader'
  }
});

apiFetch.get(url).then((response) => {
  // handle response
}).catch((error) => {
  // handle error
});

Middleware

You can add middleware objects to any instance, to intercept requests and responses.

The middleware object must have defined at least one of these methods:

  • request(request), to intercept a request,
  • requestError(error), to intercept an error from a previous middleware,
  • response(response), to intercept a response,
  • responseError(error), to intercept an error from a previous middleware.
let jsonMiddleware = {
  response(res) {
    return res.json().catch((e) => {
      return e;
    });
  }
};

fetchIt.addMiddlewares(ArrayOfMiddlewares)

fetchIt.addMiddlewares([jsonMiddleware]);

fetchIt.clearMiddlewares()

Roadmap

  • Better docs
  • Add more middlewares
  • Add better tests
  • Add travis and coveralls
  • Create another project to create something similar to $resource based on fetch-it.

Credits

fetchIt is heavily based on Axios, but based on fetch().

License

MIT © Tryolabs

fetch-it's People

Contributors

asaayers avatar dig3 avatar mfagioli avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

fetch-it's Issues

Can't find variable:self error

simulator screen shot mar 28 2016 3 33 50 pm

when import fetch-it an error occurred

code:

import React, {
  AppRegistry,
  Component,
  StyleSheet,
  Text,
  View,
  Image,
  Platform,
  BackAndroid
} from 'react-native';

import {
  MKTextField,
  MKColor,
  MKButton,
  mdl,
} from 'react-native-material-kit';

import {
  Scene,
  Router,
  Switch,
  TabBar,
  Modal,
  Schema,
  Actions
} from 'react-native-router-flux';

import NavBar from './NavbarRender';
import Styles from './Styles';
import FetchIt from 'fetch-it';
import realm from '../models/realm';

and my package.json

  "name": "Zootopia",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "start": "node node_modules/react-native/local-cli/cli.js start"
  },
  "dependencies": {
    "fetch-it": "^0.2.0",
    "react": "^0.14.7",
    "react-native": "^0.22.2",
    "react-native-material-kit": "^0.3.0",
    "react-native-navbar": "^1.4.1",
    "react-native-router-flux": "^3.2.3",
    "realm": "^0.11.0"
  }
}

This error seems to be after I joined the realm occurred, and realm installation method:

npm install -g rnpm
npm install --save realm
rnpm link realm

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.