0Pricing
WebAssembly (WASM) for High Performance Apps · Aula

Operações assíncronas com WASM

Implemente padrões assíncronos para lidar com tarefas de longa duração em WASM sem bloquear a thread principal, usando promises e async/await.

Operações assíncronas com WASM é uma aula grátis de WebAssembly (WASM) for High Performance Apps no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de WebAssembly (WASM) for High Performance Apps, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de WebAssembly (WASM) for High Performance Apps inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

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.

Perguntas Frequentes

A aula “Operações assíncronas com WASM” é grátis?

Sim — o texto completo de “Operações assíncronas com WASM” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de WebAssembly (WASM) for High Performance Apps, atualize para CoddyKit PRO. O curso de WebAssembly (WASM) for High Performance Apps inclui 4 aulas no total.

O que vou aprender em “Operações assíncronas com WASM”?

Implemente padrões assíncronos para lidar com tarefas de longa duração em WASM sem bloquear a thread principal, usando promises e async/await. Você pratica WebAssembly (WASM) for High Performance Apps com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar WebAssembly (WASM) for High Performance Apps?

Nenhuma experiência prévia é necessária. WebAssembly (WASM) for High Performance Apps no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Operações assíncronas com WASM”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de WebAssembly (WASM) for High Performance Apps?

Sim. Cada aula de WebAssembly (WASM) for High Performance Apps inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Operações assíncronas com WASM
  2. Callbacks personalizados de JavaScript
  3. Tratamento de erros e exceções
  4. Compartilhando Memória e Matrizes Tipadas entre JS e WASM
← Voltar para WebAssembly (WASM) for High Performance Apps