# WebAssembly

## Qué es

WebAssembly, que suele abreviarse como Wasm, es un formato binario para código ejecutable. Su especificación principal lo llama «un formato de código seguro, portable y de bajo nivel, diseñado para una ejecución eficiente y una representación compacta» y lo describe como un conjunto de instrucciones virtual: las instrucciones de un procesador imaginario, que un navegador u otro entorno anfitrión primero comprueba y después traduce a código máquina para el procesador real. La forma corta es una contracción, no una sigla; por eso la especificación escribe Wasm y no WASM.

Un archivo `.wasm` suele ser el resultado de un compilador para otro lenguaje. El objetivo principal, según la propia especificación, es que las aplicaciones web sean rápidas, pero el formato no presupone la web: también puede ejecutarse como una máquina virtual independiente o dentro de otros programas. El estándar se divide en capas para reflejarlo: la especificación principal define las instrucciones, los formatos, la validación y la ejecución, sin un entorno concreto. Otros documentos definen la API de JavaScript que compila, enlaza e invoca los módulos, y la API web que los carga por la red.

La primera versión se convirtió en Recomendación del W3C el 5 de diciembre de
2019. La versión 2.0, prácticamente terminada tres años antes de su sucesora, añadió instrucciones vectoriales, operaciones masivas sobre la memoria, funciones con más de un valor de retorno y una primera forma sencilla de tipos de referencia. El 17 de septiembre de 2025, el proyecto anunció la versión 3.0 como estándar vigente e indicó que ya se distribuía en la mayoría de los principales navegadores. El mismo anuncio cita Java, OCaml, Scala, Kotlin, Scheme y Dart entre los lenguajes que ya generan Wasm mediante su recolector de basura.

El vocabulario es reducido. La unidad de código es un módulo: contiene funciones, tablas, memorias y variables globales; importa lo que necesita, con un nombre de módulo y otro de elemento para cada importación, y exporta lo que ofrece bajo sus propios nombres. Hay cuatro tipos numéricos, enteros y números en coma flotante de 32 y 64 bits, escritos `i32`, `i64`, `f32` y `f64`, además de un único tipo vectorial de 128 bits y referencias opacas. Los enteros no tienen signo por sí mismos: cada operación los interpreta con o sin signo, y un entero de 32 bits también sirve como booleano. Las direcciones de memoria usan `i32` o, para una memoria de 64 bits, `i64`. Las instrucciones toman sus operandos de una pila implícita y dejan en ella los resultados. El flujo de control es estructurado: bloques, bucles y condicionales se anidan, y un salto solo puede dirigirse a uno de ellos.

Los datos direccionados por bytes residen en una memoria lineal, una matriz continua de bytes que admite escritura, parte de un tamaño declarado y puede crecer durante la ejecución. Una lectura o escritura fuera de su tamaño actual no alcanza nada más: provoca una trampa que detiene inmediatamente la ejecución. Una trampa no puede manejarse dentro de Wasm, solo notificarse al entorno anfitrión. El ejemplo siguiente usa el formato textual que la especificación define para que lo lean personas.

## Por qué importa

La primera razón es la velocidad. Los objetivos de diseño piden un rendimiento cercano al código nativo y un formato que una sola pasada rápida pueda decodificar, validar y compilar, tanto si el compilador trabaja durante la ejecución como si lo hace de antemano. El binario pretende ser más compacto que el texto y que el código máquina nativo, y admite procesamiento en flujo: el trabajo puede empezar antes de que llegue el último byte. Incluso mantiene la declaración de tipo de cada función en una sección distinta de su cuerpo para que los cuerpos puedan compilarse en paralelo y mientras llegan. Un equipo que ya cuenta con una biblioteca bien probada en otro lenguaje puede compilarla para el navegador en lugar de reescribirla en JavaScript.

La segunda es la portabilidad. El mismo módulo se ejecuta en cualquier procesador moderno, de escritorio o móvil, y en cualquier anfitrión que incorpore un motor: un navegador, un entorno de ejecución independiente u otro programa. La especificación no favorece ningún lenguaje, modelo de programación ni modelo de objetos concreto. El formato es, por tanto, un destino común de compilación y no el entorno de ejecución privado de un lenguaje.

