Next-nfetch NPM

Contributors Issues License

Features

Make http requests from browser and node js
Intercept request
Formatted Response and Error configuration
Support Nextjs cache and revalidate

Built With

Typescript and built in browser fetch

Installing

Package manager

Using npm:

$ npm install next-nfetch@latest

Once the package is installed, you can import the library using import or require approach:

import httpClient from "next-nfetch";

const httpClient = require('next-nfetch');

Usage

You can directly call a function as default exported is a function. There are lots of methods attach to the base function such as get, post, put, etc.

Function Can ba called as:

const response = httpClient("url", options) // or
const response = httpClient({
  ...options, // Available options are listed below
  url
})

options	types	default	required
url	string		yes
method	string	get	no
headers	Headers		no
params	Object	{ }	no
next	Object	{ }	no
data	any	undefined	no
timeout	number	0	no
cache	RequestCache	no-cache	no
timeoutMessage	string	Request Timeout. Failed to fetch	no

Methods with no data attributes

get, delete, options and head

Methods with data attributes

post. put and patch

Specific methods

const response  = await httpClient.get("url", options);
const response  = await httpClient.delete("url", options);

const response  = await httpClient.post("url", options);
const response  = await httpClient.patch("url", options);

and so on

Response format

API Success Response

{
  data: any; // obtained data from api endpoint
  headers: Record<string, string>; // response headers
  request: HTTPRequestDetails; // request configuration
  response: Response; // actual response send by fetch request
  status: number; // http status code
  statusText: string;
}

API Error Response

{
  message: string; // error message
  request?: HTTPRequestDetails; // request configuration
  response?: HTTPResponseDetails; // error response details
  name: "HttpError" | "TimeoutError";
  stack?: any; // stack trace where error occurs
}

Creating an instance

You can create a new instance of next-nfetch with a custom config.

const instance = httpClient.create({
  baseURL: "https://some-domain.com/api/",
  timeout: 1000,
});

Requesting from httpclient

try {
  const res = await instance.get("/users/1", options);
  console.log(res);
  
} catch (error) {
  console.log(error);
}

Creating an request interceptors

You can create a request interceptor of next-nfetch with a custom config.

instance.useRequestInterceptor({
  onFulfilled(config) {
    // way to intercept request methods
    config.headers.set("Authorization", "Bearer token");
    return config;
  },

  onRejected(error) {
    return Promise.reject(error);
  },
});

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have suggestions for adding or removing projects, feel free to open an issue to discuss it, or directly create a pull request after you edit the README.md file with necessary changes.
Please make sure you check your spelling and grammar.
Create individual PR for each suggestion.