THE WORLD'S LARGEST WEB DEVELOPER SITE

Anchor download Property

❮ Anchor Object

Example

Display the value of the download attribute of a link:

var x = document.getElementById("myAnchor").download;
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