La tercera es el aislamiento. Un módulo no dispone de acceso implícito al equipo donde se ejecuta. Los archivos, la red, la página y el reloj quedan fuera de su alcance salvo que el anfitrión le entregue una función para ellos como importación; el anfitrión decide exactamente qué puede tocar el código. En la web, la API web señala que Wasm puede ejecutarse donde se ejecute JavaScript, tiene esencialmente el mismo modelo de amenazas y no puede exponer más de lo que JavaScript ya podría. La versión 3.0 amplió lo que cabe dentro de ese límite: memorias direccionables con 64 bits, limitadas en la web a 16 gigabytes; varias memorias en un módulo; un recolector de basura para lenguajes que cuentan con él; y excepciones que ya no tienen que salir al anfitrión. El anuncio califica esa salida al anfitrión de no portátil e ineficiente.

## Cómo se aplica en la práctica

Este módulo en formato textual exporta una sola función que suma dos enteros de 32 bits:

```wat
(module
  (func (export "add") (param i32 i32) (result i32)
    local.get 0
    local.get 1
    i32.add))
```

El tipo de la función indica que recibe dos valores `i32` y devuelve uno. El cuerpo son tres instrucciones sobre la pila: `local.get 0` apila el primer parámetro, `local.get 1` el segundo, e `i32.add` retira ambos y apila su suma, que queda como resultado. `(export "add")` da a la función el nombre que ve el exterior. Convertido al formato binario, el archivo empieza por los cuatro bytes `0x00 0x61 0x73 0x6D`, un cero seguido de las letras asm, y después por la versión del formato binario, que sigue siendo 1.

En un navegador, la API de JavaScript lo carga así:

```js
const url = "/add.wasm";
const { instance } = await WebAssembly.instantiateStreaming(fetch(url));
instance.exports.add(2, 3); // 5
instance.exports.add(2147483647, 1); // -2147483648
```

`instantiateStreaming` compila el módulo mientras todavía llega la respuesta y resuelve la promesa con el módulo compilado y una instancia. Las exportaciones de la instancia son funciones ordinarias de JavaScript. La segunda llamada muestra qué significan los tipos: la suma de enteros en Wasm se calcula módulo
2 elevado a 32, y la API de JavaScript interpreta un resultado `i32` con signo. Por eso, una unidad más que el mayor valor positivo vuelve como el valor más negativo. No se lanza ninguna excepción. Una trampa sí la provocaría: si una función lee fuera de su memoria, la llamada termina con un `WebAssembly.RuntimeError`.

Un módulo declara lo que necesita de su anfitrión. Si contiene `(import "env" "log" (func (param i32)))`, la instanciación necesita un segundo argumento, `{ env: { log: console.log } }`, y el módulo puede llamar a `log` como a cualquiera de sus propias funciones. Si se omite el segundo argumento, la instanciación falla con un `TypeError`; si se pasa un objeto `env` sin una `log` invocable, falla con un `WebAssembly.LinkError`. En ambos casos ocurre antes de que se ejecute código del módulo. Las importaciones y exportaciones constituyen toda la frontera, con tipos declarados que incluyen números y referencias; una dirección en la memoria del módulo es un `i32`, o un `i64` para una memoria de 64 bits.

Una entrada del portafolio sobre un cliente nativo de macOS en Swift 6 describe la otra forma de reutilizar código de otro lenguaje. En ese trabajo, realizado en agosto de 2026, un núcleo de Rust se enlazó a una aplicación Swift como archivo estático y se utilizó a través de su interfaz C, que la entrada trata como el contrato. Una envoltura fina posee cada puntero y cada cadena que cruza la frontera; todo lo que devuelve la interfaz tiene una regla de propiedad. Equivocarse causa una fuga o un cierre inesperado sin aviso del compilador. Ahí no interviene Wasm, y eso hace útil la comparación: el mismo problema de una frontera estrecha entre dos lenguajes, resuelto mediante enlace nativo en lugar de una lista de importaciones y una memoria aislada.

## Dónde surgen los problemas

La promesa se rechaza antes de compilar nada. Si falta `Content-Type`, o su valor es distinto de `application/wasm` sin distinguir mayúsculas, se produce un `TypeError`. La especificación señala que no se admiten parámetros adicionales, ni siquiera un parámetro vacío como en `application/wasm;`. Un estado no satisfactorio falla igual, y también una respuesta de otro origen cuyo acceso no esté autorizado por CORS. Corrija el tipo de medio y las cabeceras del servidor. `WebAssembly.instantiate` sobre bytes obtenidos por su cuenta evita la comprobación del tipo de medio, pero pierde la compilación en flujo.

