¿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

WASI 0.2 frente a WASI 0.3

Después de esta lección: Puedo distinguir una interfaz de WASI 0.3 de una de WASI 0.2 y decir qué cambió.

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

Esperar sin bloquear, de serie

WASI 0.3, ratificado el 11 de junio de 2026, añade async nativo al modelo de componentes. Una función puede ser async, y los streams y los futures son tipos de serie. WASI 0.2, publicado en enero de 2024, hacía lo mismo con pollables y recursos de flujo.

Hoy ejecutas un componente construido para cada versión y ves qué cambió.

Al terminar esta lección

Nota

Puedo distinguir una interfaz de WASI 0.3 de una de WASI 0.2 y decir qué cambió.

Palabras clave

PalabraQué significaEjemplo
Función asyncuna función a la que quien llama no tiene que esperarasync func
Streamvalores que llegan uno detrás de otrostream<u8>
Futureun valor que llega más tardefuture<u32>
Pollableel recurso de WASI 0.2 para algo que se espera
Versión semánticauna versión escrita mayor.menor.parche0.3.0

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

Cómo espera WASI 0.2: los pollables

En WASI 0.2, leer de un socket o de un archivo da un recurso input-stream. Para esperar bytes sin quedarse congelado, el código pide al flujo un pollable y se lo pasa a poll, que vuelve cuando algo está listo.

Cada interfaz que espera necesita su propio pollable, y cada lenguaje tiene que conectarlos a mano con su propio sistema async.

Ejecuta el componente construido para WASI 0.2

Comando
docker exec wasm wasmtime run --invoke 'ticking()' clock2.wat

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

Ejecuta el componente construido para WASI 0.3

Comando
docker exec wasm wasmtime run --invoke 'ticking()' clock3.wat

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

Qué cambió WASI 0.3

WASI 0.3 lleva la espera al propio modelo de componentes. WIT ya puede decir async func, stream<u8> y future<T>. Así el runtime sabe cuándo una llamada espera y puede ejecutar otra cosa.

Las interfaces se acortan. Un manejador HTTP pasa a ser una función async que recibe una petición y devuelve una respuesta. Wasmtime activó WASI 0.3 por defecto en la versión 46; la opción -S p3=n lo desactiva.

Ejemplo: una misma tarea en cada versión

TareaWASI 0.2WASI 0.3
Esperar bytesinput-stream, luego un pollable y pollleer un stream<u8>
Dormir un ratoun pollable del relojuna función async del reloj
Responder a una petición webun manejador y un parámetro de salida para la respuestauna función async, entra la petición y sale la respuesta
Hacer dos llamadas a la vezpoll sobre una lista de pollablesel runtime ejecuta las llamadas async en paralelo

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

Desactiva WASI 0.3 y ejecuta otra vez

Comando
docker exec wasm wasmtime run -S p3=n --invoke 'ticking()' clock3.wat

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

Un error frecuente

Advertencia

Mucha gente cree que hay que reconstruir todos los componentes de WASI 0.2 cuando los anfitriones pasen a 0.3. Wasmtime sigue dando las interfaces 0.2 junto a las 0.3, como mostró el laboratorio. Solo hay que reconstruir un componente para usar funciones async o streams.

Pruébalo: dos esperas que se turnan

Código: python
import asyncio

async def fetch(name, steps):
    # Cada await devuelve el control, así que la otra tarea avanza mientras tanto.
    for n in range(steps):
        print(name, "está esperando, paso", n + 1)
        await asyncio.sleep(0)
    return name + " terminada"

async def main():
    results = await asyncio.gather(fetch("registros", 2), fetch("precios", 3))
    print(results)

asyncio.run(main())
# Cambia 3 por 1. ¿Qué tarea termina primero ahora?

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.