WebAssembly.Table()

WebAssembly.Table() 생성자는 지정된 크기 및 요소 유형의 새 Table 객체를 만듭니다.

이것은 자바 스크립트 래퍼 객체로, 함수 참조를 저장하는 WebAssembly 테이블을 나타내는 배열과 같은 구조입니다. JavaScript 또는 WebAssembly 코드로 작성된 테이블은 JavaScript 및 WebAssembly에서 액세스 및 변경할 수 있습니다.

참고: 테이블은 현재 function references만 저장할 수 있지만 나중에 확장 될 수 있습니다.

Syntax

var myTable = new WebAssembly.Table(tableDescriptor);

Parameters

tableDescriptor

다음 멤버를 포함 할 수있는 객체입니다:_ element _ : 테이블에 저장 될 값 유형을 나타내는 문자열. 현재로서는 "anyfunc"(함수) 값만있을 수 있습니다.

initial

WebAssembly 테이블의 초기 요소 수입니다.

maximum Optional

WebAssembly 테이블의 최대 증가 요소 수입니다.

Exceptions

  • tableDescriptor가 object 유형이 아닌 경우 TypeError가 발생합니다.
  • maximum이 지정되고 initial보다 작은 경우 RangeError가 발생합니다.

Table instances

모든 Table 인스턴스는 Table()생성자의 prototype object (en-US)에서 상속받습니다.이 인스턴스는 모든 Table 인스턴스에 적용되도록 수정할 수 있습니다.

Instance properties

Table.prototype.constructor

이 객체의 인스턴스를 생성 한 함수를 돌려줍니다. 기본적으로 이것은 WebAssembly.Table() 생성자입니다.

Table.prototype.length (en-US)

테이블의 길이, 즉 요소의 수를 돌려줍니다.

Instance methods

Table.prototype.get() (en-US)

접근 자 함수 - 주어진 색인에 저장된 요소를 가져옵니다.

Table.prototype.grow() (en-US)

지정된 요소 수만큼 Table 인스턴스의 크기를 늘립니다.

Table.prototype.set() (en-US)

지정된 인덱스에 격납되어있는 요소를, 지정된 값으로 설정합니다.

Examples

다음 예제 (table2.html source codelive version 참조)는 초기 크기가 2인 새 WebAssembly Table 인스턴스를 만듭니다. 그런 다음 두 개의 인덱스 (표 Table.prototype.get ()를 통해 검색하여 테이블의 길이와 내용을 인쇄합니다. 길이가 2이고 null이 두개라고 출력됩니다.

var tbl = new WebAssembly.Table({initial:2, element:"anyfunc"});
console.log(tbl.length);  // "2"
console.log(tbl.get(0));  // "null"
console.log(tbl.get(1));  // "null"

그런 다음 테이블을 포함한 importObj를 만듭니다.

var importObj = {
  js: {
    tbl:tbl
  }
};

마지막으로 WebAssembly.instantiateStreaming () 메소드를 사용하여 wasm 모듈 (table2.wasm)을 로드하고 인스턴스화합니다. table2.wasm 모듈에는 두 개의 함수 (하나는 42를 반환하고 다른 하나는 83을 반환하는 함수)가 들어 있고 가져온 테이블의 요소 0과 1에 둘 다 저장합니다 (text representation 참조). 인스턴스화 후에도 테이블의 길이는 여전히 2이지만 JS에 호출 할 수있는 호출 가능한 Exported WebAssembly Functions가 요소에 포함됩니다.

WebAssembly.instantiateStreaming(fetch('table2.wasm'), importObject)
.then(function(obj) {
  console.log(tbl.length);
  console.log(tbl.get(0)());
  console.log(tbl.get(1)());
});

액세서의 끝 부분에 두 번째 함수 호출 연산자를 포함시켜 실제로 참조 된 함수를 호출하고 그 안에 저장된 값을 기록해야합니다 (예 : get(0) 대신 get(0)()).

이 예제는 자바 스크립트에서 테이블을 만들고 액세스하고 있지만 wasm 인스턴스 내부에서도 같은 테이블을 볼 수 있고 호출 할 수 있음을 보여줍니다.

Specifications

Specification
WebAssembly JavaScript Interface: Exception Handling
# tables

Browser compatibility

BCD tables only load in the browser

See also