I receive file url as response from api. when user clicks on download button, the file should be downloaded without opening file preview in a new tab. How to achieve this in react js?
-
4Triggering browser download from front-end is not a reliable way to do it. You should create endpoint that when called, will provide the correct response headers, thus triggering the browser download. Front-end code can only do so much. The 'download' attribute for example, might just open the file in a new tab depending on the browser.Jackyef– Jackyef2018-06-05 08:08:48 +00:00Commented Jun 5, 2018 at 8:08
-
1From my understanding, you are saying that it can be achieved by rest api with correct response headers, is it right?Sameer Thite– Sameer Thite2018-06-05 08:15:46 +00:00Commented Jun 5, 2018 at 8:15
-
1Yes. I didn't know how to attach a link in comment, so I posted an answer.Jackyef– Jackyef2018-06-05 08:20:38 +00:00Commented Jun 5, 2018 at 8:20
27 Answers
tldr; fetch the file from the url, store it as a local Blob, inject a link element into the DOM, and click it to download the Blob
I had a PDF file that was stored in S3 behind a Cloudfront URL. I wanted the user to be able to click a button and immediately initiate a download without popping open a new tab with a PDF preview. Generally, if a file is hosted at a URL that has a different domain that the site the user is currently on, immediate downloads are blocked by many browsers for user security reasons. If you use this solution, do not initiate the file download unless a user clicks on a button to intentionally download.
In order to get by this, I needed to fetch the file from the URL getting around any CORS policies to save a local Blob that would then be the source of the downloaded file. In the code below, make sure you swap in your own fileURL, Content-Type, and FileName.
fetch('https://cors-anywhere.herokuapp.com/' + fileURL, {
method: 'GET',
headers: {
'Content-Type': 'application/pdf',
},
})
.then((response) => response.blob())
.then((blob) => {
// Create blob link to download
const url = window.URL.createObjectURL(blob);
const link = document.createElement('a');
link.href = url;
link.setAttribute(
'download',
`FileName.pdf`,
);
// Append to html link element page
document.body.appendChild(link);
// Start download
link.click();
// Clean up and remove the link
link.parentNode.removeChild(link);
});
This solution references solutions to getting a blob from a URL and using a CORS proxy.
Update As of January 31st, 2021, the cors-anywhere demo hosted on Heroku servers will only allow limited use for testing purposes and cannot be used for production applications. You will have to host your own cors-anywhere server by following cors-anywhere or cors-server.
3 Comments
new Blob([blob])? You already have a Blob in blobThis is not related to React. However, you can use the download attribute on the anchor <a> element to tell the browser to download the file.
<a href='/somefile.txt' download>Click to download</a>
This is not supported on all browsers: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a
4 Comments
download observes the same-origin-policy FYIdownload property is supported in 95% of browsers: caniuse.com/download so... 🤷♂️If you are using React Router, use this:
<Link to="/files/myfile.pdf" target="_blank" download>Download</Link>
Where /files/myfile.pdf is inside your public folder.
2 Comments
Triggering browser download from the frontend is not reliable.
What you should do is, create an endpoint on a server that when called, responds with the correct response headers, thus triggering the browser download.
Frontend code can only do so much. The 'download' attribute for example, might just open the file in a new tab depending on the browser and the type of the file.
The response headers you need to look at are Content-Type and Content-Disposition. You should check this answer for a more detailed explanation on those headers.
5 Comments
Content-Type and Content-Disposition.onClick={() => axios.get("..")}, the download doesn't work. What could be wrong with my approach?Solution (Work Perfect for React JS, Next JS)
You can use js-file-download and this is my example:
import axios from 'axios'
import fileDownload from 'js-file-download'
...
handleDownload = (url, filename) => {
axios.get(url, {
responseType: 'blob',
})
.then((res) => {
fileDownload(res.data, filename)
})
}
...
<button onClick={() => {this.handleDownload('https://your-website.com/your-image.jpg', 'test-download.jpg')
}}>Download Image</button>
This plugin can download excel and other file types.
4 Comments
browsers are smart enough to detect the link and downloading it directly when clicking on an anchor tag without using the download attribute.
after getting your file link from the api, just use plain javascript by creating anchor tag and delete it after clicking on it dynamically immediately on the fly.
const link = document.createElement('a');
link.href = `your_link.pdf`;
document.body.appendChild(link);
link.click();
document.body.removeChild(link);
This is how I did it in React:
import MyPDF from '../path/to/file.pdf';
<a href={myPDF} download="My_File.pdf"> Download Here </a>
It's important to override the default file name with download="name_of_file_you_want.pdf" or else the file will get a hash number attached to it when you download.
Comments
import resume from '../assets/data/resume.pdf';
<a href={resume} download="YourName resume.pdf"> Download CV </a>
1 Comment
fetchFile(){
axios({
url: `/someurl/thefiles/${this.props.file.id}`,
method: "GET",
headers: headers,
responseType: "blob" // important
}).then(response => {
const url = window.URL.createObjectURL(new Blob([response.data]));
const link = document.createElement("a");
link.href = url;
link.setAttribute(
"download",
`${this.props.file.name}.${this.props.file.mime}`
);
document.body.appendChild(link);
link.click();
// Clean up and remove the link
link.parentNode.removeChild(link);
});
}
render(){
return( <button onClick={this.fetchFile}> Download file </button>)
}
2 Comments
responseType: 'blob' solved my problem.I have the exact same problem, and here is the solution I make use of now: (Note, this seems ideal to me because it keeps the files closely tied to the SinglePageApplication React app, that loads from Amazon S3. So, it's like storing on S3, and in an application, that knows where it is in S3, relatively speaking.
Steps
3 steps:
- Make use of file saver in project: npmjs/package/file-saver (
npm install file-saveror something) - Place the file in your project You say it's in the components folder. Well, chances are if you've got web-pack it's going to try and minify it.(someone please pinpoint what webpack would do with an asset file in components folder), and so I don't think it's what you'd want. So, I suggest to place the asset into the
publicfolder, under aresourceor anassetname. Webpack doesn't touch thepublicfolder andindex.htmland your resources get copied over in production build as is, where you may refer them as shown in next step. - Refer to the file in your project Sample code:
import FileSaver from 'file-saver'; FileSaver.saveAs( process.env.PUBLIC_URL + "/resource/file.anyType", "fileNameYouWishCustomerToDownLoadAs.anyType");
Source
Appendix
- I also try
Linkcomponent ofreact-routerreact-router-docs/Link. The zip file would download, and somehow would unzip properly. Generally, links have blue color, to inherit parent color scheme, simply add a prop like:style={color: inherit}or simply assign a class of your CSS library likebutton button-primaryor something if you're Bootstrappin' - Other sage questions it's closely related to:
1 Comment
You can use FileSaver.js to achieve this goal:
const saveFile = () => {
fileSaver.saveAs(
process.env.REACT_APP_CLIENT_URL + "/resources/cv.pdf",
"MyCV.pdf"
);
};
<button className="cv" onClick={saveFile}>
Download File
</button>
2 Comments
You can define a component and use it wherever.
import React from 'react';
import PropTypes from 'prop-types';
export const DownloadLink = ({ to, children, ...rest }) => {
return (
<a
{...rest}
href={to}
download
>
{children}
</a>
);
};
DownloadLink.propTypes = {
to: PropTypes.string,
children: PropTypes.any,
};
export default DownloadLink;
Comments
Download file
For downloading you can use multiple ways as been explained above, moreover I will also provide my strategy for this scenario.
npm install --save react-download-linkimport DownloadLink from "react-download-link";- React download link for client side cache data
<DownloadLink label="Download" filename="fileName.txt" exportFile={() => "Client side cache data here…"} /> - Download link for client side cache data with Promises
<DownloadLink label="Download with Promise" filename="fileName.txt" exportFile={() => Promise.resolve("cached data here …")} /> - Download link for data from URL with Promises Function to Fetch data from URL
getDataFromURL = (url) => new Promise((resolve, reject) => { setTimeout(() => { fetch(url) .then(response => response.text()) .then(data => { resolve(data) }); }); }, 2000); - DownloadLink component calling Fetch function
<DownloadLink label=”Download” filename=”filename.txt” exportFile={() => Promise.resolve(this. getDataFromURL (url))} />
Happy coding! ;)
1 Comment
I don't recommend using documents in React since accessing DOM directly is not the best practice. Without any library, it's achievable in React way: (Functional component): Create a link and hide it with CSS. Also, the Href attribute should refer to a state where you have your data. Also, with the useRef hook, you can access your link tag. Now imagine you have a function in which you fetch your data from an API, and you can put the data in your state when it's there, and then immediately you can click on your hidden programmatically in you useEffect link via the ref like the following:
const dataLink = useRef();
const [data, setData] = useState();
useEffect(() => {
if (data) {
dataLink.current.click();
}
}, [data]);
const fetchData = async () => {
const response = await fetch("http://example.com/data.json");
const data = await response.json();
setData(data);
};
return (
<a className="hidden-element" download href={data} ref={dataLink}></a>
);
As soon as you call fetchData function in your component, it will automatically download the data which is fetched from the API.
Comments
The package that solved my download link issue was:
npm install --save react-download-link
Use it like this:
fileDownload(axiosResponse.data, 'filename.csv');
You can create e.g. a C# Web API Endpoint like this on the backend side:
[HttpGet("GenerateSitemap")]
public async Task<IActionResult> GenerateSitemap()
{
var sitemapString = "[place-xml-sitemap-string-here]";
var serializedObj = JsonConvert.SerializeObject(obj);
var bytesObj = Encoding.UTF8.GetBytes(serializedObj);
return File(sitemapString.SerializeToByteArray(), "application/octet-stream");
}
Comments
Download from server URL ( amazon s3 )
Create a Utility Function
export function download(url: string) {
const a = document.createElement("a");
a.href = url;
const clickEvnt = new MouseEvent("click", {
view: window,
bubbles: true,
cancelable: true,
});
a.dispatchEvent(clickEvnt);
a.remove();
}
Usage:
download("link-to-file-in-server")
Comments
//Just change react <Link> tag to HTML <a> tag and pass the name of the file to the href attribute
<a
href={details.cv}
className="text-deep my-0"
download={details.cv}
target="_blank"
>
{details.first_name} CV
</a>
1 Comment
- to check that there is window object
- to revoke URL after download
- createObjectURL can have MediaSource as an argument
export const download = (blob: Blob | MediaSource, filename: string) => {
if (!window) {
return;
}
const blobUrl = window.URL.createObjectURL(blob);
const anchor = window.document.createElement('a');
anchor.download = filename;
anchor.href = blobUrl;
anchor.click();
window.URL.revokeObjectURL(blobUrl);
};
<button onClick={() => download(blob, filename)}>Download</button>
Comments
Backend Nodejs with typescript
export const getFile = async (req: Request, res: Response) => {
try {
const requestBody: requestBody = requestBodySchema.parse(req.body);
const document= await YOURMODEL.findOne({ _id: requestBody.documentID });
if (!document) {
res.status(404).send({ message: "document not found" });
return;
}
//MY document has a field called fileContents which has the actual file
//stored as sting and a fileName field
const stringData = document?.fileContents;
const filename = document?.fileName || "nameNotDefined";
if (!stringData) {
res.status(404).send({ message: "File content not found" });
return;
}
//Creating a buffer to send a long string
const buffer = Buffer.from(stringData, "utf-8");
//Setting appropriate headers and sending buffer to frontend
res.setHeader("Content-Type", "text/plain");
res.setHeader("Content-Disposition", `attachment;
filename="${filename}"`);
res.status(200).send(buffer);
return;
} catch (error: any) {
if (error instanceof ZodError) {
res.status(400).json({ message: "Invalid input" });
return;
}
res
.status(500)
.json({ Error: ` ${error}` });
return;
}
};
Frontend : Nextjs|React.js
<button onClick= {()=>handleDownloadFile(_id,fileName)}
<DownloadIcon width={16} height={16} />
</button>
export async function handleDownloadFile(_id,filename) {
try {
const response = await fetch(
`YOURAPIROUTE`,
{
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ documentID : _id}),
}
);
if (!response.ok) {
//Handle bad response
}
//Conver buffer response into blob to create a downloadable url
const blob = await response.blob();
const url = window.URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = URL;
a.download = filename;
a.click();
window.URL.revokeObjectURL(url);
} catch (error) {
// Handle error, e.g., show an error message or fallback data
}
}
Comments
We can user react-download-link component to download content as File.
<DownloadLink
label="Download"
filename="fileName.txt"
exportFile={() => "Client side cache data here…"}/>
https://frugalisminds.com/how-to-download-file-in-react-js-react-download-link/
Comments
Alot of good answers, I think Brian Li's answer was good. To nitpick, the Content-Type in fetch is for when you're sending data to the server and not receiving.
Also it's important for long lasting apps that hasn't been reloaded yet make sure to do URL.revokeObjectURL(url) after using the link. Should also removeChild the link you've created to if you are no longer using it :)))
1 Comment
Its better to use packages. I'm using Nextjs and with 'use client' this works: Focus on Aria-label when building apps to help visually impaired people. Thanks.
Install and import file-saver package as below:
import fileSaver from 'file-saver'
Invoke the saveAs to download.
<button
onClick={() => {
fileSaver.saveAs(
"https://yolo-chill-buddy.com/myfile.pdf",
"my-file.pdf"
);
}}
aria-label="Do this and it works - chill"
>
<span>Download</span>
</button>
Comments
I have tried this DownloadLink, it is fetching the data from API which I can see using dev tools but it is not trigerring file download. any idea if I am missing anything ?
This is what I have used:
getDataFromURL = (url) => new Promise((resolve, reject) => {
setTimeout(() => {
fetch(url)
.then(response => response.text())
.then(data => {
resolve(data)
});
});
});
2 Comments
code blocks, your }); is currently outside the blocks.