SHARE THIS PAGE

JS & DOM Reference

Overview

JavaScript Objects

JS Array JS Boolean JS Date JS Math JS Number JS String JS RegExp JS Global

Browser Objects

Window Navigator Screen History Location

Core DOM Objects

DOM Node DOM NodeList DOM NamedNodeMap DOM Document DOM Element DOM Attr

HTML DOM Objects

DOM Document DOM Events DOM Elements
DOM Anchor DOM Area DOM Base DOM Body DOM Button DOM Form DOM Frame/IFrame DOM Frameset DOM Image DOM Input Button DOM Input Checkbox DOM Input File DOM Input Hidden DOM Input Password DOM Input Radio DOM Input Reset DOM Input Submit DOM Input Text DOM Link DOM Meta DOM Object DOM Option DOM Select DOM Style DOM Table DOM td / th DOM tr DOM Textarea

Document links Collection

Document Object

Definition and Usage

The links collection returns an array of all the links in the current document.

Tip: The links collection counts <a href=""> tags and <area> tags.

Syntax

document.links[].property

Browser Support

The links collection is supported in all major browsers.

Examples

Example 1

Return the number of links in the document:

<html>
<body>

<img src ="planets.gif" width="145" height="126" alt="Planets" usemap ="#planetmap">
<map name="planetmap">
<area shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun">
<area shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury">
<area shape="circle" coords="124,58,8" href="venus.htm" alt="Venus">
</map>

<p><a href="/js/">JavaScript Tutorial</a></p>

<p>Number of areas/links:
<script>
document.write(document.links.length);
</script></p>

</body>
</html>

The output of the code above will be:

Number of areas/links: 4

Try it yourself »

Example 2

Return the id of the first link in the document:

<html>
<body>

<img src ="planets.gif" width="145" height="126" alt="Planets" usemap ="#planetmap">
<map name="planetmap">
<area id="sun" shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun">
<area id="mercury" shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury">
<area id="venus" shape="circle" coords="124,58,8" href="venus.htm" alt="Venus">
</map>

<p><a id="javascript" href="/js/">JavaScript Tutorial</a></p>

<p>Id of first area/link:
<script>
document.write(document.links[0].id);
</script></p>

</body>
</html>

The output of the code above will be:

Id of first area/link: sun

Try it yourself »

Document Object