Stratal API Reference
    Preparing search index...

    Class RequestContextStore

    Request context store using AsyncLocalStorage

    Stores and propagates request container across async operations without manual context passing. This enables transparent access to request-scoped services from any part of the application during request handling.

    Cloudflare Workers Compatibility:

    • Requires nodejs_als compatibility flag in wrangler.jsonc
    • Uses V8's SetContinuationPreservedEmbedderData API (efficient)
    • Performance overhead: ~3-4% in typical scenarios

    Thread Safety:

    • Singleton instance shared across application
    • Each request gets isolated storage context
    • No context leakage between concurrent requests
    // In router middleware
    const store = RequestContextStore.getInstance()
    await store.run(requestContainer, async () => {
      // All async operations within this callback have access to requestContainer
      await handleRequest()
    })

    // In service (anywhere in the call stack)
    const container = RequestContextStore.getInstance().getRequestContainer()
    if (container) {
      // We're in request context
      const service = container.resolve(TOKEN)
    }
    Index

    Methods

    getRequestContainer hasRequestContext run getInstance resetInstance

    Methods

    • Get current request container

      Returns the container for the current async context, or undefined if not in request context.

      Use Cases:

      • Request-scoped services resolving from request container
      • Services needing conditional logic based on context availability
      • Debugging/logging request-specific information

      Returns DependencyContainer | undefined

      Request container if in request context, undefined otherwise

      Use container instead

      const container = store.getRequestContainer()
      if (container) {
        // Safe to resolve request-scoped services
        const i18n = container.resolve(I18N_TOKENS.I18nService)
      } else {
        // Not in request context - use fallback
        console.log('No request context available')
      }

    • Check if currently in request context

      Convenience method for conditional logic based on context availability.

      Returns boolean

      true if in request context, false otherwise

      if (store.hasRequestContext()) {
        // Use request-specific data
        const locale = getLocaleFromContext()
      } else {
        // Use default
        const locale = 'en'
      }

    • Run callback within request context

      Container is automatically available to all async operations within the callback, including nested function calls, promises, timers, and queue handlers.

      Type Parameters

      • T

      Parameters

      • container: DependencyContainer

        Request-scoped dependency container

      • callback: () => T

        Async operation to run with context

      Returns T

      Result of callback execution

      const result = await store.run(requestContainer, async () => {
        // Context automatically propagates to nested calls
        await processRequest()
        return { success: true }
      })

    Settings

    Member Visibility

    On This Page

    Methods