...
Eroare Swift · Closure-uri

error: escaping closure captures non-escaping parameter 'completion'

Pe scurt

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 exemplu DispatchQueue.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

Greșit
SWIFT
func salveaza(completion: () -> Void) {
    DispatchQueue.main.async {
        completion()
    }
}
Corect
SWIFT
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

Greșit
SWIFT
var handlers: [() -> Void] = []
func inregistreaza(_ f: () -> Void) {
    handlers.append(f)
}
Corect
SWIFT
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

Greșit
SWIFT
class Buton {
    var actiune: (() -> Void)?
    func laApasare(_ f: () -> Void) { actiune = f }
}
Corect
SWIFT
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ă tu

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.

Codul care dă eroarea
SWIFT
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() }
După reparație, programul afișează
Salvat
Notificare trimisă
Indiciu

Parametrul gata e folosit după ce dupaSalvare s-a terminat, deci are nevoie de @escaping.

Alte forme ale mesajului

  • error: assigning non-escaping parameter 'f' to an '@escaping' closure
  • error: converting non-escaping parameter 'f' to generic parameter 'Element' may allow it to escape
  • error: passing non-escaping parameter 'completion' to function expecting an '@escaping' closure

Cum o eviți pe viitor

  • Pune @escaping pe orice parametru closure care e salvat, apelat asincron sau trimis mai departe la un parametru @escaping.
  • Nu pune @escaping din reflex: dacă closure-ul e apelat imediat (ca la map, 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

← 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.