Optional Dependencies

ELI5 — The Vibe Check

Optional dependencies are packages that your code CAN use if they're available but won't cry about if they're not. It's like a recipe that says 'add truffle oil if you have it.' If the optional package fails to install (wrong platform, missing build tools), the installation continues without it. Your code just needs to handle the 'not available' case gracefully.

Real Talk

Optional dependencies (optionalDependencies in package.json) are packages that enhance functionality but aren't required for the core module to work. If installation fails (e.g., platform-specific native modules), the overall install succeeds. The consuming code must handle the absent module with try/catch or conditional imports.

When You'll Hear This

"We list the native image optimizer as an optional dependency — it falls back to the JS version if unavailable." / "Optional dependencies are perfect for platform-specific optimizations that shouldn't break CI."