Skip to content

9. Erros e exceções

Image

O JavaScript não possui um sistema de tratamento de exceções muito sofisticado. No entanto, disponibiliza a instrução [throw], que permite sinalizar um erro, bem como a estrutura try/catch/finally, que permite capturar esses erros.

9.1. script [excep-01]

No script a seguir, vamos exibir a data atual no formato [horas:minutos:segundos:milissegundos]. Para isso, vamos usar uma biblioteca JavaScript chamada [moment.js]. Instalamo-la, como de costume, usando a ferramenta [npm]:

Image

O código do script é o seguinte:


'use strict';
 
// package moment
import moment from 'moment';
 
...

Para compreender como escrever a linha [import] na linha 4, podemos consultar a definição do módulo [moment]:

Image

  • em [1-2], vamos para a definição do módulo;
  • em [3], temos um ficheiro TypeScript, não um ficheiro JavaScript. Em tempo de execução, este ficheiro TypeScript é compilado num ficheiro JavaScript antes de ser utilizado;
  • em [4], procuramos as instruções [export] (Ctrl-F);
  • em [5], a instrução exporta o objeto [moment]. Este pode ser importado em ES6 da seguinte forma: 

import moment from 'moment';

Pode utilizar qualquer nome para importar o objeto [moment], por exemplo:


import m from 'moment';

Voltemos ao código do script:


'use strict';
 
// package moment
import moment from 'moment';
 
// try / catch / finally principle
for (let i = 0; i < 10; i++) {
  // date - current time
  const now = Date.now();
  // format time to get milliseconds
  const time = moment(now).format("HH:mm:ss:SSS");
  // milliseconds
  const milli = Number(time.substr(time.length - 3));
  // display
  console.log("--------------------itération n° ", i, "à", time);
  try {
    // number varies according to time of day
    const nbre = milli % 2;
    if (nbre === 0) {
      // launch an error msg
      throw "erreur";
    }
    // if we've arrived here, there's been no mistake
    console.log("pas d'erreur");
  } catch (error) {
    // if we get here, it's because there's been a mistake
    console.log("erreur1=", error);
  } finally {
    // executed in all cases error or not
    console.log("finally")
  }
}

Comentários

  • linha 4: importar a biblioteca [moment];
  • O script executa um ciclo de 10 vezes (linha 7). Em cada iteração do ciclo, a hora atual é obtida no formato [horas:minutos:segundos:milissegundos] (linhas 8–13);
  • se o número de milissegundos for par, é exibida uma mensagem de erro (linhas 19–22);
  • O objetivo aqui é compreender como funciona o try / catch / finally

Execução


[Running] C:\myprograms\laragon-lite\bin\nodejs\node-v10\node.exe -r esm "c:\Data\st-2019\dev\es6\javascript\exceptions\excep-01.js"
--------------------itération n° 0 à 17:57:04:440
erreur1= erreur
finally
--------------------itération n° 1 à 17:57:04:447
pas d'erreur
finally
--------------------itération n° 2 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 3 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 4 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 5 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 6 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 7 à 17:57:04:448
erreur1= erreur
finally
--------------------itération n° 8 à 17:57:04:449
pas d'erreur
finally
--------------------itération n° 9 à 17:57:04:449
pas d'erreur
finally

Podemos ver que a cláusula [finally] é sempre executada, quer haja um erro ou não.

9.2. script [excep-02]

Este script demonstra que a instrução [throw] pode lançar qualquer tipo de dados e que esses dados são totalmente capturados pela cláusula [catch].


'use strict';
 
