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

Der URL()-Konstruktor gibt ein neu erstelltes URL-Objekt zurück, das die URL darstellt, die durch die Parameter definiert ist.

Wenn 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, ist base erforderlich und wird verwendet, um die endgültige URL aufzulösen. Wenn url eine absolute URL ist, wird ein gegebenes base nicht verwendet, um die resultierende URL zu erstellen.

base Optional

Ein String, der die Basis-URL darstellt, die verwendet wird, wenn url eine relative Referenz ist. Wenn nicht angegeben, ist der Standardwert undefined.

Wenn ein base angegeben ist, ist die aufgelöste URL nicht einfach eine Verkettung von url und base. Relative Referenzen zum übergeordneten und aktuellen Verzeichnis werden relativ zum aktuellen Verzeichnis der base-URL aufgelöst, das Pfadsegmente bis zum letzten Schrägstrich enthält, 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 url- und base-Argumente werden jeweils aus dem Wert, den Sie übergeben, in einen String umgewandelt, wie z.B. ein HTMLAnchorElement oder HTMLAreaElement-Element, genau wie bei anderen Web-APIs, die einen String akzeptieren. Insbesondere können Sie ein bestehendes URL-Objekt für jedes Argument verwenden, und es wird aus der href-Eigenschaft des Objekts in einen String umgewandelt.

Ausnahmen

TypeError

url (im Fall von absoluten URLs) oder base + 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 zeigen, wie unterschiedliche 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.example", "https://example.com");
// => 'https://foo.example/' (see relative URLs)

Spezifikationen

Browser-Kompatibilität

Siehe auch

• URL.parse(), eine Alternative zu diesem Konstruktor, die keine Ausnahme auslöst
• Polyfill von URL in core-js
• Die Schnittstelle, zu der es gehört: URL.