Una vista de memoria deja de funcionar. JavaScript ve la memoria de un módulo mediante `memory.buffer` y las matrices construidas sobre él. Para memoria no compartida, ese búfer tiene longitud fija de forma predeterminada. Cuando la memoria crece, la API de JavaScript desconecta ese búfer de longitud fija y lo sustituye por otro; las matrices construidas sobre el antiguo quedan desconectadas de la memoria. Ocurre tras `memory.grow()` desde JavaScript y también tras una instrucción `memory.grow` dentro del módulo, durante una llamada que parece inocua desde fuera. Vuelva a crear las vistas desde `memory.buffer` después de cualquier llamada que pueda ampliar la memoria, en lugar de conservar una durante toda la vida de la página.

Esperar que Wasm acceda por sí solo a la página. Un módulo no tiene acceso implícito a nada: cada efecto sobre la página, la red o el almacenamiento pasa por una función que JavaScript le entrega como importación. Los tipos también importan en esa frontera: un `i64` cruza como `BigInt`, no como un valor de tipo Number, y una función con un parámetro o resultado `v128` lanza un `TypeError` cada vez que JavaScript la llama. Diseñe la lista de importaciones y exportaciones como una interfaz con números sencillos y mantenga los vectores del lado de Wasm.

Confundir un entorno aislado con un programa seguro. El aislamiento protege al anfitrión frente al módulo. No protege al módulo frente a sí mismo. La especificación afirma que el aislamiento no puede impedir que un lenguaje inseguro compilado a Wasm corrompa su propia distribución de memoria dentro de la memoria lineal: un desbordamiento de búfer en código compilado sobrescribe los datos del módulo, y solo un acceso más allá del final de toda la memoria provoca una trampa. Mantenga las comprobaciones y pruebas del lenguaje de origen y trate como no fiables los datos que el módulo recibe del exterior.

Distribuir el binario sin protegerlo. El registro de `application/wasm` indica que el formato no incluye protección de integridad ni de privacidad; cuando se necesitan, deben venir de fuera, por ejemplo mediante HTTPS. Como ocurre con JavaScript, algunas formas de cargarlo y ejecutarlo están limitadas por Content Security Policy o por la política del mismo origen. Y puesto que Wasm se convierte en código máquina sobre hardware real, la especificación principal advierte de que puede ser vulnerable a ataques de canal lateral en el hardware. Sirva los módulos mediante HTTPS y controle quién puede cambiar un módulo con el mismo cuidado que quién puede cambiar un script.

## Lecturas adicionales
* WebAssembly Specification — especificación principal de la versión 3.0: estructura, validación, ejecución y formatos binario y textual.
* Introduction — definición, objetivos de diseño, alcance de cada documento y consideraciones de seguridad.
* WebAssembly JavaScript Interface — compilación e instanciación desde JavaScript, paso de valores, `Memory.grow` y las tres clases de error.
* WebAssembly Web API — `instantiateStreaming`, comprobaciones de la respuesta y registro de `application/wasm`.
* Wasm 3.0 Completed — anuncio del 17 de septiembre de 2025 y novedades de la versión 3.0.
* WebAssembly Core Specification 1.0 — Recomendación del W3C del 5 de diciembre de 2019.

=> /es/portfolio/built-a-native-macos-client-in-swift-6/ Una entrada del portafolio sobre un cliente nativo de macOS en Swift 6
=> https://webassembly.github.io/spec/core/ WebAssembly Specification
=> https://webassembly.github.io/spec/core/intro/introduction.html Introduction
=> https://webassembly.github.io/spec/js-api/ WebAssembly JavaScript Interface
=> https://webassembly.github.io/spec/web-api/ WebAssembly Web API
=> https://webassembly.org/news/2025-09-17-wasm-3.0/ Wasm 3.0 Completed
=> https://www.w3.org/TR/wasm-core-1/ WebAssembly Core Specification 1.0

=> https://engineer.company/es/glossary/webassembly/ Esta página en la web
