requireUrl

function requireUrl(value: unknown, message: string = "Expected a valid URL."): string;

Eine http-, https - oder ftp-URL, bei der nach dem Schema etwas folgt und nirgends Leerraum steht. Ein blanker Host wie "example.com" ist keine.

isX und nonX beantworten eine Frage und unterbrechen den Ablauf nie; requireX und requireNonX geben den Wert zurück oder werfen. Das Schema erklärt Konventionen der Prüfungen.

Parameter

Parameter	Typ	Beschreibung
`value`	`unknown`	Der zu validierende Wert.
`message` (optional) `= "Expected a valid URL."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

string — denselben Wert, typisiert als eine URL.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	der Wert ist nicht eine URL.

Beispiele

Was besteht und was nicht

requireUrl("https://example.com"); // => "https://example.com"
requireUrl("http://example.com/a?b=1"); // => "http://example.com/a?b=1"
requireUrl("example.com"); // throws IllegalArgumentException
requireUrl("https://"); // throws IllegalArgumentException

Siehe auch

Quellcode

src/net/url/requireUrl.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.