URL: host-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 host-Eigenschaft der URL-Schnittstelle ist ein String, der den Host enthält. Dieser besteht aus dem hostname und, falls der port der URL nicht leer ist, aus einem ":", gefolgt vom port der URL. Hat die URL keinen hostname, enthält diese Eigenschaft einen leeren String, "".

Diese Eigenschaft kann gesetzt werden, um sowohl den Hostnamen als auch den Port der URL zu ändern. Wenn das Schema der URL nicht hierarchisch ist (was im URL-Standard als "special schemes" bezeichnet wird), hat es kein Konzept eines Hostes, und das Setzen dieser Eigenschaft hat keine Wirkung.

Hinweis: Wenn der angegebene Wert für den host-Setter keinen port enthält, wird der port der URL nicht geändert. Das kann unerwartet sein, da der host-Getter einen String im URL-Port-Format zurückgibt und man somit annehmen könnte, dass der Setter immer sowohl den Host als auch den Port "zurücksetzt".

Wert

Ein String.

Beispiele

js
let url = new URL("https://developer.mozilla.org/en-US/docs/Web/API/URL/host");
console.log(url.host); // "developer.mozilla.org"

url = new URL("https://developer.mozilla.org:443/en-US/docs/Web/API/URL/host");
console.log(url.host); // "developer.mozilla.org"
// The port number is not included because 443 is the scheme's default port

url = new URL("https://developer.mozilla.org:4097/en-US/docs/Web/API/URL/host");
console.log(url.host); // "developer.mozilla.org:4097"

Spezifikationen

Specification
URL
# dom-url-host

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

  • Die URL-Schnittstelle, zu der diese Eigenschaft gehört.