Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

WebAssembly außerhalb des Browsers

Nach dieser Lektion: Ich kann an den Bytes eines WebAssembly-Moduls erklären, was es enthält.

Lektion, 60 Min.4 BefehleWebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Eine kleine Datei, die überall läuft

WebAssembly, kurz Wasm, ist ein kompaktes Binärformat für Programme. Eine Laufzeitumgebung übersetzt es auf jedem Rechner in Maschinencode, egal wo die Datei landet. Außerhalb des Browsers laufen damit Plugins, Serverless-Funktionen und Kommandozeilenwerkzeuge in einer Sandbox.

Heute starten Sie ein Modul mit Wasmtime und lesen seine Bytes einzeln.

Am Ende dieser Lektion

Notiz

Ich kann an den Bytes eines WebAssembly-Moduls erklären, was es enthält.

Schlüsselwörter

BegriffWas er bedeutetBeispiel
WebAssemblyein portables Binärformat für Programme
Modulein übersetztes WebAssembly-Programmadd.wasm
Laufzeitumgebungdas Programm, das ein Modul lädt und ausführtwasmtime
Sandboxein Zaun, über den das Programm nicht hinausreicht
Importeine Funktion, die der Host dem Modul geben muss
Abschnittein beschrifteter Teil einer .wasm-Datei

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Warum WebAssembly ohne Browser?

Ein natives Programm wird für einen Prozessor und ein Betriebssystem gebaut. Ein WebAssembly-Modul wird einmal gebaut. Die Laufzeitumgebung übersetzt es dann für den Rechner, auf dem es gerade liegt, ob Arm oder Intel, Linux oder Windows.

Außerdem ist es klein und startet in Millisekunden. Darum passt es zu Plugins und Funktionen, die oft starten. In Ihrem Lab läuft Wasmtime von der Bytecode Alliance.

Wasmtime nach der Version fragen

Befehl
docker exec wasm wasmtime --version

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein erstes WASI-Programm starten

Befehl
docker exec wasm wasmtime run hello.wat

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Ein Modul erreicht nur, was es importiert

Ein Modul hat einen eigenen Speicherblock und sonst nichts. Es kann keine Datei öffnen, keine Uhr lesen und kein Byte senden, solange der Host ihm keine Funktion dafür gibt. Diese Funktionen sind seine Importe.

hello.wat importiert genau eine Funktion, fd_write, aus WASI, dem WebAssembly System Interface. Damit kann es Text schreiben, mehr nicht.

Beispiel: was hello.wat verlangt

TeilIn hello.watBedeutung
Importfd_write aus wasi_snapshot_preview1Der Host erlaubt das Schreiben in einen Stream
Speichereine Seite mit 64 KiBSein eigener Speicher, sonst niemandes
DatenHello from WebAssemblyDer Text, abgelegt in diesem Speicher
Export_startDort beginnt ein WASI-Programm

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Was steht in einer .wasm-Datei?

Eine .wasm-Datei beginnt mit vier Magic Bytes, 00 61 73 6d. Sie stehen für eine Null und die Buchstaben asm. Danach folgen vier Bytes Version.

Dann kommen Abschnitte. Jeder besteht aus einem Id-Byte, seiner Größe und seinem Inhalt. Größen stehen als LEB128 da: sieben Bits je Byte, und das oberste Bit ist gesetzt, solange weitere Bytes folgen. Das Lab hat add.wasm mit wasmbin.py Byte für Byte gebaut.

add.wasm Abschnitt für Abschnitt lesen

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

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Beispiel: die Abschnitte von add.wasm

IdAbschnittGrößeWas die Bytes sagen
1type7 Bytesein Funktionstyp: zwei i32 hinein, ein i32 heraus
3function2 Byteseine Funktion vom Typ 0
7export7 BytesFunktion 0 wird als add exportiert
10code9 Byteslocal.get 0, local.get 1, i32.add, end

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein häufiger Fehler

Warnung

Viele halten ein WebAssembly-Modul für einen kleinen Container. Ein Container bringt Dateien eines Betriebssystems mit und ruft den Kernel direkt auf. Ein Modul bringt kein Betriebssystem mit und ruft nur seine Importe auf. Was es darf, entscheidet also allein der Host.

Das handgebaute add.wasm ausführen

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

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Probieren Sie es: Zahlen als LEB128

Code: python
def uleb(n):
    # Sieben Bits je Byte; das oberste Bit sagt: "es folgt noch ein Byte".
    bytes_aus = []
    while True:
        rest = n % 128
        n = n // 128
        if n > 0:
            bytes_aus.append(rest + 128)
        else:
            bytes_aus.append(rest)
            return bytes_aus

for zahl in [5, 127, 128, 300]:
    text = ""
    for byte in uleb(zahl):
        text = text + format(byte, "02x") + " "
    print(zahl, "wird geschrieben als", text)
# Nehmen Sie 1000 in die Liste auf. Wie viele Bytes braucht die Zahl?

Über dieses Lab und seinen Quellcode: WebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.