...
Eroare Swift · Closure-uri

error: reference to property 'valoare' in closure requires explicit use of 'self' to make capture semantics explicit

Pe scurt

Într-un closure escaping dintr-o clasă folosești o proprietate fără self. Swift cere să scrii self.valoare (sau [self] / [weak self] în lista de captură), ca să fie vizibil că closure-ul ține obiectul în viață.

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

Ce înseamnă

Un closure care folosește o proprietate a unei clase capturează self, adică păstrează o referință puternică la obiect. Dacă closure-ul e escaping (salvat într-o proprietate, trimis la un callback), poate ține obiectul în viață mai mult decât te aștepți, iar dacă obiectul ține la rândul lui closure-ul, apare un ciclu de referințe (memory leak).

Ca să nu se întâmple asta fără să observi, Swift te obligă să scrii explicit self în closure-urile escaping din clase. Ai trei variante:

  • self.valoare în corpul closure-ului;
  • [self] în lista de captură, apoi folosești proprietățile direct;
  • [weak self], apoi self?.valoare (sau guard let self else { return }), când nu vrei ca closure-ul să țină obiectul în viață.

La struct-uri și enum-uri (tipuri valoare), self explicit nu e necesar, pentru că nu pot forma cicluri de referințe. Nici closure-urile non-escaping (map, forEach) nu cer self..

De ce apare: cauzele frecvente

1Proprietate folosită într-un closure salvat

Greșit
SWIFT
class Contor {
    var valoare = 0
    var actiune: (() -> Void)?
    func pregateste() {
        actiune = { valoare += 1 }
    }
}
Corect
SWIFT
class Contor {
    var valoare = 0
    var actiune: (() -> Void)?
    func pregateste() {
        actiune = { [weak self] in self?.valoare += 1 }
    }
}

[weak self] nu ține obiectul în viață și evită ciclul Contor → actiune → Contor.

2Metodă apelată dintr-un callback

Greșit
SWIFT
class Ecran {
    func reincarca() {}
    func incarca() {
        DispatchQueue.main.async { reincarca() }
    }
}
Corect
SWIFT
class Ecran {
    func reincarca() {}
    func incarca() {
        DispatchQueue.main.async { self.reincarca() }
    }
}

Aici closure-ul rulează o dată și e eliberat, deci capturarea puternică e în regulă; trebuie doar scrisă explicit. Mesajul e call to method 'reincarca' in closure requires explicit use of 'self'.

Repară tu

Repară eroarea, direct în pagină

Clasa Clicker pregătește o acțiune care crește contorul de fiecare dată când e apelată. Programul apelează acțiunea de trei ori și trebuie să afișeze Clickuri: 3, dar compilarea se oprește cu reference to property 'clickuri' in closure requires explicit use of 'self'. Scrie explicit self în closure.

Codul care dă eroarea
SWIFT
class Clicker {
    var clickuri = 0
    var actiune: (() -> Void)?

    func pregateste() {
        actiune = {
            clickuri += 1
        }
    }
}

let c = Clicker()
c.pregateste()
for _ in 1...3 {
    c.actiune?()
}
print("Clickuri: \(c.clickuri)")
După reparație, programul afișează
Clickuri: 3
Indiciu

În closure, clickuri += 1 devine self.clickuri += 1.

Alte forme ale mesajului

  • error: call to method 'reincarca' in closure requires explicit use of 'self' to make capture semantics explicit
  • error: reference to property 'n' in closure requires explicit use of 'self' to make capture semantics explicit

Cum o eviți pe viitor

  • În clase, când salvezi un closure care folosește obiectul, pornește de la [weak self].
  • Pentru closure-uri care rulează o singură dată (callback-uri scurte), self. explicit e suficient.
  • La struct-uri nu ai această problemă; e unul dintre motivele pentru care SwiftUI folosește mult tipuri valoare.

Întrebări frecvente

Când folosesc [weak self] și când [unowned self]?

weak face self opțional și devine nil când obiectul dispare, deci e sigur. unowned presupune că obiectul există mereu cât trăiește closure-ul; dacă nu, programul se oprește. Pentru început, alege weak.

De ce în map nu trebuie self?

Closure-ul din map e non-escaping: e apelat imediat și nu e păstrat, deci nu poate crea un ciclu de referințe. Swift cere self explicit doar acolo unde contează.

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.