feat: add asyncLocalStorage option for external AsyncLocalStorage inj… #231
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…ection
Add an asyncLocalStorage plugin option to allow injecting an external
AsyncLocalStorage instance. This enables sharing a single AsyncLocalStorage
across multiple request sources in applications that handle requests from
various origins.
Use cases:
- Fastify HTTP requests
- Queue consumers
- Scheduled tasks and timers
- Other HTTP servers or frameworks
Previously, the plugin created its own AsyncLocalStorage instance, making it
difficult to maintain a unified request context across different entry points.
By providing the asyncLocalStorage option, users can now create a central
AsyncLocalStorage instance and share it across all request handlers, without
coupling non-HTTP code to Fastify.
Usage:
```
const sharedALS = new AsyncLocalStorage()
app.register(fastifyRequestContext, {
asyncLocalStorage: sharedALS
})
```
Breaking change: None.
* The plugin maintains backward compatibility by using
a default AsyncLocalStorage instance when the setter is not called.
* Exported asyncLocalStorage is untouched.
4 tasks
kibertoad
reviewed
Oct 28, 2025
| } | ||
| } | ||
|
|
||
| const requestContext = createRequestContext(asyncLocalStorage) |
Member
There was a problem hiding this comment.
is this needed? we create it later again
Eomm
reviewed
Oct 28, 2025
Member
Eomm
left a comment
Eomm
left a comment
There was a problem hiding this comment.
Good feature
I'm wondering if this feature is still needed:
https://github.com/fastify/fastify-request-context?tab=readme-ov-file#usage-outside-of-a-request
because it may creates some headache 🤔
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
…ection
Add an asyncLocalStorage plugin option to allow injecting an external AsyncLocalStorage instance. This enables sharing a single AsyncLocalStorage across multiple request sources in applications that handle requests from various origins.
Use cases:
Previously, the plugin created its own AsyncLocalStorage instance, making it difficult to maintain a unified request context across different entry points. By providing the asyncLocalStorage option, users can now create a central AsyncLocalStorage instance and share it across all request handlers, without coupling non-HTTP code to Fastify.
Usage:
Breaking change: None.
Checklist
npm run test && npm run benchmark --if-presentand the Code of conduct