WebAssembly (WASM) for High Performance Apps · Leçon

Opérations asynchrones avec WASM

Implémentez des modèles asynchrones pour gérer les tâches longues dans WASM sans bloquer le thread principal, à l’aide de promesses et de async/await.

Opérations asynchrones avec WASM est une leçon WebAssembly (WASM) for High Performance Apps gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage WebAssembly (WASM) for High Performance Apps, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours WebAssembly (WASM) for High Performance Apps comprend 4 leçons au total.

Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.

Why Asynchronous WASM?

When a WebAssembly module performs a complex calculation or a long task, it can freeze your web page. This is because JavaScript is single-threaded, and most direct WASM calls are synchronous.

Asynchronous WASM patterns allow these tasks to run without completely blocking the main browser thread, keeping your UI responsive.

WASM's Synchronous Nature

When JavaScript calls an exported WASM function, that function executes entirely before JavaScript regains control. If the WASM function takes a long time, the browser's main thread will be blocked.

This means no UI updates, no user input processing, making the page appear frozen. True parallel execution for WASM often involves Web Workers, which is covered in another lesson.

Strategy: Breaking into Chunks

To prevent blocking the main thread, we can break a long-running WASM task into smaller, manageable chunks. Instead of one huge, blocking WASM call, we make many small ones.

Between each small WASM call, JavaScript can yield control back to the browser's event loop. This allows the UI to update and remain responsive.

WASM Function for a Chunk

Here's a Rust function that represents one "chunk" of work. It takes a starting value and performs a small number of calculations. In a real application, this could process a part of an image or a segment of data.

pub extern "C" fn process_chunk(start_val: u32, iterations: u32) -> u32 {
    let mut sum = start_val;
    for i in 0..iterations {
        sum = sum.wrapping_add(i); // Simulate work, prevent overflow
    }
    sum
}

Promises in JavaScript

To handle asynchronous operations, JavaScript uses Promises. A Promise represents the eventual completion (or failure) of an asynchronous operation and its resulting value.

Pending: Initial state, neither fulfilled nor rejected.
Fulfilled: Operation completed successfully.
Rejected: Operation failed.

We use .then() for success and .catch() for errors.

Simplifying with async/await

async/await is syntactic sugar built on Promises, making asynchronous code look and behave more like synchronous code, improving readability. It's built on Promises.

An async function always returns a Promise.
The await keyword can only be used inside an async function. It pauses the execution until the Promise settles, allowing other tasks to run.

This is crucial for orchestrating our WASM chunks.

Making WASM Calls Yield

We can create a JavaScript utility function that wraps a synchronous WASM call in a Promise. By using setTimeout(..., 0), we tell the browser to execute the WASM call after the current event loop cycle finishes.

This effectively "yields" control back to the browser, allowing it to update the UI before the next WASM chunk runs.

function callWasmAsync(wasmExports, funcName, ...args) {
  return new Promise(resolve => {
    setTimeout(() => {
      const result = wasmExports[funcName](...args);
      resolve(result);
    }, 0); // Yield control to the event loop
  });
}

Full Async WASM Example

Here's a complete, runnable example demonstrating how to manage a long-running WASM task asynchronously using chunking and JavaScript's async/await.

Notice how `setTimeout(0)` around the WASM call allows the browser to breathe between chunks.

// main.js
// Assume wasm_module.wasm (containing process_chunk) is loaded.
// For this runnable example, we'll simulate the WASM function.

// This simulates our WASM module's process_chunk function
function simulateWasmProcessChunk(start_val, iterations) {
    let sum = start_val;
    for (let i = 0; i < iterations; i++) {
        sum = (sum + i) % 10000; // Simplified calculation
    }
    return sum;
}

// Utility to call a synchronous task asynchronously
function callSyncTaskAsync(taskFunc, ...args) {
  return new Promise(resolve => {
    setTimeout(() => {
      const result = taskFunc(...args);
      resolve(result);
    }, 0); // Yield control to the event loop
  });
}

async function performLongTask() {
  console.log("Starting async task...");
  let currentSum = 0;
  const totalChunks = 5;
  const iterationsPerChunk = 10_000_000; // Simulate heavy work

  for (let i = 0; i < totalChunks; i++) {
    // Call the simulated WASM chunk asynchronously
    currentSum = await callSyncTaskAsync(
      simulateWasmProcessChunk,
      currentSum,
      iterationsPerChunk
    );
    console.log(`Chunk ${i + 1} done. Current sum: ${currentSum}`);
  }
  console.log("Async task finished. Final sum:", currentSum);
  return currentSum;
}

performLongTask();

Handling Errors Asynchronously

Just like any asynchronous operation, you should handle potential errors. If a WASM chunk call fails (e.g., due to invalid input or memory issues), the Promise will reject.

You can use try...catch with async/await or .catch() with Promises to gracefully handle these situations in your JavaScript code.

Async WASM Check

Consider a WebAssembly function heavy_calc() that takes 5 seconds to run. If you call it directly from JavaScript's main thread, what is the primary consequence?

Recap: Async WASM Patterns

We've learned how to handle long-running WASM tasks asynchronously on the main thread without using Web Workers. Key takeaways:

WASM functions are synchronous when called from JavaScript.
Break long tasks into smaller "chunks."
Use JavaScript Promises and async/await to orchestrate these chunks.
Yield control to the browser's event loop (e.g., with setTimeout(0)) between chunk calls to keep the UI responsive.

This pattern is crucial for maintaining a smooth user experience in complex web applications.

Questions Fréquemment Posées

La leçon « Opérations asynchrones avec WASM » est-elle gratuite ?

Oui — le texte complet de « Opérations asynchrones avec WASM » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours WebAssembly (WASM) for High Performance Apps, passe à CoddyKit PRO. Le cours WebAssembly (WASM) for High Performance Apps comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Opérations asynchrones avec WASM » ?

Implémentez des modèles asynchrones pour gérer les tâches longues dans WASM sans bloquer le thread principal, à l’aide de promesses et de async/await. Tu pratiques WebAssembly (WASM) for High Performance Apps avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer WebAssembly (WASM) for High Performance Apps ?

Aucune expérience préalable n'est requise. WebAssembly (WASM) for High Performance Apps sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.

Combien de temps prend la leçon « Opérations asynchrones avec WASM » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon WebAssembly (WASM) for High Performance Apps ?

Oui. Chaque leçon WebAssembly (WASM) for High Performance Apps inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

Opérations asynchrones avec WASM
Rappels JavaScript personnalisés
Gestion des erreurs et exceptions
Partager la mémoire et les tableaux typés entre JS et WASM

← Retour à WebAssembly (WASM) for High Performance Apps