Skip to content

9. Erros e exceções

Image

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

9.1. script [excep-01]

No script que se segue, vamos apresentar a data atual no formato [heures:minutes:secondes:millisecondes]. Para tal, vamos utilizar uma biblioteca jS denominada [moment.js]. Instalamo-la, como habitualmente, com a ferramenta [npm]:

Image

O código do script é o seguinte:


'use strict';

// pacote moment
import moment from 'moment';

...

Para saber como escrever a linha [import] da linha 4, pode-se consultar a definição do módulo [moment]:

Image

  • em [1-2], acedemos à definição do módulo;
  • em [3], temos um ficheiro Typescript, não um ficheiro Javascript. Durante a 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 para ES6 da seguinte forma: 

import moment from 'moment';

É possível utilizar qualquer nome para importar o objeto [moment], por exemplo:


import m from 'moment';

Voltemos ao código do script:


'use strict';

// pacote moment
import moment from 'moment';

// princípio do try / catch / finally
for (let i = 0; i < 10; i++) {
  // data e hora do momento atual
  const now = Date.now();
  // formatação da hora para obter os milissegundos
  const time = moment(now).format("HH:mm:ss:SSS");
  // os milissegundos
  const milli = Number(time.substr(time.length - 3));
  // exibição
  console.log("--------------------itération n° ", i, "à", time);
  try {
    // número que varia consoante a hora atual
    const nbre = milli % 2;
    if (nbre === 0) {
      // enviar uma mensagem de erro
      throw "erreur";
    }
    // se chegarmos aqui, significa que não houve erro
    console.log("pas d'erreur");
  } catch (error) {
    // se chegarmos aqui, é porque ocorreu um erro
    console.log("erreur1=", error);
  } finally {
    // executado em todos os casos, haja ou não erro
    console.log("finally")
  }
}

Comentários

  • linha 4: importação da biblioteca [moment];
  • o princípio do script consiste em executar um ciclo 10 vezes (linha 7). Em cada iteração do ciclo, obtém-se a hora atual no formato [heures:minutes:secondes:millisecondes] (linhas 8-13);
  • se o número de milissegundos for par, é exibida uma mensagem de erro (linhas 19-22);
  • o objetivo aqui é compreender o funcionamento do 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

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

9.2. script [excep-02]

Este script, que a instrução [throw] pode lançar com qualquer tipo de dados, é recuperado na íntegra pela cláusula [catch].


'use strict';

// é possível «lançar» (throw) praticamente qualquer coisa para sinalizar um erro
let i = 0;
console.log("--------------------essai n° ", i);
// lançar uma cadeia de caracteres
try {
  throw "msg d'erreur";
} catch (error) {
  // ocorreu um erro
  console.log("erreur=[", error, "], type=", typeof (error));
}
// gerar uma tabela
i++;
console.log("--------------------essai n° ", i);
try {
  throw [1, 2, 3]
} catch (error) {
  // ocorreu um erro
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lançar um objeto literal
i++;
console.log("--------------------essai n° ", i);
try {
  throw { nom: "hercule", pays: "grèce antique" }
} catch (error) {
  // ocorreu um erro
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lançar um tipo Error
i++;
console.log("--------------------essai n° ", i);
try {
  throw new Error("erreur de connexion au réseau");
} catch (error) {
  // ocorreu um erro
  console.log("erreur=[", error, "], type=", typeof (error));
}
// lançar um tipo Error
i++;
console.log("--------------------essai n° ", i);
try {
  throw new Error("erreur de connexion au réseau");
} catch (error) {
  // ocorreu um erro - a mensagem encontra-se em [error.message]
  console.log("erreur.message=[", error.message, "], type(error)=", typeof (error));
}

Comentários

  • linhas 35, 44: [Error] é uma classe JavaScript cujo construtor aceita, como primeiro parâmetro opcional, uma mensagem de erro. Esta mensagem pode ser recuperada na propriedade [Error.message] (linha 47);
  • existem outras classes além de [Error] para 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, num [catch], é possível distinguir o tipo de instância [Error] interceptada pelo [catch]:


'use strict';

// pacote moment
import moment from 'moment';

// diferenciar a instância de Error recebida em um [catch]
for (let i = 0; i < 10; i++) {
  // data e hora do momento atual
  const now = Date.now();
  // formatação da hora para obter os milissegundos
  const time = moment(now).format("HH:mm:ss:SSS");
  // os milissegundos
  const milli = Number(time.substr(time.length - 3));
  console.log("--------------------itération n° ", i);
  try {
    // número [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) {
    // ocorreu um erro
    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.