UNB/ CS/ David Bremner/ teaching/ cs2613/ books/ mdn/ Reference/ Global Objects/ String/ String.prototype.anchor()

The anchor() method of String values creates a string that embeds this string in an 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 element to have a name attribute, so this method doesn't even create valid markup.

Syntax

anchor(name)

Parameters

Return value

A string beginning with an <a name="name"> start tag (double quotes in name are replaced with &quot;), 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 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

Browser compatibility

See also