¿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

Interfaces WIT y componentes de WebAssembly

Después de esta lección: Puedo leer un mundo WIT y decir qué importa y qué exporta un componente.

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

Programas que se ponen de acuerdo en tipos

Un componente de WebAssembly es un módulo envuelto con una descripción tipada de lo que importa y exporta. Esa descripción se escribe en WIT, el lenguaje de tipos de interfaz de WebAssembly. Gracias a ella, un componente escrito en Rust puede pasar un texto o una lista a otro escrito en Python.

Hoy lees un archivo WIT y llamas a un componente a través de él.

Al terminar esta lección

Nota

Puedo leer un mundo WIT y decir qué importa y qué exporta un componente.

Palabras clave

PalabraQué significaEjemplo
Componenteun módulo más importaciones y exportaciones tipadas
WITel lenguaje que describe esos tiposcalc.wit
Interfazun grupo con nombre de funciones y tiposmath
Mundotodo lo que un componente importa y exportaworld calculator
Paqueteel nombre y la versión de un conjunto de interfacesdemo:[email protected]
Elevarconvertir una función del módulo base en una tipadacanon lift

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

Un módulo base solo habla con números

Un módulo normal, un módulo base, pasa cuatro tipos de valor: i32, i64, f32 y f64. Un texto tiene que viajar como una posición en memoria y una longitud, y los dos lados tienen que acordar cómo.

El modelo de componentes fija ese acuerdo una sola vez, en la ABI canónica. WIT dice string, list o record, y el runtime mueve los bytes. Dos componentes nunca comparten memoria.

Lee el archivo WIT del laboratorio

Comando
docker exec tools cat calc.wit

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

Ejemplo: las partes de calc.wit

LíneaTipoQué dice
package demo:[email protected];paqueteEspacio de nombres demo, nombre calc, versión 0.1.0
interface math { ... }interfazUna función, add: func(a: u32, b: u32) -> u32
world calculator { export math; }mundoUn componente que ofrece math
world doubler { import math; export double: ... }mundoNecesita math y ofrece double

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

Un componente es un módulo más sus tipos

Abre calc.wat con docker exec tools cat calc.wat. Dentro hay un módulo base corriente cuyo add recibe dos i32 y devuelve uno.

Una línea canon lift lo convierte en add: func(a: u32, b: u32) -> u32, el tipo que prometía WIT. El componente lo exporta dentro de la instancia demo:calc/[email protected]. Wasmtime puede llamarlo por su nombre con --invoke.

Llama al add del componente

Comando
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.wat

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

Suma dos números demasiado grandes

Comando
docker exec wasm wasmtime run --invoke 'add(4000000000, 500000000)' calc.wat

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

Un mundo es un contrato con el anfitrión

Un mundo lista lo que un componente necesita y lo que ofrece. El anfitrión tiene que aportar cada importación antes de que el componente arranque, así que el mundo es todo lo que puede tocar.

WASI también se escribe como mundos WIT. Un componente de terminal importa interfaces como wasi:filesystem y wasi:cli/environment, y exporta wasi:cli/run. Un anfitrión puede leer esa lista antes de ejecutar nada.

Un error frecuente

Advertencia

Mucha gente cree que un archivo WIT es código que se ejecuta. WIT solo describe tipos y funciones, como un contrato. El código está en el componente, y el mismo WIT lo pueden cumplir componentes escritos en cualquier lenguaje.

Pruébalo: por qué 4500 millones dieron 205032704

Código: python
MASK = 2 ** 32

def add_u32(a, b):
    # Un i32.add del módulo base solo guarda los 32 bits bajos de la suma.
    return (a + b) % MASK

def as_signed(n):
    # Los mismos 32 bits, leídos como un número con signo.
    if n >= 2 ** 31:
        return n - MASK
    return n

for pair in [[2, 3], [4000000000, 500000000], [3000000000, 0]]:
    total = add_u32(pair[0], pair[1])
    print(pair[0], "+", pair[1], "=", total, "como u32 y", as_signed(total), "como s32")
# Añade [4294967295, 1] a la lista. ¿En qué se queda?

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.