Guides

These guides provide in-depth coverage of specific isolated-workers topics.

Core Concepts

Error Handling

Learn how errors thrown in worker processes propagate back to the host, including error serialization across process boundaries, proper try/catch patterns, and error message preservation.

Worker Lifecycle

Managing worker state, status checks, and graceful shutdown. Learn about state persistence across messages, health checks, and proper cleanup patterns.

Configuration

Timeout Configuration

Configure timeouts for worker startup, connection, and per-message-type operations. Essential for long-running tasks and responsive health checks.

Shutdown Handling

Configure how workers handle unexpected crashes (OOM, SIGKILL, hard crashes). Learn about crash detection, reject/retry strategies, and per-message-type overrides for handling pending operations.

Custom Serializers

Use custom serialization for binary formats like MessagePack, add compression, or implement encryption for sensitive data crossing process boundaries.

Advanced Patterns

Middleware

Intercept and transform messages with middleware pipelines. Useful for logging, validation, timing, and adding metadata to messages.

Testing Workers

Strategies for testing worker-based code. Covers unit testing handlers in isolation, integration testing with real workers, mocking workers for host-side tests, and CI considerations.

Security Considerations

Security best practices for worker-based applications. Understand what isolation process separation provides, socket security, message validation, and when additional sandboxing is needed.