¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

WebAssembly fuera del navegador

Después de esta lección: Puedo explicar qué contiene un módulo de WebAssembly leyendo sus bytes.

Lección de 60 min4 comandosLaboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

Un archivo pequeño que funciona en cualquier sitio

WebAssembly, o Wasm, es un formato binario compacto para programas. Un runtime lo convierte en código máquina en el ordenador donde llegue. Fuera del navegador ejecuta plugins, funciones serverless y herramientas de terminal dentro de un entorno aislado.

Hoy ejecutas un módulo con Wasmtime y lees sus bytes uno a uno.

Al terminar esta lección

Nota

Puedo explicar qué contiene un módulo de WebAssembly leyendo sus bytes.

Palabras clave

PalabraQué significaEjemplo
WebAssemblyun formato binario portable para programas
Móduloun programa de WebAssembly ya compiladoadd.wasm
Runtimeel programa que carga y ejecuta un módulowasmtime
Entorno aisladouna valla que el programa no puede cruzar
Importaciónuna función que el anfitrión tiene que dar al módulo
Secciónuna parte con etiqueta de un archivo .wasm

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

¿Por qué usar WebAssembly fuera del navegador?

Un programa nativo se construye para un procesador y un sistema operativo. Un módulo de WebAssembly se construye una vez, y el runtime lo compila para la máquina que tiene delante, Arm o Intel, Linux o Windows.

Además arranca en milisegundos y ocupa poco. Por eso encaja con plugins y funciones que arrancan a menudo. El runtime de tu laboratorio es Wasmtime, de la Bytecode Alliance.

Pregunta a Wasmtime su versión

Comando
docker exec wasm wasmtime --version

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejecuta un primer programa WASI

Comando
docker exec wasm wasmtime run hello.wat

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un módulo solo alcanza lo que importa

Un módulo tiene su propio bloque de memoria y nada más. No puede abrir un archivo, leer el reloj ni enviar un byte si el anfitrión no le da una función para hacerlo. Esas funciones son sus importaciones.

hello.wat importa una sola función, fd_write, de WASI, la interfaz de sistema de WebAssembly. Con esa importación puede escribir texto, y nada más.

Ejemplo: lo que pide hello.wat

ParteEn hello.watQué significa
Importaciónfd_write de wasi_snapshot_preview1El anfitrión le deja escribir en un flujo
Memoriauna página de 64 KiBSu propia memoria, de nadie más
DatosHello from WebAssemblyEl texto, guardado en esa memoria
Exportación_startDonde empieza un programa WASI

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

¿Qué hay dentro de un archivo .wasm?

Un archivo .wasm empieza con cuatro bytes mágicos, 00 61 73 6d, que forman un cero y la palabra asm. Detrás van cuatro bytes de versión.

Luego vienen las secciones. Cada una lleva un byte de id, su tamaño y su cuerpo. Los tamaños van en LEB128: siete bits por byte, con el bit de arriba encendido mientras sigan más bytes. El laboratorio construyó add.wasm byte a byte con wasmbin.py.

Lee add.wasm sección a sección

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejemplo: las secciones de add.wasm

IdSecciónTamañoQué dicen los bytes
1type7 bytesun tipo de función: entran dos i32 y sale un i32
3function2 bytesuna función, del tipo 0
7export7 bytesexporta la función 0 como add
10code9 byteslocal.get 0, local.get 1, i32.add, end

Las celdas que rellenan los estudiantes quedan en blanco en esta vista previa.

Un error frecuente

Advertencia

Mucha gente cree que un módulo de WebAssembly es un contenedor pequeño. Un contenedor lleva archivos de un sistema operativo y llama directamente al núcleo. Un módulo no lleva sistema operativo y solo puede llamar a sus importaciones, así que el anfitrión decide todo lo que puede hacer.

Ejecuta el add.wasm hecho a mano

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Pruébalo: escribe números en LEB128

Código: python
def uleb(n):
    # Siete bits en cada byte; el bit de arriba dice "viene otro byte".
    out = []
    while True:
        low = n % 128
        n = n // 128
        if n > 0:
            out.append(low + 128)
        else:
            out.append(low)
            return out

for number in [5, 127, 128, 300]:
    text = ""
    for byte in uleb(number):
        text = text + format(byte, "02x") + " "
    print(number, "se escribe como", text)
# Añade 1000 a la lista. ¿Cuántos bytes necesita?

Sobre este laboratorio y su código: Laboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

¿Enseñas a una clase? Asigna este módulo a tus alumnos con guía del profesor, tareas con corrección automática y un laboratorio para cada alumno.