Skip to main content

Web Assembly avec JavaScript et AssemblyScript

Il est possible aujourd'hui de faire du code qui sera compilé en WebAssembly de plusieurs manières.

Les deux manières les plus évidentes sont :

  • Coder dans un langage bas niveau existant (Go, Rust, C++, etc.) pour ensuite générer un binaire (wasm) à l'aide d'outils spécifiques à chaque langage.
  • Utiliser le langage « texte » du WebAssembly (wat) pour le compiler directement en binaire (wasm).

Nous allons aborder une approche intermédiaire, car nous allons utiliser AssemblyScript, un langage basé sur TypeScript conçu pour être compilé en WebAssembly.

image.png

Présentation

L'AssemblyScript est un langage de programmation open source et communautaire qui offre une optimisation pour WebAssembly. Il est de typage fort et présente de nombreuses similitudes avec le TypeScript, ce qui en fait un outil très intuitif sans avoir besoin de maîtriser un nouveau langage de programmation.

image.png

AssemblyScript respecte les spécifications du WebAssembly et se base sur binaryen, un compilateur rapide et performant en WebAssembly codé en C++.

Il ne faut pas oublier que JavaScript demeure indispensable dans un navigateur, car même le WebAssembly a besoin de lui pour interagir.

Compatibilité

L'AssemblyScript est compatible avec la plupart des navigateurs, mais aussi avec Node.js, Wasmtime et Wasmer.

Premier projet

Compilation

Il faut bien comprendre que lors de la compilation, l’AssemblyScript ne se compile pas directement en wasm. Il faut plutôt le voir comme une transpilation en code wat (similaire à la commande tsc, qui transpile le TypeScript en JavaScript), qui est ensuite compilé en wasm.

Options de compilations

Les options de compilation sont variées et peuvent se passer soit en argument de la commande de compilation (asc), soit dans un fichier asconfig.json à la racine du projet.

Les principales options de compilation sont les suivantes :

Optimisation :

  • --optimizeLevel
    • Niveau d’optimisation du code (0-3), indique le niveau d’optimisation du code (au détriment de la taille du binaire), 3 étant le niveau d’optimisation le plus haut.
  • --shrinkLevel
    • Indique à quel point le compilateur va tenter de réduire la taille du binaire (0-2).
    • ⚠️ Il et déconseillé de mettre une valeur haute à ce paramètre si vous avez également mis des options d’optimisation du code.

Sortie :

  • --outFile
    • Chemin de sortie du fichier wasm
  • --textFile
    • Chemin de sortie du fichier wat

Débogage :

  • --debug
    • Ajoute des informations de debug dans la version compilée (peut entrainer une réduction des performances)

Fichier de configuration

Les options mentionnées ci-dessus peuvent être spécifiées directement dans le fichier asconfig.json de la façon suivante :

Back to top