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

BCD tables only load in the browser

Siehe auch

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