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"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe content outlines different versions of the \u003ccode\u003eGoogle.Api.Gax\u003c/code\u003e library, with version 4.10.0 being the latest.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEmulatorDetection\u003c/code\u003e enum within the \u003ccode\u003eGoogle.Api.Gax\u003c/code\u003e namespace determines whether an emulator configuration should be present and utilized.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eEmulatorOnly\u003c/code\u003e, \u003ccode\u003eEmulatorOrProduction\u003c/code\u003e, \u003ccode\u003eNone\u003c/code\u003e, and \u003ccode\u003eProductionOnly\u003c/code\u003e fields provide options for controlling emulator usage and handling, from strictly emulator to production only.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eEmulatorOrProduction\u003c/code\u003e offers convenience by using the emulator if available but carries the risk of unintentional production database impact.\u003c/p\u003e\n"],["\u003cp\u003eUsing separate testing and production projects is recommended to prevent accidental damage if using the \u003ccode\u003eEmulatorOrProduction\u003c/code\u003e option.\u003c/p\u003e\n"]]],[],null,[]]
