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

CKTIS / JavaScript

console.assert — verificações de condições para diagnóstico

console.assert comunica uma condição não satisfeita na consola, sem interromper a execução nem substituir a validação.

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

console.assert(condition, ...data)

console.assert(condition, ...data) pertence ao Console Standard, não a uma edição específica do ECMAScript. A condição é convertida num valor booleano: se for truthy, não é apresentada qualquer mensagem; se for falsy, é comunicado um erro. Se a condição for omitida, o valor predefinido é false.

Os data opcionais fornecem uma mensagem ou valores adicionais. Se o primeiro valor de data for uma cadeia de caracteres, o método acrescenta-lhe um prefixo de erro. Se o primeiro valor não for uma cadeia de caracteres, o método insere uma mensagem de erro separada antes desse valor e deixa inalteradas as cadeias de caracteres seguintes. Sem dados, é produzida uma mensagem predefinida. A formulação exata e a apresentação dependem da implementação.

O método devolve undefined; o erro, por si só, não lança uma exceção. Utilize-o para diagnóstico, não para impor validação. O exemplo comunica deliberadamente um erro e, em seguida, a execução prossegue.

Exemplos

const quantity = 0;
console.assert(quantity === 0, "Expected zero");
console.assert(quantity > 0, "Expected positive quantity");
console.log("Continued");

Resultado

Assertion failed: Expected positive quantity
Continued

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