node:async_hooks

O módulo node:async_hooks no Azion Runtime: AsyncLocalStorage e AsyncResource em uma function e um exemplo que carrega um ID de requisição.

Última atualização

Ver como Markdown Configurar agente

O módulo node:async_hooks rastreia o ciclo de vida de recursos assíncronos, como descreve a documentação do async_hooks do Node.js. Os hooks dele são acionados em cada estágio de uma operação assíncrona, para propagação de contexto e depuração. No Azion Runtime, o módulo está disponível por meio da compatibilidade com Node.js. O uso comum dele em uma function é AsyncLocalStorage, que carrega dados do escopo da requisição, como um ID de requisição, entre chamadas assíncronas.

Em uma function com deploy feito e com azion dev, AsyncLocalStorage mantém o store dele através de um await e dentro de um callback de setTimeout, e, fora de run(), getStore() não retorna nenhum valor. AsyncResource também funciona: runInAsyncScope() executa o callback dele e retorna o valor do callback.

Exemplo

A function abaixo lê o header X-Request-Id, armazena o valor com AsyncLocalStorage e o registra em log a partir de funções que não o recebem como argumento:

JavaScript
01/**
02 * An example of using the Node.js Async Hooks API in an Azion Function.
03 * @example
04 * // Build and run locally with the Azion CLI:
05 * azion build
06 * azion dev
07 */
08import { AsyncLocalStorage } from "node:async_hooks";
09
10const requestId = new AsyncLocalStorage();
11
12function logAsyncContext(state) {
13 console.log(`${requestId.getStore()} - ${state}`);
14}
15
16function doSomething() {
17 logAsyncContext("log from sync function");
18 setTimeout(() => doSomethingElse(), 100);
19}
20
21function doSomethingElse() {
22 logAsyncContext("log from setTimeout callback");
23}
24
25/**
26 * Example of using the Node.js Async Hooks API
27 * @param {*} event
28 * @returns {Promise<Response>}
29 */
30async function main(event) {
31 const id = event.request.headers.get("X-Request-Id") ?? "unknown";
32
33 return requestId.run(id, () => {
34 doSomething();
35 logAsyncContext("log from another sync function");
36 return new Response("ok");
37 });
38}
39
40export default main;

Uma requisição com o header X-Request-Id: req-1 recebe o corpo ok. Enquanto a requisição é executada, a function registra estas linhas em log:

Texto
01req-1 - log from sync function
02req-1 - log from another sync function

Recursos relacionados

APIs do Node.js

Todos os módulos do Node.js que o Azion Runtime resolve e como cada um se comporta.

node:timers

As funções de timer, como a chamada a setTimeout que este exemplo agenda.

Use APIs do Node.js com polyfills

Como o build resolve APIs do Node.js por meio de polyfills, mostrado em um projeto JavaScript.

Handlers

O formato de handler recomendado e o aviso de obsolescência que azion build imprime para o formato export default main que este exemplo usa.