HTMLLinkElement
===============

The **`HTMLLinkElement`** interface represents reference information for external resources and the relationship of those resources to a document and vice versa (corresponds to `<link>` element; not to be confused with `<a>`, which is represented by `HTMLAnchorElement`). This object inherits all of the properties and methods of the `HTMLElement` interface.

EventTarget

Node

Element

HTMLElement

HTMLLinkElementInstance properties
-------------------

*Inherits properties from its parent, `HTMLElement`.*

`HTMLLinkElement.as`

A string representing the type of content being loaded by the HTML link when `rel="preload"` or `rel="modulepreload"`.

`HTMLLinkElement.crossOrigin`

A string that corresponds to the CORS setting for this link element. See CORS settings attributes for details.

`HTMLLinkElement.disabled`

A boolean value which represents whether the link is disabled; currently only used with style sheet links.

`HTMLLinkElement.fetchPriority`

An optional string representing a hint given to the browser on how it should prioritize fetching of a preload relative to other resources of the same type. If this value is provided, it must be one of the possible permitted values: `high` to fetch at a higher priority, `low` to fetch at a lower priority, or `auto` to indicate no preference (which is the default).

`HTMLLinkElement.href`

A string representing the URI for the target resource.

`HTMLLinkElement.hreflang`

A string representing the language code for the linked resource.

`HTMLLinkElement.media`

A string representing a list of one or more media formats to which the resource applies.

`HTMLLinkElement.referrerPolicy`

A string that reflects the `referrerpolicy` HTML attribute indicating which referrer to use.

`HTMLLinkElement.rel`

A string representing the forward relationship of the linked resource from the document to the resource.

`HTMLLinkElement.relList` Read only 

A `DOMTokenList` that reflects the `rel` HTML attribute, as a list of tokens.

`HTMLLinkElement.sizes` Read only 

A `DOMTokenList` that reflects the `sizes` HTML attribute, as a list of tokens.

`HTMLLinkElement.sheet` Read only 

Returns the `StyleSheet` object associated with the given element, or `null` if there is none.

`HTMLLinkElement.type`

A string representing the MIME type of the linked resource.

### Obsolete properties

`HTMLLinkElement.charset` 
Deprecated

A string representing the character encoding for the target resource.

`HTMLLinkElement.rev` 
Deprecated

A string representing the reverse relationship of the linked resource from the resource to the document.

**Note:** Currently the W3C HTML 5.2 spec states that `rev` is no longer obsolete, whereas the WHATWG living standard still has it labeled obsolete. Until this discrepancy is resolved, you should still assume it is obsolete.

`HTMLLinkElement.target` 
Deprecated

A string representing the name of the target frame to which the resource applies.

Instance methods
----------------

*No specific method; inherits methods from its parent, `HTMLElement`.*

Specifications
--------------

| Specification |
| --- |
| HTML Standard # htmllinkelement |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* The HTML element implementing this interface: `<link>`.