Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Gestion des erreurs et des exceptions

La gestion des erreurs permet de réagir aux exceptions sans les confondre avec le résultat normal d’une fonction. Découvrez throw, try, catch et finally, et distinguez les exceptions synchrones des rejets de Promise.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

throw new Error(message);
try {
  operation();
} catch (error) {
  handle(error);
} finally {
  cleanup();
}

Une exception interrompt le chemin d’exécution en cours. throw peut lever n’importe quelle valeur, mais utilisez des objets Error ou leurs sous-types : ils possèdent les propriétés name et message. TypeError décrit un type inapproprié ou une opération invalide, tandis que RangeError décrit une valeur hors de la plage autorisée. new Error(message) crée simplement un objet, sans lever d’exception.

try encadre les opérations susceptibles de lever une exception ; catch (error) reçoit la valeur levée, y compris si elle provient d’une fonction appelée de manière synchrone. L’exécution ne reprend pas à l’instruction interrompue. Ne traitez que les erreurs auxquelles vous pouvez apporter une réponse utile ; relancez les autres avec throw error. Une erreur de syntaxe qui empêche l’analyse du même script ne peut pas être interceptée par son catch.

finally s’exécute lorsque le contrôle quitte try ou catch, y compris par return ou à cause d’une exception. Utilisez-le pour le nettoyage. Évitez d’y placer return et throw, car ils peuvent remplacer un résultat ou une exception antérieurs. Une instruction try nécessite catch, finally ou les deux.

Un try synchrone n’intercepte pas un rejet ultérieur de Promise simplement parce que la promesse a été créée dans son bloc. Utilisez await dans un try au sein d’une fonction async, ou ajoutez .catch(handler). L’exemple utilise les mécanismes d’exception de base disponibles depuis ECMAScript 3 ; Promise date d’ECMAScript 2015 et async/await d’ECMAScript 2017. Aucune Web API n’est nécessaire, hormis console.log fourni par l’environnement ; une version de Node.js ne suffit pas à établir la compatibilité avec les navigateurs.

Exemples

function requirePositive(value) {
  if (!(value > 0)) {
    throw new RangeError("value must be positive");
  }
  return value;
}

try {
  console.log(requirePositive(-1));
} catch (error) {
  if (!(error instanceof RangeError)) {
    throw error;
  }
  console.log(error.name + ": " + error.message);
} finally {
  console.log("finished");
}

Résultat

RangeError: value must be positive
finished

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources