{{JSRef}}
Summary
The link()
method creates an {{HTMLElement("a")}} HTML element that causes a string to be displayed as a hypertext link to another URL.
Syntax
str.link(url)
Parameters
url
- Any string that specifies the
href
attribute of the<a>
tag; it should be a valid URL (relative or absolute), with any&
characters escaped as&
, and any"
characters escaped as"
.
Description
Use the link()
method to create an HTML snippet for a hypertext link. The returned string can then be added to the document via {{domxref("document.write()")}} or {{domxref("element.innerHTML")}}.
Links created with the link()
method become elements in the links
array of the document
object. See {{domxref("document.links")}}.
Examples
Example: Using link()
The following example displays the word "MDN" as a hypertext link that returns the user to the Mozilla Developer Network.
var hotText = 'MDN'; var URL = 'https://developer.mozilla.org/'; console.log('Click to return to ' + hotText.link(URL)); // Click to return to <a href="https://developer.mozilla.org/">MDN</a>
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('ES6', '#sec-string.prototype.link', 'String.prototype.link')}} | {{Spec2('ES6')}} | Initial definition. Implemented in JavaScript 1.0. Defined in the (normative) Annex B for Additional ECMAScript Features for Web Browsers. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("1.0")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("1.0")}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Gecko-specific notes
- Starting Gecko 17.0 {{geckoRelease("17")}} the
"
(quotation mark) is now automatically replaced by its HTML reference character"
in theurl
parameter.
See also
- {{jsxref("String.prototype.anchor()")}}