A simple and user-friendly React Hook library that enables asynchronous downloading of files, particularly CSV files. This library is ideal for applications that dynamically generate and download data.

Table of Contents

• Installation
• Usage
• API
• Types
• Examples
• License
• Contributing
• Acknowledgments

Installation

To install the library in your project, run the following command in your terminal:

1npm install react-async-csv-downloader

Usage

To use the library, import the useDownloadLink hook and implement it in your component. Here’s a basic example demonstrating how to use the hook effectively.

Examples

Basic Example

1import React from 'react';
2import { useDownloadLink } from 'react-async-csv-downloader';
3import { RawCSVExport } from './types';
4
5const MyComponent = () => {
6    const asyncResolver = async () => {
7        // Simulate an asynchronous data fetch, e.g., from an API
8        const response = await fetch('/api/data');
9        const data = await response.json();
10        
11        return {
12            file: new Blob([data], { type: 'text/csv' }),
13            type: 'text/csv',
14        } as RawCSVExport;
15    };
16
17    const { getProps } = useDownloadLink({
18        asyncResolver,
19        onStart: () => console.log('Download started...'),
20        onSuccess: () => console.log('Download successful!'),
21        onError: (error) => console.error('Download error:', error),
22    });
23
24    return (
25        <a {...getProps()} download="data.csv">
26            Download CSV
27        </a>
28    );
29};
30
31export default MyComponent;

API

useDownloadLink

1const { getProps } = useDownloadLink({
2    asyncResolver: () => Promise<RawCSVExport>;
3    onStart?: () => void;
4    onSuccess?: () => void;
5    onError?: (error: Error) => void;
6});

• asyncResolver: A function that resolves the data for download asynchronously and returns a Promise<RawCSVExport>.
• onStart: (optional) A callback function that is called when the download starts.
• onSuccess: (optional) A callback function that is called when the download is successful.
• onError: (optional) A callback function that is called when an error occurs during the download.

Types

1export type RawCSVExport = {
2    file: Blob;
3    type: string;
4};

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or a pull request if you have suggestions for improvements or new features.

Acknowledgments

• Thanks to the Open Source community for their support and inspiration.