Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

WASI 0.2 face à WASI 0.3

Après cette leçon: Je peux distinguer une interface WASI 0.3 d’une interface WASI 0.2 et dire ce qui a changé.

Leçon de 60 min3 commandesLab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Attendre sans bloquer, intégré au modèle

WASI 0.3, ratifié le 11 juin 2026, ajoute l’asynchrone natif au Component Model. Une fonction peut être async, et les streams et les futures deviennent des types intégrés. WASI 0.2, sorti en janvier 2024, faisait les mêmes travaux avec des pollables et des ressources de flux.

Aujourd’hui, vous lancez un composant construit pour chaque version et vous voyez ce qui a changé.

À la fin de cette leçon

Remarque

Je peux distinguer une interface WASI 0.3 d’une interface WASI 0.2 et dire ce qui a changé.

Mots-clés

MotCe que ça veut direExemple
Fonction asyncune fonction que l’appelant n’est pas obligé d’attendreasync func
Streamdes valeurs qui arrivent les unes après les autresstream<u8>
Futureune seule valeur qui arrivera plus tardfuture<u32>
Pollablela poignée de WASI 0.2 pour une chose à attendre
Version sémantiqueune version écrite majeure.mineure.correctif0.3.0

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Comment WASI 0.2 attend : les pollables

Dans WASI 0.2, lire un socket ou un fichier donne une ressource input-stream. Pour attendre des octets sans tout figer, le code demande au flux un pollable. Il le passe à poll, qui rend la main quand quelque chose est prêt.

Chaque interface qui attend a besoin de son propre pollable. Et chaque langage doit le brancher à la main sur son propre système asynchrone.

Lancer le composant construit pour WASI 0.2

Commande
docker exec wasm wasmtime run --invoke 'ticking()' clock2.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Lancer le composant construit pour WASI 0.3

Commande
docker exec wasm wasmtime run --invoke 'ticking()' clock3.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Ce que WASI 0.3 a changé

WASI 0.3 fait entrer l’attente dans le Component Model lui-même. WIT peut maintenant dire async func, stream<u8> et future<T>. Le runtime sait donc quand un appel attend, et peut faire tourner autre chose.

Les interfaces raccourcissent. Un gestionnaire HTTP devient une seule fonction async qui prend une requête et renvoie une réponse. Wasmtime a activé WASI 0.3 par défaut dans sa version 46 ; l’option -S p3=n le désactive.

Exemple travaillé : un même travail dans chaque version

TravailWASI 0.2WASI 0.3
Attendre des octetsinput-stream, puis un pollable et polllire un stream<u8>
Dormir un momentun pollable venu de l’horlogeune fonction async de l’horloge
Répondre à une requête webun gestionnaire et un paramètre de sortie pour la réponseune fonction async, requête en entrée, réponse en sortie
Mener deux appels à la foispoll sur une liste de pollablesle runtime mène les appels async côte à côte

Les cellules que les étudiants remplissent restent vides dans cet aperçu.

Désactiver WASI 0.3 et relancer

Commande
docker exec wasm wasmtime run -S p3=n --invoke 'ticking()' clock3.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Erreur fréquente

Attention

On croit souvent que chaque composant WASI 0.2 devra être reconstruit quand les hôtes passeront à 0.3. Wasmtime fournit toujours les interfaces 0.2 à côté des interfaces 0.3, comme le labo l’a montré. Un composant ne doit être reconstruit que pour utiliser des fonctions async ou des streams.

À vous : deux attentes à tour de rôle

Code: python
import asyncio

async def recuperer(nom, etapes):
    # Chaque await rend la main, donc l’autre tâche avance pendant ce temps.
    for n in range(etapes):
        print(nom, "attend, étape", n + 1)
        await asyncio.sleep(0)
    return nom + " fini"

async def principal():
    resultats = await asyncio.gather(recuperer("journaux", 2), recuperer("prix", 3))
    print(resultats)

asyncio.run(principal())
# Remplacez 3 par 1. Quelle tâche finit en premier maintenant ?

À propos de ce labo et de sa source: Lab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Vous enseignez à une classe ? Proposez ce module à vos étudiants avec un guide de l'enseignant, des devoirs corrigés et un laboratoire pour chaque étudiant.