retryable-fetch-ts

retryable-fetch-ts is a lightweight TypeScript package designed to simplify API fetching with built-in support for automatic retries and configurable timeouts. It is particularly useful in scenarios where network reliability is uncertain, and repeated attempts are necessary to ensure successful API communication.

demo version working example (refer the demo folder for the example code in the github repo)

Feautures

• Automatic Retry Logic: Automatically retries failed API requests based on a user-defined retry interval and maximum retry count.
• Configurable Timeout: Allows setting a timeout duration to limit how long the fetch operation should continue attempting retries.
• Customizable Parameters: Supports flexible configuration for retry intervals, maximum attempts, and timeout thresholds.
• Lightweight and Easy to Use: Minimal dependencies and a simple API make it easy to integrate into any TypeScript or JavaScript project.
• Improved Reliability: Ideal for use cases where APIs may intermittently fail and require multiple attempts to succeed.

Installation

1npm install retryable-fetch-ts

Usage Example

1import { retryFetch } from 'retryable-fetch-ts';
2
3function App() {
4	const [dataList, setDataList] = useState([])
5	const [secondApiresp, setSecondApiResp] = useState(null)
6
7    useEffect(() => {
8		retryApiCalls()
9	}, [])
10
11    const retryApiCalls = async () => {
12		const backendBseAPI = 'https://fictional-orbit-v5gvqp9gx9qhpv7g-3001.app.github.dev' //you might have to change this to your specs
13
14		// direct api call without failure
15		await retryFetch(backendBseAPI + '/' + 'artworks', { credentials: 'include' }, 5000, 0).then(resp => {
16			console.log(resp)
17			setDataList(resp?.data)
18		}).catch(err => {
19			console.log('api failed after retrying....',err)
20		})
21
22		// api call with failure and with interval and timeout specified 
23		await retryFetch(backendBseAPI + '/' + 'failure_api', { credential: 'include' }, 2000, 10000).then(resp => {
24			console.log(resp)
25		}).catch(err => {
26			console.log('api failed after retrying ...')
27			setSecondApiResp(err?.message)
28		})
29	}

🔧 Parameters

Parameter	Type	Description
api	string	The API endpoint URL to be fetched.
metadata	object	Optional metadata or request options (e.g., headers, body, method).
interval	number	Time (in milliseconds) between each retry attempt.
timeout	number	Maximum duration (in milliseconds) to keep retrying before giving up.

Contributing

We welcome contributions! Feel free to submit issues, feature requests, or pull requests to help improve this package.