URL: username property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Note: This feature is available in Web Workers.

The username property of the URL interface is a string containing the username component of the URL. 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.

Value

A string.

Examples

js
const url = new url(/Education?url=https%3A%2F%2Fdeveloper.mozilla.org%2Fen-US%2Fdocs%2FWeb%2FAPI%2FURL%2F%2522https%3A%2F%2Fanonymous%3Aflabada%40developer.mozilla.org%2Fen-US%2Fdocs%2FWeb%2FAPI%2FURL%2Fusername%2522%2C);
console.log(url.username); // Logs "anonymous"

Specifications

Specification
URL
# dom-url-username

Browser compatibility

See also

  • The URL interface it belongs to.