Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Gestione degli errori e delle eccezioni

La gestione degli errori consente di reagire alle eccezioni senza confonderle con il normale risultato di una funzione. Scopri throw, try, catch e finally e distingui le eccezioni sincrone dai rifiuti di Promise.

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

Sintassi

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

Un’eccezione interrompe il percorso di esecuzione corrente. throw può generare qualsiasi valore, ma usa oggetti Error o i loro sottotipi: hanno le proprietà name e message. TypeError descrive un tipo inappropriato o un’operazione non valida, mentre RangeError descrive un valore fuori dall’intervallo consentito. new Error(message) crea soltanto un oggetto, senza generare un’eccezione.

try racchiude le operazioni che possono generare un’eccezione; catch (error) riceve il valore generato, anche se proviene da una funzione chiamata in modo sincrono. L’esecuzione non riprende dall’istruzione interrotta. Gestisci solo gli errori a cui puoi rispondere in modo utile; genera nuovamente gli altri con throw error. Un errore di sintassi che impedisce di analizzare lo stesso script non può essere intercettato dal suo catch.

finally viene eseguito quando il controllo esce da try o catch, anche tramite return o un’eccezione. Usalo per le operazioni di pulizia. Evita di inserirvi return e throw, perché possono sostituire un risultato o un’eccezione precedenti. Un’istruzione try richiede catch, finally o entrambi.

Un try sincrono non intercetta un successivo rifiuto di Promise solo perché la promessa è stata creata nel suo blocco. Usa await in un try all’interno di una funzione async, oppure aggiungi .catch(handler). L’esempio usa i meccanismi di base delle eccezioni disponibili da ECMAScript 3; Promise risale a ECMAScript 2015 e async/await a ECMAScript 2017. Non servono Web API, a parte console.log fornito dall’ambiente; la sola versione di Node.js non dimostra la compatibilità con i browser.

Esempi

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");
}

Risultato

RangeError: value must be positive
finished

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti