مرجع واجهة node:async_hooks

يوفر ⁦Elide⁩ ‏⁦AsyncLocalStorage⁩ و⁦AsyncResource⁩ و⁦createHook⁩ و⁦executionAsyncId⁩ و⁦triggerAsyncId⁩ و⁦executionAsyncResource⁩ و ⁦asyncWrapProviders⁩.

يدعم ⁦AsyncLocalStorage⁩ التوابع ⁦run⁩ و⁦exit⁩ و⁦getStore⁩ و⁦enterWith⁩ و⁦disable⁩ و⁦snapshot⁩ و⁦bind⁩. وانتشار السياق جزئي: فالشيفرة المتزامنة والمؤقت المُنشأ داخل ⁦run⁩ يمكنهما رؤية المخزن، بينما لا يمكن ذلك لاستكمال ⁦Promise⁩.

import { AsyncLocalStorage } from "node:async_hooks";

const storage = new AsyncLocalStorage();
storage.run("request", () => {
  console.log(storage.getStore()); // request

  Promise.resolve().then(() => {
    console.log(storage.getStore()); // undefined
  });
});

يعيد ⁦createHook()⁩ كائنًا يتضمن ⁦enable()⁩ و⁦disable()⁩، لكن ⁦Elide⁩ لا يوفر دورة حياة الموارد غير المتزامنة الكاملة في ⁦Node⁩. والمكتبات التي تتطلب السياق عبر ⁦await⁩ لا ينبغي أن تعتمد على هذا التنفيذ.

Reference

Status: Partial · 36 of 45 suite tests pass (80.0%) · since 1.1.0

Exports

Export	Kind	Status	Notes
`async_hooks`	module	Partial	hooks fire for timers/immediates/promises but not yet for TCP/HTTP/TLS native resources
`createHook()`	function	Full	Creates a new AsyncHook instance
`executionAsyncId()`	function	Full	Returns the asyncId of the current execution context
`triggerAsyncId()`	function	Full	Returns the ID of the resource responsible for calling the callback that is currently being executed
`AsyncLocalStorage`	property	Full	The AsyncLocalStorage class
`AsyncResource`	property	Full	The AsyncResource class

Tests: node-api node:async-hooks: 36 pass, 8 fail, 1 error, 3 skipped. Failing: test-async-hooks-destroy-on-gc.js, test-async-hooks-enable-recursive.js, test-async-hooks-fatal-error.js, test-async-hooks-http-parser-destroy.js, test-async-hooks-top-level-clearimmediate.js, test-async-local-storage-http-agent.js, test-async-local-storage-http-multiclients.js, test-async-local-storage-http-parser-leak.js, and 1 more.