Tester le tampon et la terminaison d’AsyncStream pour iOS
Votre écran iOS reçoit des événements de progression via AsyncStream. Tout fonctionne lorsque les actions sont espacées, mais des états intermédiaires disparaissent quand les déclenchements s’enchaînent. Après avoir quitté l’écran, l’écouteur sous-jacent continue de fonctionner. N’augmentez pas les délais tout de suite. Sur un Mac cloud VPSPull, imposez un ordre fixe à la production et à la consommation des événements, puis vérifiez séparément les contrats de mise en tampon, de terminaison et de nettoyage. Vous trouverez plus facilement la cause qu’en multipliant les clics sur le bureau distant.
Définir les événements dont la perte est acceptable
Pour un pourcentage de progression, le dernier état suffit généralement. En revanche, on ne peut pas perdre arbitrairement une confirmation de paiement ou un enregistrement de remise de fichier. Commencez par définir trois conditions pour le flux : quelles valeurs doivent impérativement parvenir au consommateur, comment traiter les événements qui s’accumulent et qui doit arrêter le producteur. Ne laissez pas la politique de mise en tampon par défaut décider à la place de la logique métier.
unbounded conserve les éléments qui n’ont pas encore été consommés, mais une production continue peut faire croître indéfiniment l’utilisation de la mémoire ; bufferingNewest(2) conserve les deux éléments les plus récents ; bufferingOldest(2) conserve les deux éléments les plus anciens en attente de consommation. La capacité correspond ici à un nombre d’éléments, pas à un nombre d’octets : des objets volumineux peuvent donc toujours occuper beaucoup de mémoire.
Un tampon borné n’est pas un mécanisme de contre-pression. Le yield d’AsyncStream n’attend pas que le consommateur libère de la place. Si la logique métier exige une transmission sans perte, il faut prévoir un mécanisme distinct d’acquittement, de limitation du débit ou de stockage persistant.
Testez d’abord avec un seul consommateur. Plusieurs tâches consommant le même flux ne constituent pas automatiquement un modèle de diffusion où chaque abonné reçoit tous les événements.
Construire un dispositif de test indépendant des aléas de l’ordonnancement
Dans un terminal où la chaîne d’outils Swift est déjà configurée, exécutez :
mkdir StreamContract
cd StreamContract
swift package init --type library --name StreamContract
swift --version
Remplacez le contenu du fichier de test généré par le test XCTest ci-dessous. Placez le fichier dans Tests/StreamContractTests/StreamContractTests.swift. Si le modèle a créé d’autres fichiers de test, supprimez d’abord leurs tests d’exemple pour ne pas ajouter de résultats sans rapport au compte rendu.
import XCTest
final class StreamContractTests: XCTestCase {
func testNewestBufferDrainsAfterFinish() async {
let pair = AsyncStream<Int>.makeStream(
bufferingPolicy: .bufferingNewest(2)
)
pair.continuation.yield(1)
pair.continuation.yield(2)
switch pair.continuation.yield(3) {
case .dropped(let value):
XCTAssertEqual(value, 1)
default:
XCTFail("Expected the oldest buffered value to be dropped")
}
pair.continuation.finish()
var iterator = pair.stream.makeAsyncIterator()
let first = await iterator.next()
let second = await iterator.next()
let end = await iterator.next()
XCTAssertEqual(first, 2)
XCTAssertEqual(second, 3)
XCTAssertNil(end)
switch pair.continuation.yield(4) {
case .terminated:
break
default:
XCTFail("Expected a terminated stream")
}
}
}
Exécutez ensuite swift test. Ce test produit les éléments avant de les consommer, ce qui provoque explicitement un débordement du tampon. Inutile d’utiliser des pauses pour tenter de deviner l’ordre d’exécution. Si votre chaîne d’outils ne propose pas makeStream, vérifiez d’abord la version de Swift ou récupérez la continuation à l’aide de la closure d’initialisation. Ne supprimez pas l’assertion de débordement sous prétexte de « compatibilité ».
Vérifier les valeurs abandonnées, pas seulement les valeurs consommées
Vérifier uniquement que les valeurs finales sont 2, 3 ne suffit pas : une implémentation incorrecte pourrait filtrer elle-même 1 et produire le même résultat par hasard. C’est la vérification du résultat .dropped renvoyé par yield qui confirme que la perte intervient au niveau de la politique de mise en tampon.
Dupliquez ensuite le test en utilisant bufferingOldest(2). Le troisième yield doit signaler l’abandon de 3, et le consommateur doit recevoir 1, 2. Traduisez ces attentes en tests distincts, avec des noms adaptés. Ne modifiez pas la réponse attendue dans le test en fonction de la sortie réellement observée.
Ajoutez aussi un cas limite : avec une capacité nulle et aucun consommateur en attente, l’élément passé à yield est abandonné. Une capacité nulle ne garantit pas une remise synchrone. Si le test démarre le consommateur à l’avance, il faut un signal de synchronisation confirmant qu’il est déjà en attente. Sinon, le résultat dépendra de l’ordonnancement des tâches.
Pour des objets réels, conservez simplement des identifiants d’événements stables. Ne journalisez pas l’intégralité des données transportées. Lorsque celles-ci sont volumineuses, les identifiants, le nombre d’événements abandonnés et la politique de mise en tampon suffisent à l’analyse.
Distinguer finish, l’annulation et la sortie anticipée
finish() signifie que le flux n’accepte plus de nouveaux éléments, pas qu’il abandonne immédiatement ceux qui sont déjà dans le tampon. Le test ci-dessus vérifie délibérément que 2, 3 sont lus d’abord, puis que next renvoie nil. Un yield effectué après la terminaison doit renvoyer .terminated.
Créez un dispositif distinct pour tester l’annulation : placez la tâche consommatrice en attente sur next, annulez-la, puis attendez qu’elle se termine. Utilisez un compteur thread-safe ou une attente de test pour enregistrer onTermination, vérifier que la cause de la terminaison est bien l’annulation et confirmer que l’écouteur sous-jacent s’est arrêté. Un délai d’expiration fini sert uniquement à éviter qu’un test reste bloqué ; il ne prouve pas la validité de la logique métier.
Prévoir un propriétaire explicite pour la sortie anticipée
Un break dans une boucle ne fait que quitter cette boucle. Si d’autres objets conservent encore le flux ou la continuation, vous ne pouvez pas en déduire que l’écouteur a été libéré. Fournissez à l’adaptateur un stop explicite, appelé par son propriétaire — l’écran ou le service —, puis vérifiez le nombre de désinscriptions.
onTermination peut s’exécuter dans un contexte concurrent. L’état capturé par la closure de nettoyage doit supporter les accès concurrents. Ne modifiez pas directement des objets d’interface qui ne peuvent être utilisés que depuis le thread principal. N’appelez pas non plus finish en détenant un verrou interne si le callback de terminaison doit ensuite acquérir ce même verrou.
Conclure avec une matrice d’échecs plutôt qu’avec des délais plus longs
Conservez au minimum quatre catégories de tests de validation : éviction des anciennes valeurs avec le tampon privilégiant les plus récentes, rejet des nouvelles valeurs avec celui privilégiant les plus anciennes, vidage du tampon lors d’une terminaison normale et arrêt de la production après annulation. Pour chaque catégorie, vérifiez les valeurs, l’état de terminaison et le nombre d’opérations de nettoyage. Vous éviterez ainsi des tests réussis alors que les ressources continuent de fonctionner.
Utilisez ensuite un faux écouteur pour provoquer une course à l’arrêt : après stop, déclenchez encore un callback. L’adaptateur doit l’ignorer sans risque ou recevoir terminated, sans livrer une seconde fois un événement métier. Des appels répétés à stop doivent également rester idempotents, sans désinscrire plusieurs fois le même handle d’écouteur.
Lors de la soumission des modifications, conservez aussi la version de la chaîne d’outils, la commande de test et les noms des cas en échec. Si les tests à ordre fixe sont stables mais que l’écran réel perd encore des événements, examinez ensuite l’adaptateur de la source d’événements et la vitesse de traitement du consommateur. Si le dispositif de test lui-même est instable, corrigez d’abord la synchronisation au lieu de masquer la course avec des pauses plus longues.
Questions fréquentes
bufferingNewest fait-il attendre le producteur ?
Non. Lorsque le tampon est plein, une ancienne valeur est évincée et yield signale la perte. Une transmission bornée sans perte nécessite un mécanisme distinct de confirmation ou de régulation.
Un break libère-t-il immédiatement l’écouteur ?
Pas nécessairement. Il quitte la boucle, mais le flux et sa continuation peuvent rester référencés. Le propriétaire doit arrêter explicitement l’écouteur et tester chaque chemin de nettoyage.
Testez votre workflow sur un Mac dédié
Vérifiez d’abord le modèle, le centre de données et la durée de location, puis faites un essai d’une journée. L’état réel de disponibilité est indiqué en temps réel dans la console.