pertyIsEnumerable() ` ](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/propertyIsEnumerable)
    8. [ ` Object.prototype.toLocaleString() ` ](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toLocaleString)
    9. [ ` Object.prototype.toString() ` ](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/toString)
    10. [ ` Object.prototype.valueOf() ` ](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/valueOf)

##  In this article

  * Syntax 
  * Examples 
  * Specifications 
  * Browser compatibility 
  * See also 

#  String.prototype.link()

**Deprecated:** This feature is no longer recommended. Though some browsers
might still support it, it may have already been removed from the relevant web
standards, may be in the process of being dropped, or may only be kept for
compatibility purposes. Avoid using it, and update existing code if possible;
see the  compatibility table  at the bottom of this page to guide your
decision. Be aware that this feature may cease to work at any time.

The **` link() ` ** method of [ ` String ` ](/en-
US/docs/Web/JavaScript/Reference/Global_Objects/String) values creates a
string that embeds this string in an [ ` <a> ` ](/en-
US/docs/Web/HTML/Element/a) element ( ` <a href="...">str</a> ` ), to be used
as a hypertext link to another URL.

**Note:** All [ HTML wrapper methods ](/en-
US/docs/Web/JavaScript/Reference/Global_Objects/String#html_wrapper_methods)
are deprecated and only standardized for compatibility purposes. Use [ DOM
APIs ](/en-US/docs/Web/API/Document_Object_Model) such as [ `
document.createElement() ` ](/en-US/docs/Web/API/Document/createElement)
instead.

##  Syntax

js

    
    
    link(url)
    

###  Parameters

` url `

    

Any string that specifies the ` href ` attribute of the ` <a> ` element; it
should be a valid URL (relative or absolute), with any ` & ` characters
escaped as ` &amp; ` .

###  Return value

A string beginning with an ` <a href="url"> ` start tag (double quotes in `
url ` are replaced with ` &quot; ` ), then the text ` str ` , and then an `
</a> ` end tag.

##  Examples

###  Using link()

The code below creates an HTML string and then replaces the document's body
with it:

js

    
    
    const contentString = "MDN Web Docs";
    
    document.body.innerHTML = contentString.link("https://developer.mozilla.org/");
    

This will create the following HTML:

html

    
    
    <a href="https://developer.mozilla.org/">MDN Web Docs</a>
    

Instead of using ` link() ` and creating HTML text directly, you should use
DOM APIs such as [ ` document.createElement() ` ](/en-
US/docs/Web/API/Document/createElement) . For example:

js

    
    
    const contentString = "MDN Web Docs";
    const elem = document.createElement("a");
    elem.href = "https://developer.mozilla.org/";
    elem.innerText = contentString;
    document.body.appendChild(elem);
    

##  Specifications

Specification  
---  
[ ECMAScript Language Specification  
#  sec-string.prototype.link  ](https://tc39.es/ecma262/multipage/additional-
ecmascript-features-for-web-browsers.html#sec-string.prototype.link)  
  
##  Browser compatibility

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

##  See also

  * [ Polyfill of ` String.prototype.link ` in ` core-js ` ](https://github.com/zloirock/core-js#ecmascript-string-and-regexp)
  * [ HTML wrapper methods ](/en-US/docs/Web/JavaScript/Reference/Global_Objects/String#html_wrapper_methods)
  * [ ` <a> ` ](/en-US/docs/Web/HTML/Element/a)

##  Help improve MDN

Was this page helpful to you?

Yes  No

[ Learn how to contribute
](https://github.com/mdn/content/blob/main/CONTRIBUTING.md "This will take you
to our contribution guidelines on GitHub.") .

This page was last modified on  Sep 15, 2023  by  [ MDN contributors ](/en-
US/docs/Web/JavaScript/Reference/Global_Objects/String/link/contributors.txt)
.

[ View this page on GitHub
](https://github.com/mdn/cont