...
Eroare Kotlin · when, if și funcții

'when' expression must be exhaustive. Add the 'is Err' branch or an 'else' branch.

Pe scurt

Faci when pe o sealed class sau pe un enum și ai uitat unul dintre cazuri; compilatorul îți spune exact care: is Err (sau numele valorii din enum). Adaugă ramura lipsă. E mai bine decât un else, pentru că vei fi anunțat și la cazurile adăugate pe viitor.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Pentru sealed class, sealed interface și enum class, Kotlin cunoaște lista completă de subtipuri sau valori. De aceea, la un when folosit ca expresie, poate verifica dacă ai tratat fiecare caz și îți spune exact ce lipsește: Add the 'is Err' branch (pentru o subclasă a unei sealed class) sau Add the 'VERDE' branch (pentru o valoare de enum).

Din Kotlin 1.7, regula se aplică și when-urilor folosite ca instrucțiune pe sealed/enum/Boolean, nu doar celor care întorc o valoare.

Ai două reparații: adaugi ramura cerută (recomandat) sau pui un else. Cu else, când cineva adaugă o subclasă nouă (de exemplu Loading), compilatorul nu te mai avertizează, iar cazul nou intră tăcut pe ramura else. Ramurile explicite păstrează verificarea.

De ce apare: cauzele frecvente

1Subclasă uitată într-o sealed class

Greșit
KOTLIN
sealed class Rezultat
class Succes(val date: String) : Rezultat()
class Eroare(val mesaj: String) : Rezultat()

fun afiseaza(r: Rezultat) = when (r) {
    is Succes -> "OK: ${r.date}"
}
Corect
KOTLIN
sealed class Rezultat
class Succes(val date: String) : Rezultat()
class Eroare(val mesaj: String) : Rezultat()

fun afiseaza(r: Rezultat) = when (r) {
    is Succes -> "OK: ${r.date}"
    is Eroare -> "Eroare: ${r.mesaj}"
}

Fiecare subclasă are ramura ei, iar în ramură r este deja convertit la subclasa respectivă (smart cast).

2Valoare de enum netratată

Greșit
KOTLIN
enum class Status { NOUA, LIVRATA, ANULATA }

fun text(s: Status) = when (s) {
    Status.NOUA -> "in asteptare"
    Status.LIVRATA -> "livrata"
}
Corect
KOTLIN
enum class Status { NOUA, LIVRATA, ANULATA }

fun text(s: Status) = when (s) {
    Status.NOUA -> "in asteptare"
    Status.LIVRATA -> "livrata"
    Status.ANULATA -> "anulata"
}

Compilatorul cere Add the 'ANULATA' branch. Cu toate valorile tratate, else nu mai e necesar.

Repară tu

Repară eroarea, direct în pagină

Funcția mesaj de mai jos dă eroarea 'when' expression must be exhaustive, pentru că nu tratează plata respinsă. Adaugă ramura lipsă (fără else), ca programul să afișeze Plata acceptata: 150 lei și Plata respinsa: fonduri insuficiente.

Codul care dă eroarea
KOTLIN
sealed class Plata
class Acceptata(val suma: Int) : Plata()
class Respinsa(val motiv: String) : Plata()

fun mesaj(p: Plata): String = when (p) {
    is Acceptata -> "Plata acceptata: ${p.suma} lei"
}

fun main() {
    println(mesaj(Acceptata(150)))
    println(mesaj(Respinsa("fonduri insuficiente")))
}
După reparație, programul afișează
Plata acceptata: 150 lei
Plata respinsa: fonduri insuficiente
Indiciu

Compilatorul îți spune numele subclasei care lipsește: adaugă o ramură is pentru ea.

Alte forme ale mesajului

  • error: 'when' expression must be exhaustive. Add the 'is Err' branch or an 'else' branch.
  • 'when' expression must be exhaustive, add necessary 'is Eroare' branch or 'else' branch instead
  • 'when' expression must be exhaustive. Add the 'ANULATA' branch or an 'else' branch.

Cum o eviți pe viitor

Modelează stările cu sealed class / sealed interface sau enum și tratează-le cu when fără else. Când adaugi un caz nou, compilatorul îți arată toate locurile din program care trebuie actualizate: e una dintre cele mai utile verificări din Kotlin. Pentru subclasele fără date, folosește object (de exemplu object Loading : Stare()) și ramura fără is: Loading -> ....

Întrebări frecvente

Când folosesc is și când nu?

Pentru subclase (class Eroare(...) : Rezultat()) scrii is Eroare. Pentru object și valori de enum scrii direct numele: Loading ->, Status.NOUA ->.

E greșit să pun else?

Nu e greșit, dar pierzi verificarea pentru cazurile adăugate pe viitor. La sealed class și enum, preferă ramurile explicite.

Erori înrudite

← Toate erorile Kotlin

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kotlin de la zero, cu exerciții la fiecare lecție

Curs Kotlin (Android): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.