{"canonical_url":"https://engineer.company/uk/glossary/webassembly/","content_markdown":"# WebAssembly\n\n## Що це таке\n\nWebAssembly, або скорочено Wasm, — це бінарний формат виконуваного коду. Основна\nспецифікація називає його «a safe, portable, low-level code format designed for\nefficient execution and compact representation» і описує як віртуальну систему\nкоманд: команди уявного процесора, які браузер чи інше середовище спершу\nперевіряє, а потім перекладає в машинний код справжнього. Коротка форма — це\nскорочення, а не абревіатура, тому специфікація пише Wasm, а не WASM.\n\nФайл `.wasm` зазвичай є результатом роботи компілятора з якоїсь іншої мови.\nГоловна мета, як каже сама специфікація, — швидкі застосунки у вебі, але формат\nне робить жодних припущень про веб, тож може працювати й як окрема віртуальна\nмашина, і всередині інших програм. Стандарт поділено на шари відповідно до\nцього: основна специфікація визначає команди, формати, валідацію та виконання і\nне прив'язана до жодного середовища. Окремі документи визначають JavaScript API,\nщо компілює, компонує й викликає модулі, і Web API, що завантажує їх мережею.\n\nПерша версія стала рекомендацією W3C 5 грудня 2019 року. Версія 2.0, по суті\nзавершена за три роки до наступної, додала векторні команди, групові операції з\nпам'яттю, кілька значень, що повертаються, і прості типи посилань. Версію 3.0\nпроєкт оголосив чинним стандартом 17 вересня 2025 року й повідомив, що вона вже\nпрацює в більшості основних браузерів. У тому самому оголошенні Java, OCaml,\nScala, Kotlin, Scheme і Dart названо серед мов, які тепер компілюються у Wasm з\nопорою на його збирач сміття.\n\nСловник невеликий. Одиниця коду — модуль: він містить функції, таблиці, пам'ять\nі глобальні змінні, імпортує те, чого потребує, причому кожен імпорт має назву\nмодуля й назву елемента, і експортує те, що пропонує, під власними назвами.\nЧислових типів чотири: 32- і 64-бітові цілі числа та числа з рухомою комою, що\nзаписуються як `i32`, `i64`, `f32` і `f64`, а ще один 128-бітовий векторний тип\nі непрозорі посилання. Цілі числа самі не мають знака; кожна операція трактує їх\nяк знакові або беззнакові, а 32-бітове ціле слугує ще й логічним значенням.\nАдреси в пам'яті використовують `i32` або, для 64-бітової пам'яті, `i64`.\nКоманди беруть операнди з неявного стека й кладуть туди\nрезультати, а потік керування структурований: блоки, цикли й умови вкладаються\nодне в одне, і перехід може вести лише до однієї з цих конструкцій.\n\nДані з побайтовою адресацією лежать у лінійній пам'яті — суцільному масиві байтів, доступному для\nзапису, що має початковий розмір і може зростати під час роботи програми.\nЧитання чи запис поза її поточним розміром нікуди більше не дістається. Воно\nспричиняє пастку (trap), що негайно зупиняє виконання, і всередині Wasm пастку\nобробити не можна, про неї можна лише повідомити середовищу навколо. Приклад\nнижче написано в текстовому форматі, який специфікація визначає для того, щоб\nкод могли читати люди.\n\n## Чому це важливо\n\nПерша причина — швидкість. Цілі проєктування вимагають продуктивності, близької\nдо нативного коду, і формату, який можна декодувати, перевірити й скомпілювати\nза один швидкий прохід, під час виконання або заздалегідь. Бінарний формат має\nбути меншим за типові текстові та машинні формати, і його можна передавати\nпотоком: робота може початися ще до того, як надійде останній байт. Бінарний\nформат навіть зберігає оголошення типу кожної функції в іншому розділі, ніж її\nтіло, щоб тіла можна було компілювати паралельно й просто під час надходження.\nКоманда, яка вже має добре перевірену бібліотеку іншою мовою, може скомпілювати\nїї для браузера, а не переписувати на JavaScript.\n\nДруга — переносність. Той самий модуль працює на всіх сучасних архітектурах, і\nна комп'ютерах, і на мобільних пристроях, та в будь-якому середовищі, що\nвбудовує рушій: у браузері, в окремому середовищі виконання чи в іншій програмі.\nСпецифікація не віддає переваги жодній мові, моделі програмування чи об'єктній\nмоделі, тож формат є спільною ціллю компіляції, а не приватним середовищем\nоднієї мови.\n\nТретя — ізоляція. Модуль не має неявного доступу до комп'ютера, на якому працює.\nФайли, мережа, сторінка й годинник для нього недосяжні, доки середовище не\nпередасть йому функцію для них як імпорт, тож саме середовище вирішує, чого саме\nкод може торкатися. У вебі Web API зазначає, що Wasm може виконуватися скрізь,\nде й JavaScript, має по суті ту саму модель загроз і не може розкрити більше,\nніж уже може JavaScript. Версія 3.0 розширила те, що вміщується в ці межі:\nпам'ять із 64-бітовою адресацією, у вебі обмежена 16 гігабайтами, кілька блоків\nпам'яті в одному модулі, збирання сміття для мов, які на нього розраховують, і\nвинятки, яким більше не треба тікати в середовище, що оголошення називає ні\nпереносним, ні ефективним.\n\n## Як це виглядає на практиці\n\nОсь модуль у текстовому форматі з однією експортованою функцією, що додає два\n32-бітові цілі числа:\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\nТип функції каже, що вона приймає два значення `i32` і повертає одне. Тіло — це\nтри команди на стеку: `local.get 0` кладе перший параметр, `local.get 1` —\nдругий, а `i32.add` знімає обидва й кладе їхню суму, яка й лишається на стеку як\nрезультат. `(export \"add\")` дає функції назву, яку бачить зовнішній світ. У\nбінарному форматі файл починається з чотирьох байтів `0x00 0x61 0x73 0x6D`,\nтобто нуля й літер asm, а далі йде версія бінарного формату, досі перша.\n\nУ браузері модуль завантажує JavaScript API:\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` компілює модуль, поки відповідь ще надходить, і повертає\nскомпільований модуль та його екземпляр. Експорти екземпляра — звичайні функції\nJavaScript. Другий виклик показує, що означають типи: додавання цілих чисел у\nWasm іде за модулем 2 у 32-му степені, а JavaScript API читає результат `i32` як\nзнакове число, тож одиниця понад найбільше додатне значення повертається як\nнайменше від'ємне. Жодного винятку не виникає. А от пастка його спричинить: якщо\nфункція читатиме поза своєю пам'яттю, виклик завершиться помилкою\n`WebAssembly.RuntimeError`.\n\nМодуль, якому щось потрібно від середовища, так і каже. Якщо в модулі є\n`(import \"env\" \"log\" (func (param i32)))`, створенню екземпляра потрібен другий\nаргумент, `{ env: { log: console.log } }`, і модуль може викликати `log`, як\nбудь-яку власну функцію. Без другого аргументу створення екземпляра завершиться\nпомилкою `TypeError`; з об'єктом `env`, у якому немає функції `log`, — помилкою\n`WebAssembly.LinkError`, і в обох випадках раніше, ніж виконається хоч рядок\nкоду модуля. Імпорт і експорт — це вся межа з оголошеними типами, що включають числа та\nпосилання; адреса в пам'яті модуля — це `i32` або `i64` для 64-бітової пам'яті.\n\n[Сторінка портфоліо про створення нативного клієнта для macOS на Swift 6](/uk/portfolio/built-a-native-macos-client-in-swift-6/)\nописує інший спосіб повторно використати код з іншої мови. У тій роботі,\nвиконаній у серпні 2026 року, ядро на Rust скомпонували із застосунком на Swift\nяк статичний архів і викликали через його C-інтерфейс, який сторінка вважає\nконтрактом. Тонка обгортка володіє кожним вказівником і кожним рядком, що\nперетинає межу, а для всього, що повертає інтерфейс, діє правило володіння, і\nпомилка в ньому дає витік пам'яті або аварійне завершення без жодного\nпопередження компілятора. Wasm там немає, і саме тому порівняння корисне: та\nсама задача вузької межі між двома мовами, але розв'язана нативним\nкомпонуванням, а не списком імпортів і пам'яттю в пісочниці.\n\n## Де виникають проблеми\n\n**Проміс відхиляється ще до компіляції.** Відсутній `Content-Type` або будь-яке\nзначення, крім `application/wasm` без огляду на регістр, дає `TypeError`, а\nспецифікація зауважує, що додаткові параметри не дозволені, навіть порожній\n`application/wasm;`. Так само завершується статус, що не є успішним, і відповідь\nз іншого джерела, яку CORS не робить відповіддю з того самого джерела. Виправте\nтип медіа й заголовки на сервері. `WebAssembly.instantiate` з байтами, які ви\nзавантажили самі, пропускає перевірку типу медіа, але втрачає потокову\nкомпіляцію.\n\n**Подання пам'яті перестає працювати.** JavaScript бачить пам'ять модуля через\n`memory.buffer` і масиви, побудовані на ньому. Для пам'яті без спільного доступу цей\nбуфер за замовчуванням має фіксовану довжину. Коли пам'ять зростає, JavaScript\nAPI від'єднує цей буфер фіксованої довжини й замінює його новим, тож масиви на\nстарому буфері відрізано від пам'яті. Це стається після виклику `memory.grow()`\nз JavaScript, а також після команди `memory.grow` усередині модуля, під час\nвиклику, який ззовні здається безневинним. Створюйте подання з `memory.buffer`\nнаново після кожного виклику, що може збільшити пам'ять, а не тримайте одне на\nвесь час життя сторінки.\n\n**Очікування, що Wasm сам дістанеться до сторінки.** Модуль не має неявного\nдоступу ні до чого, тож будь-яка дія зі сторінкою, мережею чи сховищем іде через\nфункцію, яку JavaScript передає йому як імпорт. На тій самій межі дошкуляють і\nтипи: `i64` перетинає її як `BigInt`, а не як число, а функція з параметром чи\nрезультатом `v128` кидає `TypeError` щоразу, коли JavaScript її викликає.\nПроєктуйте список імпортів і експортів як інтерфейс із простими числами, а\nвектори тримайте на боці Wasm.\n\n**Сприйняття пісочниці як безпечної програми.** Пісочниця захищає середовище від\nмодуля. Модуль від самого себе вона не захищає. Специфікація прямо каже, що не\nможе завадити небезпечній мові, скомпільованій у Wasm, зіпсувати власне\nрозташування даних у лінійній пам'яті: переповнення буфера в скомпільованому\nкоді перезаписує власні дані модуля, а пастку спричиняє лише доступ за межі\nвсієї пам'яті. Зберігайте перевірки й тести вихідної мови та вважайте дані, які\nмодуль отримує ззовні, недовіреними.\n\n**Розповсюдження бінарного файлу без захисту.** Реєстрація типу\n`application/wasm` каже, що формат не має жодного захисту цілісності чи\nконфіденційності, і якщо такий захист потрібен, його мають забезпечити ззовні,\nнаприклад через HTTPS. Як і для JavaScript, деякі способи завантаження й\nвиконання обмежуються політикою того самого джерела або Content Security Policy.\nА оскільки Wasm перетворюється на машинний код на справжньому залізі, основна\nспецифікація попереджає, що він потенційно вразливий до атак через побічні\nканали на рівні апаратури. Віддавайте модулі через HTTPS і стежте за тим, хто\nможе змінити модуль, так само пильно, як за тим, хто може змінити скрипт.\n\n## Що почитати далі\n\n- [WebAssembly Specification](https://webassembly.github.io/spec/core/)\n  — основна специфікація версії 3.0: структура, валідація, виконання, бінарний і\n  текстовий формати.\n- [Introduction](https://webassembly.github.io/spec/core/intro/introduction.html)\n  — визначення, цілі проєктування, що охоплює кожен документ, і міркування\n  безпеки.\n- [WebAssembly JavaScript Interface](https://webassembly.github.io/spec/js-api/)\n  — компіляція й створення екземплярів із JavaScript, як значення перетинають\n  межу, `Memory.grow` і три класи помилок.\n- [WebAssembly Web API](https://webassembly.github.io/spec/web-api/)\n  — `instantiateStreaming`, перевірки відповіді та реєстрація\n  `application/wasm`.\n- [Wasm 3.0 Completed](https://webassembly.org/news/2025-09-17-wasm-3.0/)\n  — оголошення від 17 вересня 2025 року і що додає версія 3.0.\n- [WebAssembly Core Specification 1.0](https://www.w3.org/TR/wasm-core-1/)\n  — рекомендація W3C від 5 грудня 2019 року.\n\n\u003chttps://engineer.company/uk/glossary/webassembly/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Що таке Wasm і як працює модуль: стек, лінійна пам'ять, імпорт і експорт, завантаження з JavaScript і де виникають проблеми.","formats":{"gemtext":"https://engineer.company/uk/glossary/webassembly/index.gmi","gopher":"https://engineer.company/uk/glossary/webassembly/gophermap","html":"https://engineer.company/uk/glossary/webassembly/","json":"https://engineer.company/uk/glossary/webassembly/index.json","markdown":"https://engineer.company/uk/glossary/webassembly/index.md","pdf":"https://engineer.company/uk/glossary/webassembly/index.pdf"},"kind":"page","language":"uk","title":"Що таке WebAssembly?","url":"https://engineer.company/uk/glossary/webassembly/","version":1}