...
Eroare Swift · Closure-uri

error: escaping closure captures mutating 'self' parameter

Pe scurt

Într-o metodă mutating a unui struct, un closure păstrat pentru mai târziu modifică self. Un struct nu poate fi modificat prin referință după ce metoda s-a terminat: transformă tipul în class, sau întoarce valorile noi în loc să le modifici din closure.

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

Ce înseamnă

Într-o metodă mutating, self se comportă ca un parametru inout: e valid doar cât rulează metoda. Un closure escaping (întors, salvat într-o proprietate, dat unui Task sau unui callback de rețea) poate rula după ce metoda s-a terminat, când nu mai există un self pe care să-l modifice. De aceea Swift interzice ca un astfel de closure să capteze self dintr-o metodă mutating.

Apare des în iOS când un view model e scris ca struct și un callback (incarca { date in self.lista = date }) încearcă să actualizeze starea.

Reparațiile tipice:

  • fă tipul class (tip referință): closure-ul ține o referință la același obiect, iar modificarea se vede peste tot. Ai grijă la cicluri de referințe ([weak self]);
  • dacă rămâi la struct, closure-ul întoarce valoarea, iar codul care deține structura o atribuie.

De ce apare: cauzele frecvente

1Struct care întoarce un closure ce se modifică pe sine

Greșit
SWIFT
struct Contor {
    var valoare = 0
    mutating func handler() -> () -> Void {
        return { self.valoare += 1 }
    }
}
Corect
SWIFT
final class Contor {
    var valoare = 0
    func handler() -> () -> Void {
        return { self.valoare += 1 }
    }
}

O clasă e referință: closure-ul modifică același obiect și după ce metoda s-a terminat.

2View model struct cu callback asincron

Greșit
SWIFT
struct Ecran {
    var titlu = ""
    mutating func incarca(_ cerere: (@escaping (String) -> Void) -> Void) {
        cerere { t in self.titlu = t }
    }
}
Corect
SWIFT
final class Ecran {
    var titlu = ""
    func incarca(_ cerere: (@escaping (String) -> Void) -> Void) {
        cerere { [weak self] t in self?.titlu = t }
    }
}

Starea modificată din callback-uri stă într-o clasă; [weak self] evită ținerea ecranului în viață fără rost.

Repară tu

Repară eroarea, direct în pagină

Contor numără apăsările pe un buton: metoda handler() întoarce closure-ul apelat la fiecare apăsare. După trei apăsări, programul trebuie să afișeze Apasari: 3, dar compilarea se oprește cu escaping closure captures mutating 'self' parameter. Transformă Contor într-o clasă.

Codul care dă eroarea
SWIFT
struct Contor {
    var valoare = 0

    mutating func handler() -> () -> Void {
        return { self.valoare += 1 }
    }
}

var c = Contor()
let apasa = c.handler()
apasa()
apasa()
apasa()
print("Apasari: \(c.valoare)")
După reparație, programul afișează
Apasari: 3
Indiciu

Scrie final class Contor, scoate mutating din metodă și creează obiectul cu let.

Cum o eviți pe viitor

  • Tipurile care își schimbă starea din callback-uri, timere sau task-uri să fie class (în SwiftUI: ObservableObject sau @Observable).
  • Păstrează struct pentru date (modele) care se copiază și se modifică sincron.
  • Dacă un closure trebuie doar să calculeze ceva, fă-l să întoarcă rezultatul în loc să modifice self.

Întrebări frecvente

De ce în clasă merge, iar în struct nu?

Un struct e o valoare: o modificare din closure ar schimba o copie despre care nimeni nu știe. O clasă e o referință: toți cei care au referința văd aceeași modificare.

Trebuie să pun [weak self] peste tot?

Nu. E nevoie doar când obiectul ține el însuși closure-ul (direct sau indirect), ceea ce ar crea un ciclu de referințe. Pentru un closure folosit o dată și eliberat, o captură normală e în regulă.

Erori înrudite

← Toate erorile Swift

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ță Swift de la zero, cu exerciții la fiecare lecție

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