requireValidVersion

function requireValidVersion(
  value: string | null | undefined,
  message: string = "Expected a valid version."
): string;

Durch Punkte getrennte Zifferngruppen, beliebig viele. Ein Vorabversions-Suffix, ein führendes v und eine leere Gruppe werden abgelehnt: "1.2.3-beta" besteht also nicht, obwohl SemVer es erlaubt.

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`	`string \\| null \\| undefined`	Der zu validierende Wert.
`message` (optional) `= "Expected a valid version."`	`string`	Die Meldung der Ausnahme. Ohne Angabe wird eine Standardmeldung verwendet.

Rückgabewert

string — denselben Wert, typisiert als eine Versionsangabe.

Ausnahmen

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

Beispiele

Was besteht und was nicht

requireValidVersion("1"); // => "1"
requireValidVersion("1.2.3"); // => "1.2.3"
requireValidVersion("1.2.3-beta"); // throws IllegalArgumentException
requireValidVersion("v1.2"); // throws IllegalArgumentException

Siehe auch

Quellcode

src/lang/string/requireValidVersion.ts

23 September 2026

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