String.prototype.anchor()
Deprecated
Avoid using this feature in new projects. HTML wrapper methods exist only for backwards compatibility. Use DOM APIs to create elements instead. This feature may be a candidate for removal from web standards or browsers.
Consider using the following features instead: DOM.
The anchor() method of String values creates a string that embeds this string in an <a> element with a name (<a name="...">str</a>).
Note:
All HTML wrapper methods are deprecated and only standardized for compatibility purposes. Use DOM APIs such as document.createElement() instead.
The HTML specification no longer allows the <a> element to have a name attribute, so this method doesn't even create valid markup.
Syntax
anchor(name)
Parameters
name-
A string representing a
namevalue to put into the generated<a name="...">start tag.
Return value
A string beginning with an <a name="name"> start tag (double quotes in name are replaced with "), then the text str, and then an </a> end tag.
Examples
Using anchor()
The code below creates an HTML string and then replaces the document's body with it:
const contentString = "Hello, world";
document.body.innerHTML = contentString.anchor("hello");
This will create the following HTML:
<a name="hello">Hello, world</a>
Warning:
This markup is invalid, because name is no longer a valid attribute of the <a> element.
Instead of using anchor() and creating HTML text directly, you should use DOM APIs such as document.createElement(). For example:
const contentString = "Hello, world";
const elem = document.createElement("a");
elem.innerText = contentString;
document.body.appendChild(elem);
Specifications
| Specification |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.anchor |