Specifies whether or not an emulator configuration should be present and
whether or not it should be used. Emulator configuration is usually specified
through environment variables.
Always connect to the emulator, throwing an exception if no emulator
configuration is detected.
EmulatorOrProduction
Connect to the emulator if an emulator configuration is detected,
or production otherwise. This is a convenient option, but risks damage to
production databases or running up unexpected bills if tests are accidentally
run in production due to the emulator configuration being absent unexpectedly.
(Using separate projects for production and testing is a best practice for
preventing the first issue, but may be unrealistic for small or hobby projects.)
None
Ignores the presence or absence of emulator configuration.
ProductionOnly
Always connect to the production servers, but throw an exception if
an emulator configuration is detected that would suggest connecting to
an emulator is expected.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-17 UTC."],[[["The `EmulatorDetection` enum controls whether an emulator configuration should be present and used, typically managed via environment variables."],["`EmulatorOnly` ensures connections are made solely to the emulator, raising an exception if emulator configurations are missing."],["`EmulatorOrProduction` connects to the emulator if configured, otherwise it defaults to production, which carries a risk of unintended production impact if the emulator is not available."],["`None` completely disregards emulator configurations."],["`ProductionOnly` enforces connections to production servers and raises an exception if emulator settings are detected."]]],[]]
