{{JSRef("Global_Objects", "String")}}
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 thea
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));
This example produces the same output as the following HTML:
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()")}}