JavaScript tente... pegue... finalmente
Exemplo
Este exemplo tem um erro de digitação no bloco try . O alerta está incorreto.
O bloco catch captura o erro e executa o código para tratá-lo:
<p id="demo"></p>
<script>
try {
adddlert("Welcome guest!");
}
catch(err) {
document.getElementById("demo").innerHTML = err.message;
}
</script>
Mais exemplos abaixo.
Definição e uso
Quando ocorre um erro , o JavaScript para e gera uma mensagem de erro.
Observação
O termo técnico para isso é: JavaScript lança uma exceção .
JavaScript cria um objeto Error com duas propriedades: name e message .
A try...catch...finally
combinação de instruções trata de erros sem interromper o JavaScript.
A try
instrução define o bloco de código a ser executado (para tentar).
A catch
instrução define um bloco de código para lidar com qualquer erro.
A finally
instrução define um bloco de código para ser executado independentemente do resultado.
A throw
instrução define um erro personalizado.
Ambos catch
e finally
são opcionais, mas você deve usar um deles.
Observação
O uso de throw com try e catch permite controlar o fluxo do programa e gerar mensagens de erro personalizadas.
Veja também:
Sintaxe
try {
tryCode - Code block to run
}
catch(err) {
catchCode -
Code block to handle errors
}
finally {
finallyCode - Code block to be executed regardless of the try result
}
Parâmetros
Parameter | Description |
tryCode | Required. Code block to be tested while executing. |
err | A local reference to the error object. |
catchCode | Optional. Code block to execute if an error occurs. |
finallyCode | Optional. Code block to execute regardless of the try result |
Mais exemplos
Este exemplo examina a entrada.
Se o valor estiver errado, uma exceção (err) é lançada:
<p>Please input a number between
5 and 10:</p>
<input id="demo" type="text">
<button type="button"
onclick="myFunction()">Test Input</button>
<p id="message"></p>
<script>
function myFunction() {
const message =
document.getElementById("message");
message.innerHTML = "";
let x =
document.getElementById("demo").value;
try {
if(x == "") throw "is Empty";
if(isNaN(x)) throw "not a number";
if(x > 10) throw "too high";
if(x < 5) throw "too low";
}
catch(err) {
message.innerHTML =
"Input " + err;
}
}
</script>
A instrução finally executa o código depois, independentemente do resultado do try:
function myFunction()
const message =
document.getElementById("message");
message.innerHTML = "";
let x =
document.getElementById("demo").value;
try {
if(x == "") throw "Empty";
if(isNaN(x))
throw "Not a number";
if(x >
10) throw "Too high";
if(x <
5) throw "Too low";
}
catch(err)
{
message.innerHTML = "Error: " +
err + ".";
}
finally {
document.getElementById("demo").value = "";
}
}
Suporte ao navegador
try...catch
é um recurso ECMAScript3 (ES3).
ES3 (JavaScript 1999) é totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | Yes | Yes | Yes | Yes | Yes |