error: escaping closure captures non-escaping parameter 'completion'
Un closure primit ca parametru e folosit după ce funcția s-a terminat (salvat, trimis unui alt closure @escaping, apelat asincron). Marchează parametrul cu @escaping: func f(completion: @escaping () -> Void).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Implicit, un parametru de tip closure este non-escaping: Swift presupune că funcția îl apelează (sau nu) înainte să se termine și nu îl păstrează. Asta permite optimizări și te scutește de grija ciclurilor de referințe.
Când closure-ul trebuie să „scape” din funcție, adică să fie folosit mai târziu, trebuie marcat @escaping. Situații tipice:
- îl salvezi într-o proprietate sau într-un array (
handlers.append(f)); - îl capturezi în alt closure
@escaping(de exempluDispatchQueue.main.async { completion() },Task { ... }, un callback de rețea); - îl întorci din funcție.
Mesajul are mai multe forme, după cum scapă: escaping closure captures non-escaping parameter 'completion', assigning non-escaping parameter 'f' to an @escaping closure, converting non-escaping parameter 'f' to generic parameter 'Element' may allow it to escape.
Cu @escaping, într-o clasă ai grijă la self: closure-ul salvat ține obiectul în viață, de aceea se folosește des [weak self].
De ce apare: cauzele frecvente
1Parametru folosit într-un callback asincron
func salveaza(completion: () -> Void) {
DispatchQueue.main.async {
completion()
}
}func salveaza(completion: @escaping () -> Void) {
DispatchQueue.main.async {
completion()
}
}async rulează mai târziu, după ce salveaza s-a terminat, deci completion trebuie să poată scăpa.
2Closure salvat într-o colecție
var handlers: [() -> Void] = []
func inregistreaza(_ f: () -> Void) {
handlers.append(f)
}var handlers: [() -> Void] = []
func inregistreaza(_ f: @escaping () -> Void) {
handlers.append(f)
}Closure-ul rămâne în handlers și după apel. Fără @escaping mesajul e converting non-escaping parameter 'f' to generic parameter 'Element' may allow it to escape.
3Closure salvat într-o proprietate
class Buton {
var actiune: (() -> Void)?
func laApasare(_ f: () -> Void) { actiune = f }
}class Buton {
var actiune: (() -> Void)?
func laApasare(_ f: @escaping () -> Void) { actiune = f }
}Proprietatea păstrează closure-ul pentru mai târziu, deci parametrul e escaping.
Repară eroarea, direct în pagină
Programul programează acțiuni care rulează după salvare: dupaSalvare pune closure-ul primit într-o listă de sarcini, care se execută la final. Trebuie să afișeze Salvat și Notificare trimisă, dar compilarea se oprește cu escaping closure captures non-escaping parameter 'gata'. Repară declarația parametrului.
var sarcini: [() -> Void] = []
func programeaza(_ s: @escaping () -> Void) {
sarcini.append(s)
}
func dupaSalvare(_ gata: () -> Void) {
programeaza {
print("Salvat")
gata()
}
}
dupaSalvare { print("Notificare trimisă") }
for s in sarcini { s() }Salvat Notificare trimisă
Indiciu
Parametrul gata e folosit după ce dupaSalvare s-a terminat, deci are nevoie de @escaping.
Reparația
var sarcini: [() -> Void] = []
func programeaza(_ s: @escaping () -> Void) {
sarcini.append(s)
}
func dupaSalvare(_ gata: @escaping () -> Void) {
programeaza {
print("Salvat")
gata()
}
}
dupaSalvare { print("Notificare trimisă") }
for s in sarcini { s() }De ce merge
Closure-ul trimis la programeaza e salvat în sarcini și rulează abia la final, după ce dupaSalvare s-a terminat. Pentru că el capturează gata, și gata trebuie să trăiască după apel, adică să fie @escaping. Cu marcajul pus, bucla de la final execută sarcina: afișează Salvat, apoi apelează gata.
Alte forme ale mesajului
error: assigning non-escaping parameter 'f' to an '@escaping' closureerror: converting non-escaping parameter 'f' to generic parameter 'Element' may allow it to escapeerror: passing non-escaping parameter 'completion' to function expecting an '@escaping' closure
Cum o eviți pe viitor
- Pune
@escapingpe orice parametru closure care e salvat, apelat asincron sau trimis mai departe la un parametru@escaping. - Nu pune
@escapingdin reflex: dacă closure-ul e apelat imediat (ca lamap,filter), lasă-l non-escaping. - În clase, folosește
[weak self]în closure-urile escaping care capturează obiectul.
Întrebări frecvente
De ce closure-urile nu sunt escaping implicit?
Pentru că majoritatea (cele de la map, sorted, forEach) sunt apelate imediat. Non-escaping înseamnă că Swift știe că nu pot forma cicluri de referințe, deci nu îți cere self. explicit și poate optimiza.
Closure-urile opționale sunt escaping?
Da. Un parametru (() -> Void)? e tratat automat ca escaping, pentru că opționalul îl împachetează într-o valoare care poate fi păstrată.
Erori înrudite
error: reference to property 'valoare' in closure requires explicit use of 'self' to make capture semantics explicit Î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ță. error: contextual closure type '(Int) -> String' expects 1 argument, but 2 were used in closure body Closure-ul tău are alt număr de parametri decât cere funcția care îl primește. De exemplu map pe un array dă un singur element, nu (index, element): folosește lista.enumerated().map { i, x in ... } sau un singur parametru. error: expression is 'async' but is not marked with 'await' Apelezi o funcție async fără await în față. Scrie let date = await incarca(): await marchează locul în care funcția ta poate aștepta. Dacă funcția apelată e și throws, scrii try await. Î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.
