Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

L’instruction assert

L’instruction assert: L’instruction assert vérifie une hypothèse interne et lève AssertionError en cas d’échec, avec éventuellement la valeur de l’expression après les deux-points.

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

Syntaxe

assert

L’instruction assert vérifie une hypothèse interne et lève AssertionError en cas d’échec, avec éventuellement la valeur de l’expression après les deux-points.

Utilise assert pour les invariants que le code correct doit toujours respecter pendant des tests lancés avec -ea.

Les assertions sont désactivées par défaut ; ne les emploie jamais pour valider une API publique ni pour porter des effets de bord nécessaires.

L’expression du message n’est évaluée que si la condition est fausse et les assertions actives ; le statut se règle par classe, paquet ou class loader.

Main a les assertions désactivées avec main-enabled=false, mais Checked est activée et son assert donne caught=negative:-1.

Exemples

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()); }
    }
  }
}

Résultat

main-enabled=false
caught=negative:-1

Main a les assertions désactivées avec main-enabled=false, mais Checked est activée et son assert donne caught=negative:-1.

Sources