Optional
allfalse.
Optional
applicationInformation about the application the LaunchDarkly SDK is running in.
These properties are optional and informational. They may be used in LaunchDarkly analytics or other product features.
Optional
id?: stringA unique identifier representing the application where the LaunchDarkly SDK is running.
This can be specified as any string value as long as it only uses the following characters: ASCII letters, ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
Example: authentication-service
Optional
name?: stringA human-friendly application name representing the application where the LaunchDarkly SDK is running.
This can be specified as any string value as long as it only uses the following characters: ASCII letters, ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
Optional
version?: stringA unique identifier representing the version of the application where the LaunchDarkly SDK is running.
This can be specified as any string value as long as it only uses the following characters: ASCII letters, ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
Example: 1.0.0
(standard version string) or abcdef
(sha prefix)
Optional
versionA human-friendly name representing the version of the application where the LaunchDarkly SDK is running.
This can be specified as any string value as long as it only uses the following characters: ASCII letters, ASCII digits, period, hyphen, underscore. A string containing any other characters will be ignored.
Optional
baseThe base uri for the LaunchDarkly server. Most users should use the default value.
https://clientsdk.launchdarkly.com.
Optional
capacityThe capacity of the analytics events queue.
The client buffers up to this many events in memory before flushing. If the capacity is exceeded before the queue is flushed, events will be discarded. Increasing the capacity means that events are less likely to be discarded, at the cost of consuming more memory. Note that in regular usage flag evaluations do not produce individual events, only summary counts, so you only need a large capacity if you are generating a large number of click, pageview, or identify events (or if you are using the event debugger).
100.
Optional
debugEnables debug logging.
false.
Optional
diagnosticSet to true to opt out of sending diagnostics data.
Unless diagnosticOptOut
is set to true, the client will send some diagnostics data to the LaunchDarkly
servers in order to assist in the development of future SDK improvements. These diagnostics consist of
an initial payload containing some details of SDK in use, the SDK's configuration, and the platform the
SDK is being run on, as well as payloads sent periodically with information on irregular occurrences such
as dropped events.
false.
Optional
diagnosticThe interval at which periodic diagnostic data is sent, in seconds.
The default is 900 (every 15 minutes) and the minimum value is 6. See diagnosticOptOut for more information on the diagnostics data being sent.
900s.
Optional
eventsThe base uri for the LaunchDarkly events server. Most users should use the default value.
https://events.launchdarkly.com.
Optional
flushControls how often the SDK flushes events.
30s.
Optional
initialSets the mode to use for connections when the SDK is initialized.
Possible values are offline or streaming. See ConnectionMode for more information.
streaming.
Optional
loggerAn object that will perform logging for the client.
Set a custom LDLogger if you want full control of logging behavior.
A BasicLogger which outputs to the console at info
level.
Optional
privateSpecifies a list of attribute names (either built-in or custom) which should be marked as private, and not sent to LaunchDarkly in analytics events. You can also specify this on a per-context basis with LDContextMeta.privateAttributes.
Any contexts sent to LaunchDarkly with this configuration active will have attributes with these names removed in analytic events. This is in addition to any attributes that were marked as private for an individual context with LDContextMeta.privateAttributes. Setting LDOptions.allAttributesPrivate to true overrides this.
If and only if a parameter starts with a slash, it is interpreted as a slash-delimited path
that can denote a nested property within a JSON object. For instance, "/address/street" means
that if there is an attribute called "address" that is a JSON object, and one of the object's
properties is "street", the "street" property will be redacted from the analytics data but
other properties within "address" will still be sent. This syntax also uses the JSON Pointer
convention of escaping a literal slash character as "1" and a tilde as "0".
Optional
sendWhether to send analytics events back to LaunchDarkly.
true.
Optional
streamSets the initial reconnect delay for the streaming connection, in seconds.
The streaming service uses a backoff algorithm (with jitter) every time the connection needs to be reestablished. The delay for the first reconnection will start near this value, and then increase exponentially for any subsequent connection failures.
1s.
Optional
streamThe base uri for the LaunchDarkly streaming server. Most users should use the default value.
https://clientstream.launchdarkly.com.
Optional
withWhether LaunchDarkly should provide additional information about how flag values were calculated.
The additional information will then be available through the client's LDClient.variationDetail method. Since this increases the size of network requests, such information is not sent unless you set this option to true.
false.
Optional
wrapperFor use by wrapper libraries to set an identifying name for the wrapper being used.
This will be sent as diagnostic information to the LaunchDarkly servers to allow recording metrics on the usage of these wrapper libraries.
Optional
wrapperFor use by wrapper libraries to set version to be included alongside wrapperName
.
If wrapperName
is unset, this field will be ignored.
Generated using TypeDoc
Whether all context attributes (except the context key) should be marked as private, and not sent to LaunchDarkly in analytics events.