HTMLAreaElement: username property

The username property of the HTMLAreaElement interface is a string containing the username component of the <area> element's href. If the URL does not have a username, this property contains an empty string, "".

This property can be set to change the username of the URL. If the URL has no host or its scheme is file:, then setting this property has no effect.

The username is percent-encoded when setting but not percent-decoded when reading.

See URL.username for more information.

Value

A string.

Examples

Getting the username from an area link

// An <area id="myArea" href="https://anonymous:flabada@developer.mozilla.org/en-US/docs/HTMLAreaElement"> element is in the document
const area = document.getElementByID("myArea");
area.username; // returns 'anonymous'

Specifications

Browser compatibility

See also

• The HTMLAreaElement interface it belongs to.