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
| Palabra | Qué significa | Ejemplo |
|---|---|---|
| WebAssembly | un formato binario portable para programas | |
| Módulo | un programa de WebAssembly ya compilado | add.wasm |
| Runtime | el programa que carga y ejecuta un módulo | wasmtime |
| Entorno aislado | una valla que el programa no puede cruzar | |
| Importación | una función que el anfitrión tiene que dar al módulo | |
| Sección | una 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
docker exec wasm wasmtime --versionSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Ejecuta un primer programa WASI
docker exec wasm wasmtime run hello.watSe 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
| Parte | En hello.wat | Qué significa |
|---|---|---|
| Importación | fd_write de wasi_snapshot_preview1 | El anfitrión le deja escribir en un flujo |
| Memoria | una página de 64 KiB | Su propia memoria, de nadie más |
| Datos | Hello from WebAssembly | El texto, guardado en esa memoria |
| Exportación | _start | Donde 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
docker exec tools python3 steps/sections.py add.wasmSe muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.
Ejemplo: las secciones de add.wasm
| Id | Sección | Tamaño | Qué dicen los bytes |
|---|---|---|---|
| 1 | type | 7 bytes | un tipo de función: entran dos i32 y sale un i32 |
| 3 | function | 2 bytes | una función, del tipo 0 |
| 7 | export | 7 bytes | exporta la función 0 como add |
| 10 | code | 9 bytes | local.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
docker exec wasm wasmtime run --invoke add add.wasm 2 3Se 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
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?