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

WebAssembly hors du navigateur

Après cette leçon: Je peux expliquer ce que contient un module WebAssembly en lisant ses octets.

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

Un petit fichier qui tourne partout

WebAssembly, ou Wasm, est un format binaire compact pour les programmes. Un runtime le traduit en code machine sur l’ordinateur où il arrive. Hors du navigateur, il fait tourner des plugins, des fonctions serverless et des outils en ligne de commande, dans un bac à sable.

Aujourd’hui, vous lancez un module avec Wasmtime et vous lisez ses octets un par un.

À la fin de cette leçon

Remarque

Je peux expliquer ce que contient un module WebAssembly en lisant ses octets.

Mots-clés

MotCe que ça veut direExemple
WebAssemblyun format binaire portable pour les programmes
Moduleun programme WebAssembly compiléadd.wasm
Runtimele programme qui charge et exécute un modulewasmtime
Bac à sableune clôture que le programme ne peut pas franchir
Importune fonction que l’hôte doit fournir au module
Sectionune partie étiquetée d’un fichier .wasm

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

Pourquoi WebAssembly hors du navigateur ?

Un programme natif est construit pour un processeur et un système d’exploitation. Un module WebAssembly est construit une seule fois. Le runtime le compile ensuite pour la machine présente, Arm ou Intel, Linux ou Windows.

Il démarre aussi en quelques millisecondes et reste petit. C’est pourquoi il convient aux plugins et aux fonctions lancés souvent. Wasmtime, de la Bytecode Alliance, est le runtime de votre labo.

Demander sa version à Wasmtime

Commande
docker exec wasm wasmtime --version

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

Lancer un premier programme WASI

Commande
docker exec wasm wasmtime run hello.wat

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

Un module n’atteint que ce qu’il importe

Un module a son propre bloc de mémoire, et rien d’autre. Il ne peut ni ouvrir un fichier, ni lire l’horloge, ni envoyer un octet. Il faut que l’hôte lui donne une fonction pour cela. Ces fonctions sont ses imports.

hello.wat importe une seule fonction, fd_write, depuis WASI, la WebAssembly System Interface. Avec cet import, il peut écrire du texte, et rien de plus.

Exemple travaillé : ce que demande hello.wat

PartieDans hello.watCe que cela veut dire
Importfd_write depuis wasi_snapshot_preview1L’hôte le laisse écrire dans un flux
Mémoireune page de 64 KioSa propre mémoire, celle de personne d’autre
DonnéesHello from WebAssemblyLe texte, rangé dans cette mémoire
Export_startLà où commence un programme WASI

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

Que contient un fichier .wasm ?

Un fichier .wasm commence par quatre octets magiques, 00 61 73 6d : un zéro, puis les lettres asm. Quatre octets de version suivent.

Viennent ensuite les sections. Chacune donne un octet d’identifiant, sa taille, puis son contenu. Les tailles sont écrites en LEB128 : sept bits par octet, et le bit de poids fort reste à 1 tant qu’un octet suit. Le labo a construit add.wasm octet par octet avec wasmbin.py.

Lire add.wasm section par section

Commande
docker exec tools python3 steps/sections.py add.wasm

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

Exemple travaillé : les sections de add.wasm

IdSectionTailleCe que disent les octets
1type7 octetsun type de fonction : deux i32 en entrée, un i32 en sortie
3function2 octetsune fonction, du type 0
7export7 octetsexporter la fonction 0 sous le nom add
10code9 octetslocal.get 0, local.get 1, i32.add, end

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

Erreur fréquente

Attention

On croit souvent qu’un module WebAssembly est un petit conteneur. Un conteneur emporte les fichiers d’un système d’exploitation et appelle le noyau directement. Un module n’emporte aucun système et ne peut appeler que ses imports. C’est donc l’hôte qui décide de tout ce qu’il peut faire.

Lancer add.wasm, construit à la main

Commande
docker exec wasm wasmtime run --invoke add add.wasm 2 3

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

À vous : écrire des nombres en LEB128

Code: python
def uleb(n):
    # Sept bits par octet ; le bit de poids fort dit "un autre octet suit".
    octets = []
    while True:
        bas = n % 128
        n = n // 128
        if n > 0:
            octets.append(bas + 128)
        else:
            octets.append(bas)
            return octets

for nombre in [5, 127, 128, 300]:
    texte = ""
    for octet in uleb(nombre):
        texte = texte + format(octet, "02x") + " "
    print(nombre, "s’écrit", texte)
# Ajoutez 1000 à la liste. Combien d’octets lui faut-il ?

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