Example
Display the value of the download attribute of a link:
var x = document.getElementById("myAnchor").download;
The result of x will be:
w3logo
Try it Yourself »
Definition and Usage
The download property sets or returns the value of the download attribute of a link.
The download attribute specifies that the target will be downloaded when a user clicks on the hyperlink.
Note: The download attribute is new for the <a> element in HTML5.
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| download | Yes | 12.0 | Yes | Not supported | 15.0 |
Syntax
Return the download property:
anchorObject.download
Set the download property:
anchorObject.download=filename
Property Values
| Value | Description |
|---|---|
| filename | Specifies some text to be used as the filename (no need to specify the file extension - the browser will automatically detect the correct file extension and add it to the file, e.g. .img, .pdf. .txt, .html, etc.). If omitted, the original filename is used. |
Technical Details
| Return Value: | A String, representing the name of the downloaded file |
|---|
More Examples
Example
Change the value of the download attribute of a link:
document.getElementById("myAnchor").download = "newValue";
Try it Yourself »
Related Pages
HTML reference: HTML <a> download attribute
< Anchor Object