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

CKTIS / Java

A instrução assert

A instrução assert: A instrução assert verifica uma suposição interna e lança AssertionError quando falha, opcionalmente com o valor da expressão após os dois pontos.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

assert

A instrução assert verifica uma suposição interna e lança AssertionError quando falha, opcionalmente com o valor da expressão após os dois pontos.

Usa assert para invariantes que código correto deve sempre cumprir durante testes executados com -ea.

As asserções estão desativadas por omissão; nunca as uses para validar argumentos de API pública nem coloques nelas efeitos laterais necessários.

A expressão da mensagem só é avaliada se a condição for falsa e as asserções estiverem ativas; o estado configura-se por classe, package ou class loader.

Main tem asserções desativadas como main-enabled=false, mas Checked está ativa e o assert dá caught=negative:-1.

Exemplos

public class Main {
  static class Checked { static void verify(int n){ assert n>=0:"negative:"+n; } }
  public static void main(String[] args) throws Exception {
    if(args.length==0){
      System.out.println("main-enabled="+Main.class.desiredAssertionStatus());
      String java=ProcessHandle.current().info().command().orElseThrow();
      var child=new ProcessBuilder(java,"-ea","-cp",System.getProperty("java.class.path"),"Main","child").inheritIO().start();
      if(child.waitFor()!=0) throw new IllegalStateException("child failed");
    } else {
      try { Checked.verify(-1); } catch(AssertionError ex) { System.out.println("caught="+ex.getMessage()); }
    }
  }
}

Resultado

main-enabled=false
caught=negative:-1

Main tem asserções desativadas como main-enabled=false, mas Checked está ativa e o assert dá caught=negative:-1.

Fontes