[CS] WebAssembly
WebAssembly(Wasm)는 웹 브라우저를 비롯한 여러 환경에서 빠르게 실행할 수 있도록 설계된 바이너리 명령어 형식이다.
JavaScript와 마찬가지로 브라우저 내부에서 실행될 수 있지만 JavaScript 소스 코드를 직접 실행하는 것과는 구조가 다르다.
일반적으로 C/C++ 등의 언어를 WebAssembly로 컴파일한 뒤 실행하며 브라우저에서는 JavaScript를 통해 Wasm 모듈을 로드하고 사용할 수 있다.
V8에서는 JavaScript뿐만 아니라 WebAssembly 역시 직접 실행할 수 있다.
Module
Module은 Wasm 바이너리를 파싱하고 검증한 결과를 나타낸다. JavaScript에서는 WebAssembly.Module을 통해 생성할 수 있다.
1
2
3
4
5
6
const wasmCode = new Uint8Array([
0x00, 0x61, 0x73, 0x6d,
0x01, 0x00, 0x00, 0x00
]);
const module = new WebAssembly.Module(wasmCode);
여기서 wasmCode는 WebAssembly 바이너리이다.
Wasm 바이너리의 시작 부분에는 다음과 같은 Magic Number가 존재한다.
1
00 61 73 6d
위 코드는 내용이 거의 없는 최소한의 WebAssembly Module이다.
중요한 점은 Module 자체는 실행 중인 프로그램 인스턴스가 아니라는 것이다.
Module은 대략 다음과 같은 정보를 가지고 있다.
- Function 정보
- Type 정보
- Import 정보
- Export 정보
- Memory 정보
- Table 정보
실제 실행을 위해서는 Module을 기반으로 Instance를 생성해야 한다.
Instance
WebAssembly.Instance는 Module을 실제로 실행할 수 있도록 생성된 실행 인스턴스이다.
1
const instance = new WebAssembly.Instance(module);
하나의 Module로 여러 개의 INstance를 생성하는 것도 가능하다.
1
2
const instance1 = new WebAssembly.Instance(module);
const instance2 = new WebAssembly.Instance(module);
즉 module은 프로그램 구조, Instance는 실행 상태로 생각하면 편하다.
Instance에는 해당 Wasm 프로그램이 사용하는 Memory, Table, Global 등의 실행 상태가 연결될 수 있다.
Export
WebAssembly 내부에서 정의한 함수나 Memory 등을 JavaScript에서 사용하려면 Export해야한다.
예를 들어 다음과 같은 Wasm 함수가 있다.
(module
(func $add (param i32 i32) (result i32)
local.get 0
local.get 1
i32.add
)
(export "add" (func $add))
)
위 module에는 두 정수를 더하는 add 함수가 존재한다.
그리고 (export "add" (func $add)) 코드가 이 함수를 외부로 노출한다.
1
2
3
const add = instance.exports.add;
console.log(add(10, 20));
결과는 30이 나온다.
Import
반대로 WebAssembly가 외부의 함수나 객체를 사용해야 할 수도 있다.
이때 사용하는 것이 Import이다.
예를 들어 Wasm에서 외부 함수 print를 사용한다고 가정한다.
1
2
3
4
5
(module
(import "env" "print"
(func $print (param i32))
)
)
JavaScript에서는 Instance를 생성하면서 해당 함수를 전달한다.
1
2
3
4
5
6
7
8
9
const imports = {
env: {
print: function (value) {
console.log(value);
}
}
};
const instance = new WebAssembly.Instance(module, imports);
따라서 Import와 Export는 JavaScript와 Wasm 사이의 인터페이스 역할을 한다.
Memory
WebAssembly는 데이터를 저장하기 위해 Linear Memory라는 메모리 구조를 사용할 수 있다.
JavaScript에서는 다음과 같이 생성한다.
1
2
3
const memory = new WebAssembly.Memory({
initial: 1
});
여기서 initial: 1은 메모리의 초기 크기가 1 page라는 의미이다.
WebAssembly에서 한 page의 크기는 64KiB와 같다.
따라서 initial이 2라면 초기 크기는 128KiB가 된다.
Linear Memory
WebAssembly의 Memory는 하나의 연속된 바이트 배열처럼 생각할 수 있다. 
Wasm 코드에서는 메모리 주소를 offset 형태로 사용한다.
예를 들어 i32.load 또는 i32.store 같은 명령어를 통해 값을 읽고 쓸 수 있다.
JavaScript에서는 해당 Memory를 ArrayBuffer 형태로 접근할 수 있다.
1
const buffer = memory.buffer;
그리고 TypedArray를 이용하면 실제 데이터를 읽고 쓸 수 있다.
1
2
3
4
const view = new Uint8Array(memory.buffer);
view[0] = 0x41;
console.log(view[0]);
결과는 65가 나온다.
Grow
WebAssembly Memory는 실행 중 크기를 증가시킬 수도 있다.
1
memory.grow(1);
이 경우 메모리가 1 page 증가한다.
단 Memory는 자유롭게 무한정 증가하는 것이 아니라 maximum을 설정할 수도 있다.
1
2
3
4
const memory = new WebAssembly.Memory({
initial: 1,
maximum: 10
});
이 경우 최대 크기는 10 * 64KiB 가 된다.
Table
WebAssembly에는 Table이라는 객체도 존재한다.
Table은 주로 함수 등의 참조를 저장하는 배열과 비슷한 구조이다.
1
2
3
4
5
6
WebAssembly.Table
index
0 -> function A
1 -> function B
2 -> function C
특히 Wasm의 간접 함수 호출에 사용된다.
예를 들어 다음과 같은 Table을 생성할 수 있다.
1
2
3
4
const table = new WebAssembly.Table({
initial: 10,
element: "anyfunc"
});
최근 WebAssembly에서는 function reference와 관련하여 funcref라는 타입 개념이 사용된다.
Wasm 코드에서는 call_indirect 명령어를 통해 Table의 특정 엔트리에 저장된 함수를 호출할 수 있다.
Table은 C/C++에서의 함수 포인터 테이블과 비슷하다고 이해했다.
Global
WebAssembly에는 전역 값을 저장하기 위한 Global도 존재한다.
1
2
3
4
5
6
7
const global = new WebAssembly.Global(
{
value: "i32",
mutable: true
},
10
};
값은 다음과 같이 접근할 수 있다.
1
console.log(global.value);
결과는 10이 나온다.
mutable: true라면 값을 수정할 수도 있다.
1
global.value = 20;
Global에는 Wasm이 사용하는 기본 타입의 값이 저장될 수 있다.
Wasm의 기본 타입
WebAssembly에서는 JavaScript보다 훨씬 명확한 타입을 사용한다. 대표적인 숫자 타입은 다음과 같다.
1
2
3
4
i32
i64
f32
f64
각각
- i32 -> 32-bit Integer
- i64 -> 64-bit Integer
- f32 -> 32-bit Floating Point
- f64 -> 64-bit Floating Point
를 의미한다.
예를 들어
(func (param i32 i32) (result i32))
라면
i32 두 개를 입력 받아서 i32 하나를 반환하는 함수인 것이다.
JavaScript처럼 실행 중에 값의 타입이 자유럽게 변하는 구조와는 다르다.
Wasm Function
WebAssembly의 함수는 다음과 같이 정의할 수 있다.
1
2
3
4
5
6
7
8
9
(func $add
(param $a i32)
(param $b i32)
(result i32)
local.get $a
local.get $b
i32.add
)
동작은 a와 b를 i32.add로 result를 내는 함수이다.
Wasm은 Stack Machine 형태의 명령어 모델을 사용한다. 이러한 명령들은 나중에 V8의 Wasm 컴파일러에 의해 실제 머신 코드로 변환된다.
