Anchor download Property

Anchor Object Reference Anchor Object

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

Internet Explorer Firefox Opera Google Chrome Safari

The download property is supported in Firefox, Opera and Chrome.

Note: The download property is not supported in Internet Explorer, Safari or Opera 12 and earlier versions.


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 Reference Anchor Object

SHARE THIS PAGE

COLOR PICKER

colorpicker