URL: hostname-Eigenschaft

Baseline Widely available

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

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die hostname-Eigenschaft des URL-Interfaces ist ein String, der entweder den Domainnamen oder die IP-Adresse der URL enthält. Wenn die URL keinen Hostnamen hat, enthält diese Eigenschaft einen leeren String, "". IPv4- und IPv6-Adressen werden normalisiert, z. B. durch das Entfernen führender Nullen, und Domainnamen werden in IDN umgewandelt.

Diese Eigenschaft kann gesetzt werden, um den Hostnamen der URL zu ändern. Wenn das Schema der URL nicht hierarchisch ist (was der URL-Standard als "Spezialschemata" bezeichnet), hat sie kein Konzept eines Hosts, und das Setzen dieser Eigenschaft zeigt keine Wirkung.

Der Hostname wird beim Setzen prozent-codiert, aber beim Lesen nicht prozent-dekodiert.

Wert

Ein String.

Beispiele

js
const url = new URL(
  "https://developer.mozilla.org/en-US/docs/Web/API/URL/hostname",
);
console.log(url.hostname); // Logs: 'developer.mozilla.org'

url.hostname = "你好.com";
console.log(url.hostname); // Logs: 'xn--6qq79v.com'

Spezifikationen

Specification
URL
# dom-url-hostname

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
hostname

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch

  • Das URL-Interface, zu dem es gehört.