// you can "throw" just about anything to signal an error
let i = 0;
console.log("--------------------essai n° ", i);
// launch a string
try {
  throw "msg d'erreur";
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// launch a table
i++;
console.log("--------------------essai n° ", i);
try {
  throw [1, 2, 3]
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// launch a literal object
i++;
console.log("--------------------essai n° ", i);
try {
  throw { nom: "hercule", pays: "grèce antique" }
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lancer un type Error
i++;
console.log("--------------------essai n° ", i);
try {
  throw new Error("erreur de connexion au réseau");
} catch (error) {
  // there has been a mistake
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lancer un type Error
i++;
console.log("--------------------essai n° ", i);
try {
  throw new Error("erreur de connexion au réseau");
} catch (error) {
  // there has been an error - the message is in [error.message]
  console.log("erreur.message=[", error.message, "], type(error)=", typeof (error));
}

Comentários

  • linhas 35, 44: [Error] é uma classe JavaScript cujo construtor aceita uma mensagem de erro como primeiro parâmetro opcional. Esta mensagem pode ser recuperada a partir da propriedade [Error.message] (linha 47);
  • Existem outras classes além de [Error] que podem sinalizar um erro: [EvalError, InternalError, RangeError, ReferenceError, SyntaxError, TypeError, URIError);

Execução


[Running] C:\myprograms\laragon-lite\bin\nodejs\node-v10\node.exe -r esm "c:\Data\st-2019\dev\es6\javascript\exceptions\excep-02.js"
--------------------essai n° 0
erreur=[ msg d'erreur ], type= string
--------------------essai n° 1
erreur=[ [ 1, 2, 3 ] ], type= object
--------------------essai n° 2
erreur=[ { nom: 'hercule', pays: 'grèce antique' } ], type= object
--------------------essai n° 3
erreur=[ Error: erreur de connexion au réseau
at Object.<anonymous> (c:\Data\st-2019\dev\es6\javascript\exceptions\excep-02.js:35:9)
at Object.<anonymous> (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:251206)
at c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:245054
at Generator.next (<anonymous>)
at bl (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:245412)
at kl (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:247659)
at Object.u (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:287740)
at Object.o (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:287137)
at Object.<anonymous> (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:284879)
at Object.apply (c:\Temp\19-09-01\javascript\node_modules\esm\esm.js:1:199341) ], type= object
--------------------essai n° 4
erreur.message=[ erreur de connexion au réseau ], type(error)= object

9.3. script [excep-03]

Este script demonstra que, dentro de um [catch], é possível distinguir o tipo da instância [Error] interceptada pelo [catch]:


'use strict';
 
// package moment
import moment from 'moment';
 
// differentiate the Error instance received in a [catch]
for (let i = 0; i < 10; i++) {
  // date - current time
  const now = Date.now();
  // format time to get milliseconds
  const time = moment(now).format("HH:mm:ss:SSS");
  // milliseconds
  const milli = Number(time.substr(time.length - 3));
  console.log("--------------------itération n° ", i);
  try {
    // nbre [0, 1, 2]
    const nbre = milli % 3;
    switch (nbre) {
      case 0:
        throw new ReferenceError("erreur 1");
      case 1:
        throw new RangeError("erreur 2");
      default:
        throw new EvalError("erreur 3");
    }
  } catch (error) {
    // there has been a mistake
    if (error instanceof ReferenceError) {
      console.log("ReferenceError :", error.message);
    } else {
      if (error instanceof RangeError) {
        console.log("RangeError :", error.message);
      }
      else {
        if (error instanceof EvalError) {
          console.log("EvalError :", error.message);
        }
      }
    }
  }
}

Execução


[Running] C:\myprograms\laragon-lite\bin\nodejs\node-v10\node.exe -r esm "c:\Data\st-2019\dev\es6\javascript\exceptions\excep-03.js"
--------------------itération n° 0
ReferenceError : erreur 1
--------------------itération n° 1
RangeError : erreur 2
--------------------itération n° 2
RangeError : erreur 2
--------------------itération n° 3
RangeError : erreur 2
--------------------itération n° 4
RangeError : erreur 2
--------------------itération n° 5
RangeError : erreur 2
--------------------itération n° 6
EvalError : erreur 3
--------------------itération n° 7
EvalError : erreur 3
--------------------itération n° 8
EvalError : erreur 3
--------------------itération n° 9
EvalError : erreur 3
https://stahe.github.io
Este curso-tutorial escrito por Serge Tahé é disponibilizado ao público de acordo com os termos da Licença Creative Commons Atribuição – Sem uso comercial – Partilha nas mesmas condições 3.0 não adaptada.