Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

TypeError — un errore per operazione non valida

TypeError è un tipo di errore integrato in JavaScript e spesso indica un’operazione incompatibile con il tipo di un valore. Puoi intercettarlo o generarlo esplicitamente quando convalidi gli argomenti di una funzione.

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

new TypeError(message)
TypeError(message)
throw new TypeError(message)

TypeError è un costruttore integrato per gli errori che ereditano da Error, non un’interfaccia della Web API. In genere segnala un’operazione non supportata da un valore, come chiamare un valore che non è una funzione. La specifica lo usa anche quando nessun altro tipo di errore integrato descrive adeguatamente il problema.

Se l’operazione va a buon fine, sia new TypeError(message) sia la chiamata a TypeError(message) senza new restituiscono un nuovo oggetto di errore senza lanciarlo come eccezione. Usa throw per lanciare esplicitamente l’oggetto ottenuto. L’argomento message è facoltativo, ma la sua conversione in una stringa può generare un’eccezione prima che venga restituito un oggetto di errore. Ad esempio, new TypeError(Symbol()) genera un TypeError senza un’istruzione throw esplicita.

Le tue funzioni possono generare TypeError quando un argomento non soddisfa un requisito di tipo. Per un valore del tipo corretto ma al di fuori dell’intervallo consentito, di solito è più appropriato RangeError. Nell’esempio, catch intercetta l’errore previsto e genera di nuovo gli altri errori.

Non basare la logica sul testo esatto dei messaggi generati dal motore: la loro formulazione non è standardizzata. L’esempio fornisce un messaggio personalizzato, quindi l’output previsto è stabile. Un controllo instanceof TypeError è adatto nello stesso ambiente di esecuzione, ma può non riuscire con errori provenienti da un altro ambiente, ad esempio un iframe separato.

Esempi

function shout(value) {
  if (typeof value !== "string") {
    throw new TypeError("Expected a string");
  }
  return value.toUpperCase();
}

try {
  shout(42);
} catch (error) {
  if (!(error instanceof TypeError)) {
    throw error;
  }
  console.log(error.name + ": " + error.message);
}

Risultato

TypeError: Expected a string

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