Lorsque vous travaillez avec des URL dans votre application JavaScript, il est crucial de pouvoir les valider et de vous assurer qu'elles sont correctement formatées. C'est là que la fonction URL.canParse entre en jeu. Cette fonction JavaScript vous permet de vérifier si une URL est analysable et valide avant de l'utiliser.

La fonction URL.canParse est une méthode disponible sur l'objet URL en JavaScript. Elle permet de vérifier si une chaîne de caractères est une URL valide et peut être analysée correctement. Lorsque vous appelez URL.canParse, elle renvoie simplement un booléen qui indique si l'URL peut être analysée avec succès ou non.

Voici un exemple simple qui montre comment utiliser la fonction URL.canParse :

const url = "https://blog.shevarezo.fr";

if (URL.canParse(url)) {
  // L'URL est valide et analysable
} else {
  // L'URL est invalide ou non analysable
}

Dans cet exemple simple, l'URL fournie est vérifiée pour savoir si elle est analysable en appelant URL.canParse. Si l'URL est valide, nous pouvons effectuer les opérations nécessaires. Sinon, nous pouvons gérer l'erreur appropriée.

URL.canParse admet un second paramètre optionnel nommé base. Dans le cas où l'URL fournie est relative, il est obligatoire de spécifier une base afin de savoir si l'URL complète est valide ou non.

URL.canParse("/post/2023/06/21/le-fichier-humans-txt"); // false
URL.canParse("/post/2023/06/21/le-fichier-humans-txt", "https://blog.shevarezo.fr"); // true

La fonction URL.canParse est à ce jour compatible uniquement sur Mozilla Firefox 115+.

Pour vérifier que la fonction canParse existe dans l'objet URL :

if ("canParse" in URL) {
  // todo
}