{"canonical_url":"https://engineer.company/nb/glossary/webassembly/","content_markdown":"# WebAssembly\n\n## Hva det er\n\nWebAssembly, som regel forkortet til Wasm, er et binært format for kjørbar kode.\nKjernespesifikasjonen kaller det «a safe, portable, low-level code format\ndesigned for efficient execution and compact representation» og beskriver det\nsom et virtuelt instruksjonssett: instruksjonene til en tenkt prosessor, som en\nnettleser eller en annen vert først kontrollerer og deretter oversetter til\nmaskinkode for den virkelige. Kortformen er en sammentrekning og ikke et\nakronym, og derfor skriver spesifikasjonen Wasm og ikke WASM.\n\nEn `.wasm`-fil er som regel resultatet av en kompilator for et annet språk.\nHovedmålet er ifølge spesifikasjonen selv raske programmer på nettet, men\nformatet gjør ingen antakelser om nettet, så det kan også kjøre som en\nfrittstående virtuell maskin eller inne i andre programmer. Standarden er\nlagdelt deretter: kjernespesifikasjonen definerer instruksjonene, formatene,\nvalideringen og kjøringen og ikke noe bestemt miljø. Egne dokumenter definerer\nJavaScript-API-et, som kompilerer, lenker og kaller moduler, og web-API-et, som\nhenter dem over nettverket.\n\nDen første versjonen ble en W3C-anbefaling 5. desember 2019. Versjon 2.0, som i\nhovedsak var ferdig tre år før etterfølgeren, la til vektorinstruksjoner,\nmasseoperasjoner på minnet, flere returverdier og enkle referansetyper.\nProsjektet kunngjorde 17. september 2025 at versjon 3.0 nå er den gjeldende\nstandarden, og at den allerede var med i de fleste store nettlesere. Den samme\nkunngjøringen nevner Java, OCaml, Scala, Kotlin, Scheme og Dart blant språkene\nsom nå kompileres til Wasm ved hjelp av søppeltømmingen.\n\nOrdforrådet er lite. Kodens enhet er en modul: den inneholder funksjoner,\ntabeller, minner og globale variabler, importerer det den trenger, hver import\nnavngitt med et modulnavn og et elementnavn, og eksporterer det den tilbyr,\nunder egne navn. Det finnes fire talltyper, 32- og 64-bits heltall og flyttall,\nskrevet `i32`, `i64`, `f32` og `f64`, i tillegg til én 128-bits vektortype og\nugjennomsiktige referanser. Heltallene har ikke noe fortegn i seg selv; hver\noperasjon leser dem enten med eller uten fortegn, og et 32-bits heltall fungerer\nogså som boolsk verdi. Minneadresser bruker `i32` eller, for et 64-bits minne,\n`i64`. Instruksjonene henter operandene sine\nfra en implisitt stakk og legger resultatene tilbake på den, og kontrollflyten\ner strukturert: blokker, løkker og betingelser ligger inni hverandre, og et hopp\nkan bare gå til en av dem.\n\nByteadresserte data ligger i et lineært minne, en sammenhengende, skrivbar rekke av byte som\nstarter i en oppgitt størrelse og kan vokse mens programmet kjører. En lesing\neller skriving utenfor den gjeldende størrelsen når ikke noe annet. Den utløser\nen trap, som stopper kjøringen umiddelbart, og en trap kan ikke håndteres inne i\nWasm, bare meldes videre til verten rundt. Eksempelet nedenfor bruker\ntekstformatet som spesifikasjonen definerer for at mennesker skal kunne lese\ndet.\n\n## Hvorfor det er viktig\n\nFart er den første grunnen. Designmålene krever ytelse nær native kode og et\nformat som kan dekodes, valideres og kompileres i én rask gjennomgang, just in\ntime eller på forhånd. Binærformatet skal være mindre enn typiske tekst- og\nmaskinkodeformater, og det kan strømmes: arbeidet kan begynne før den siste\nbyten har kommet fram. Binærformatet holder til og med hver funksjons\ntypedeklarasjon i en annen seksjon enn kroppen, slik at kroppene kan kompileres\nparallelt og mens de strømmer inn. Et team som allerede har et godt testet\nbibliotek i et annet språk, kan kompilere det for nettleseren i stedet for å\nskrive det om i JavaScript.\n\nPortabilitet er den andre. Den samme modulen kjører på alle moderne\narkitekturer, på datamaskiner så vel som mobile enheter, og i enhver vert som\nbygger inn en motor: en nettleser, et frittstående kjøremiljø eller et annet\nprogram. Spesifikasjonen favoriserer ikke noe bestemt språk, noen bestemt\nprogrammeringsmodell eller noen bestemt objektmodell, så formatet er et felles\nmål og ikke ett språks private kjøremiljø.\n\nAvgrensning er den tredje. En modul har ingen omgivende tilgang til datamaskinen\nden kjører på. Filer, nettverket, siden og klokken er utenfor rekkevidde med\nmindre verten gir den en funksjon for dem som import, så det er verten som\nbestemmer nøyaktig hva koden får røre. På nettet påpeker web-API-et at Wasm kan\nkjøre overalt der JavaScript kan, har i hovedsak den samme trusselmodellen og\nikke kan avsløre mer enn JavaScript allerede kunne. Versjon 3.0 utvidet hva som\nfår plass innenfor den grensen: minner som adresseres med 64 bit, på nettet\nbegrenset til 16 gigabyte, flere minner i én modul, søppeltømming for språk som\nforventer det, og unntak som ikke lenger må rømme ut til verten, noe\nkunngjøringen kaller verken portabelt eller effektivt.\n\n## Slik ser det ut i praksis\n\nHer er en modul i tekstformatet med én eksportert funksjon som legger sammen to\n32-bits heltall:\n\n```wat\n(module\n  (func (export \"add\") (param i32 i32) (result i32)\n    local.get 0\n    local.get 1\n    i32.add))\n```\n\nFunksjonens type sier at den tar to `i32`-verdier og returnerer én. Kroppen er\ntre instruksjoner på stakken: `local.get 0` legger på den første parameteren,\n`local.get 1` den andre, og `i32.add` tar av begge og legger på summen, som blir\nliggende som resultatet. `(export \"add\")` gir funksjonen navnet omverdenen ser.\nOversatt til binærformatet begynner filen med de fire bytene\n`0x00 0x61 0x73 0x6D`, en null fulgt av bokstavene asm, og deretter\nbinærformatets versjon, som fortsatt er 1.\n\nI en nettleser laster JavaScript-API-et den inn:\n\n```js\nconst url = \"/add.wasm\";\nconst { instance } = await WebAssembly.instantiateStreaming(fetch(url));\ninstance.exports.add(2, 3); // 5\ninstance.exports.add(2147483647, 1); // -2147483648\n```\n\n`instantiateStreaming` kompilerer modulen mens svaret fortsatt er på vei, og gir\ntilbake den kompilerte modulen og en instans av den. Instansens eksporter er\nvanlige JavaScript-funksjoner. Det andre kallet viser hva typene betyr:\nheltallsaddisjon i Wasm går rundt modulo 2 i 32. potens, og JavaScript-API-et\nleser et `i32`-resultat som et tall med fortegn, så én mer enn den største\npositive verdien kommer tilbake som den mest negative. Ingenting blir kastet.\nDet blir det derimot ved en trap: leser en funksjon utenfor minnet sitt, ender\nkallet i en `WebAssembly.RuntimeError`.\n\nEn modul som trenger noe fra verten sin, sier fra. Med\n`(import \"env\" \"log\" (func (param i32)))` i modulen trenger instansieringen et\nandre argument, `{ env: { log: console.log } }`, og modulen kan kalle `log` som\nen av sine egne funksjoner. Utelat det andre argumentet, så feiler\ninstansieringen med en `TypeError`; gi et `env`-objekt uten en kallbar `log`, så\nfeiler den med en `WebAssembly.LinkError`, i begge tilfeller før noe av modulens\nkode har kjørt. Import og eksport er hele grensesnittet, med deklarerte typer som omfatter\ntall og referanser; en adresse i modulens minne er en `i32`, eller en `i64` for\net 64-bits minne.\n\n[En porteføljeside om å bygge en native macOS-klient i Swift 6](/nb/portfolio/built-a-native-macos-client-in-swift-6/)\nbeskriver den andre måten å gjenbruke kode fra et annet språk på. I det\narbeidet, som ble gjort i august 2026, ble en Rust-kjerne lenket inn i en\nSwift-app som et statisk arkiv og nådd gjennom C-grensesnittet sitt, som siden\nbehandler som kontrakten. En tynn wrapper eier hver peker og hver streng som\nkrysser grensen, og alt grensesnittet returnerer, har en eierskapsregel, der en\nfeil gir en lekkasje eller en krasj uten noen kompilatoradvarsel. Det er ingen\nWasm med der, og det er nettopp det som gjør sammenligningen nyttig: det samme\nproblemet med en smal grense mellom to språk, løst med native lenking i stedet\nfor en importliste og et minne i en sandkasse.\n\n## Hvor det går galt\n\n**Promiset avvises før noe blir kompilert.** En manglende `Content-Type`, eller\nen hvilken som helst annen verdi enn `application/wasm` uavhengig av store og\nsmå bokstaver, feiler med en `TypeError`, og spesifikasjonen påpeker at ekstra\nparametere ikke er tillatt, heller ikke en tom `application/wasm;`. En status\nsom ikke er ok, feiler på samme måte, og det gjør også et svar fra en annen\nopprinnelse når CORS ikke gjør det til samme opprinnelse. Rett opp serverens\nmedietype og headere. `WebAssembly.instantiate` på byte du har hentet selv,\nhopper over kontrollen av medietypen, men mister den strømmede kompileringen.\n\n**En visning av minnet slutter å virke.** JavaScript ser en moduls minne gjennom\n`memory.buffer` og arrayene som er bygd på den. For minne som ikke er delt,\nhar bufferen som standard fast lengde. Når minnet vokser, kobler\nJavaScript-API-et fra den bufferen med fast lengde og erstatter den med en ny, så\narrayer bygd på den gamle bufferen er koblet fra minnet. Det skjer etter\n`memory.grow()` kalt fra JavaScript og også etter en `memory.grow`-instruksjon\ninne i modulen, under et kall som ser harmløst ut utenfra. Lag visninger fra\n`memory.buffer` på nytt etter hvert kall som kan få minnet til å vokse, i stedet\nfor å beholde én så lenge siden lever.\n\n**Å forvente at Wasm når ut til siden på egen hånd.** En modul har ingen\nomgivende tilgang til noe, så enhver virkning på siden, nettverket eller\nlagringen går gjennom en funksjon som JavaScript gir den som import. Typene\nbiter ved den samme grensen: en `i64` krysser som en `BigInt`, ikke som et tall,\nog en funksjon med en `v128`-parameter eller -returverdi kaster en `TypeError`\nhver gang JavaScript kaller den. Utform import- og eksportlisten som et\ngrensesnitt med enkle tall på, og hold vektorene på Wasm-siden.\n\n**Å ta sandkassen for et trygt program.** Sandkassen beskytter verten mot\nmodulen. Den beskytter ikke modulen mot seg selv. Spesifikasjonen slår fast at\nden ikke kan hindre et utrygt språk kompilert til Wasm i å ødelegge sitt eget\nminneoppsett inne i det lineære minnet: et bufferoverløp i kompilert kode\noverskriver modulens egne data, og bare en tilgang forbi slutten av hele minnet\nutløser en trap. Behold kildespråkets egne kontroller og tester, og behandle\ndata modulen får utenfra, som upålitelige.\n\n**Å sende ut binærfilen uten å beskytte den.** Registreringen av\n`application/wasm` sier at formatet ikke har noen beskyttelse av integritet\neller konfidensialitet, og at slik beskyttelse, der den trengs, må komme utenfra, for\neksempel gjennom HTTPS. Som med JavaScript er noen måter å laste inn og kjøre\nden på begrenset gjennom same-origin-policyen eller Content Security Policy. Og\nfordi Wasm blir maskinkode på ekte maskinvare, advarer kjernespesifikasjonen om\nat det potensielt er sårbart for sidekanalangrep på maskinvarenivå. Server\nmoduler over HTTPS, og pass på hvem som får endre en modul, like nøye som på\nhvem som får endre et skript.\n\n## Les mer\n\n- [WebAssembly Specification](https://webassembly.github.io/spec/core/)\n  — kjernespesifikasjonen for versjon 3.0: struktur, validering, kjøring og\n  binær- og tekstformatet.\n- [Introduction](https://webassembly.github.io/spec/core/intro/introduction.html)\n  — definisjonen, designmålene, hva hvert dokument dekker, og\n  sikkerhetshensynene.\n- [WebAssembly JavaScript Interface](https://webassembly.github.io/spec/js-api/)\n  — kompilering og instansiering fra JavaScript, hvordan verdier krysser\n  grensen, `Memory.grow` og de tre feilklassene.\n- [WebAssembly Web API](https://webassembly.github.io/spec/web-api/)\n  — `instantiateStreaming`, kontrollene av svaret og registreringen av\n  `application/wasm`.\n- [Wasm 3.0 Completed](https://webassembly.org/news/2025-09-17-wasm-3.0/)\n  — kunngjøringen fra 17. september 2025 og hva versjon 3.0 legger til.\n- [WebAssembly Core Specification 1.0](https://www.w3.org/TR/wasm-core-1/)\n  — W3C-anbefalingen fra 5. desember 2019.\n\n\u003chttps://engineer.company/nb/glossary/webassembly/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hva Wasm er, og hvordan en modul virker: stakken, lineært minne, import og eksport, innlasting fra JavaScript, og hvor det går galt.","formats":{"gemtext":"https://engineer.company/nb/glossary/webassembly/index.gmi","gopher":"https://engineer.company/nb/glossary/webassembly/gophermap","html":"https://engineer.company/nb/glossary/webassembly/","json":"https://engineer.company/nb/glossary/webassembly/index.json","markdown":"https://engineer.company/nb/glossary/webassembly/index.md","pdf":"https://engineer.company/nb/glossary/webassembly/index.pdf"},"kind":"page","language":"nb","title":"Hva er WebAssembly?","url":"https://engineer.company/nb/glossary/webassembly/","version":1}