Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

debugger — instrução de depuração

A instrução `debugger;` assinala um ponto em que um depurador ativo pode suspender a execução do programa. Se não existir um depurador ou se este não estiver ativo, não produz qualquer efeito observável.

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

Sintaxe

debugger;

debugger; é uma instrução JavaScript, não uma chamada de função nem uma API Web. Não recebe argumentos. debugger é uma palavra reservada: não pode ser usada como nome de variável ou de função.

Quando existe uma funcionalidade de depuração disponível e ativa, a instrução desencadeia uma ação definida pela implementação, que pode suspender a execução nesse ponto. O ECMAScript não especifica a interface do depurador nem garante uma suspensão. Se não existir um depurador ou se este não estiver ativo, a instrução não produz qualquer efeito observável.

No exemplo, total tem o valor 60 antes de a execução chegar a debugger;. Se a execução for suspensa, podes verificar esse valor e depois retomá-la sem alterar o estado do programa. Em seguida, console.log(total) apresenta 60. A própria instrução debugger; não apresenta nada.

Remove as instruções debugger; não intencionais antes de publicar código, pois podem interromper alguém que esteja a usar um depurador ativo. Não as uses como forma de parar a execução na lógica normal de uma aplicação.

Exemplos

const price = 20;
const quantity = 3;
const total = price * quantity;
debugger;
console.log(total);

Resultado

60

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes