requireUrl

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

Une URL en http, https ou ftp, avec quelque chose après le schéma et aucun espace nulle part. Un hôte seul comme "example.com" n'en est pas une.

isX et nonX répondent à une question sans jamais interrompre le flot ; requireX et requireNonX rendent la valeur ou lèvent. Le schéma est expliqué dans Conventions de validation.

Paramètres

Paramètre	Type	Description
`value`	`unknown`	La valeur à valider.
`message` (facultatif) `= "Expected a valid URL."`	`string`	Le message de l'exception. À défaut, un message par défaut est utilisé.

Valeur de retour

string — la même valeur, typée comme une URL.

Exceptions

Exception	Condition
`IllegalArgumentException`	la valeur n'est pas une URL.

Exemples

Ce qui passe et ce qui ne passe pas

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

Voir aussi

Code source

src/net/url/requireUrl.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.