URL: URL() Konstruktor
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Der URL()
Konstruktor gibt ein neu erstelltes URL
Objekt zurück, das die durch die Parameter definierte URL darstellt.
Falls die angegebene Basis-URL oder die resultierende URL keine gültigen URLs sind, wird die JavaScript-Ausnahme TypeError
ausgelöst.
Syntax
new URL(url)
new URL(url, base)
Parameter
url
-
Ein String oder ein anderes Objekt mit einem stringifier, das eine absolute URL oder eine relative Referenz zu einer Basis-URL darstellt. Wenn
url
eine relative Referenz ist, istbase
erforderlich und wird verwendet, um die endgültige URL zu lösen. Wennurl
eine absolute URL ist, wird eine angegebenebase
nicht zur Erstellung der resultierenden URL verwendet. base
Optional-
Ein String, der die Basis-URL darstellt, die in Fällen verwendet wird, in denen
url
eine relative Referenz ist. Falls nicht angegeben, ist der Standardwertundefined
.Wenn eine
base
angegeben wird, ist die aufgelöste URL nicht einfach eine Verkettung vonurl
undbase
. Relative Referenzen zum übergeordneten und aktuellen Verzeichnis werden relativ zum aktuellen Verzeichnis derbase
URL aufgelöst und beinhalten Pfadsegmente bis zum letzten Schrägstrich, aber keine danach. Relative Referenzen zur Wurzel werden relativ zum Basis-Ursprung aufgelöst. Weitere Informationen finden Sie unter Auflösen relativer Referenzen zu einer URL.
Hinweis:
Die Argumente url
und base
werden jeder für sich zu einem String umgewandelt, unabhängig von dem Wert, den Sie übergeben, wie etwa ein HTMLAnchorElement
oder HTMLAreaElement
Element, genau wie bei anderen Web-APIs, die einen String akzeptieren.
Insbesondere können Sie ein existierendes URL
Objekt für beide Argumente verwenden, und es wird aus der href
Eigenschaft des Objekts in einen String umgewandelt.
Ausnahmen
TypeError
-
url
(im Fall von absoluten URLs) oderbase
+url
(im Fall von relativen Referenzen) ist keine gültige URL.
Beispiele
Hier sind einige Beispiele für die Verwendung des Konstruktors.
Hinweis:>Auflösen relativer Referenzen zu einer URL bietet zusätzliche Beispiele, die demonstrieren, wie verschiedene url
und base
Werte zu einer endgültigen absoluten URL aufgelöst werden.
// Base URLs:
let baseUrl = "https://developer.mozilla.org";
let A = new URL("/", baseUrl);
// => 'https://developer.mozilla.org/'
let B = new URL(baseUrl);
// => 'https://developer.mozilla.org/'
new URL("en-US/docs", B);
// => 'https://developer.mozilla.org/en-US/docs'
let D = new URL("/en-US/docs", B);
// => 'https://developer.mozilla.org/en-US/docs'
new URL("/en-US/docs", D);
// => 'https://developer.mozilla.org/en-US/docs'
new URL("/en-US/docs", A);
// => 'https://developer.mozilla.org/en-US/docs'
new URL("/en-US/docs", "https://developer.mozilla.org/fr-FR/toto");
// => 'https://developer.mozilla.org/en-US/docs'
Hier sind einige Beispiele für ungültige URLs:
new URL("/en-US/docs", "");
// Raises a TypeError exception as '' is not a valid URL
new URL("/en-US/docs");
// Raises a TypeError exception as '/en-US/docs' is not a valid URL
// Other cases:
new URL("http://www.example.com");
// => 'http://www.example.com/'
new URL("http://www.example.com", B);
// => 'http://www.example.com/'
new URL("", "https://example.com/?query=1");
// => 'https://example.com/?query=1' (Edge before 79 removes query arguments)
new URL("/a", "https://example.com/?query=1");
// => 'https://example.com/a' (see relative URLs)
new URL("//foo.com", "https://example.com");
// => 'https://foo.com/' (see relative URLs)
Spezifikationen
Specification |
---|
URL # dom-url-url |
Browser-Kompatibilität
Siehe auch
URL.parse()
, eine nicht-auslösende Alternative zu diesem Konstruktor- Polyfill von
URL
incore-js
- Das Interface, zu dem es gehört:
URL
.