Class ReactNativeLDClient

The React Native LaunchDarkly client. Instantiate this class to create an instance of the ReactNativeLDClient and pass it to the LDProvider.

Example

const featureClient = new ReactNativeLDClient(MOBILE_KEY, AutoEnvAttributes.Enabled);

<LDProvider client={featureClient}>
  <Welcome />
</LDProvider>

Hierarchy

LDClientImpl
- ReactNativeLDClient

Constructors

constructor

new ReactNativeLDClient(sdkKey, autoEnvAttributes, options?): ReactNativeLDClient
Creates an instance of the LaunchDarkly client.
Parameters
- sdkKey: string
  
  The LaunchDarkly mobile key.
- autoEnvAttributes: AutoEnvAttributes
  
  Enable / disable Auto environment attributes. When enabled, the SDK will automatically provide data about the mobile environment where the application is running. To learn more, read Automatic environment attributes. for more documentation.
- options: LDOptions = {}
  
  LDOptions to initialize the client with.
Returns ReactNativeLDClient
Overrides LDClientImpl.constructor
- Defined in packages/sdk/react-native/src/ReactNativeLDClient.ts:37

Properties

`Readonly` autoEnvAttributes

autoEnvAttributes: AutoEnvAttributes

config

config: default

`Optional` context

context?: LDContext

`Optional` diagnosticsManager

diagnosticsManager?: DiagnosticsManager

`Optional` eventProcessor

eventProcessor?: EventProcessor

`Readonly` highTimeoutThreshold

highTimeoutThreshold: number

identifyTimeout

identifyTimeout: number

logger

logger: LDLogger

`Readonly` platform

platform: Platform

`Readonly` sdkKey

sdkKey: string

`Optional` streamer

streamer?: StreamingProcessor

Methods

allFlags

allFlags(): LDFlagSet
Returns LDFlagSet
Inherited from LDClientImpl.allFlags
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:38

boolVariation

boolVariation(key, defaultValue): boolean
Parameters
- key: string
- defaultValue: boolean
Returns boolean
Inherited from LDClientImpl.boolVariation
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:98

boolVariationDetail

boolVariationDetail(key, defaultValue): LDEvaluationDetailTyped<boolean>
Parameters
- key: string
- defaultValue: boolean
Returns LDEvaluationDetailTyped<boolean>
Inherited from LDClientImpl.boolVariationDetail
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:102

close

close(): Promise<void>
Returns Promise<void>
Inherited from LDClientImpl.close
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:39

createStreamUriPath

createStreamUriPath(context): string
Generates the url path for streamer.

For mobile key: /meval/${base64-encoded-context} For clientSideId: /eval/${envId}/${base64-encoded-context}

the path.

This function must be overridden in subclasses for streamer to work.
Parameters
- context: LDContext
  
  The LDContext object
Returns string
Overrides LDClientImpl.createStreamUriPath
- Defined in packages/sdk/react-native/src/ReactNativeLDClient.ts:62

flush

flush(): Promise<{
error?: Error;
result: boolean;
}>
Returns Promise<{
error?: Error;
result: boolean;
}>
Inherited from LDClientImpl.flush
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:40

getConnectionMode

getConnectionMode(): ConnectionMode
Gets the SDK connection mode.

Returns ConnectionMode
Inherited from LDClientImpl.getConnectionMode
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:36

getContext

getContext(): undefined | LDContext
Returns undefined | LDContext
Inherited from LDClientImpl.getContext
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:44

identify

identify(pristineContext, identifyOptions?): Promise<void>
Identifies a context to LaunchDarkly. See LDClient.identify.
Parameters
- pristineContext: LDContext
  
  The LDContext object to be identified.
- Optional identifyOptions: LDIdentifyOptions
  
  Optional configuration. See LDIdentifyOptions.
  
  Optional
Returns Promise<void>
A Promise which resolves when the flag values for the specified context are available. It rejects when:
1. The context is unspecified or has no key.
2. The identify timeout is exceeded. In client SDKs this defaults to 5s. You can customize this timeout with LDIdentifyOptions | identifyOptions.
3. A network error is encountered during initialization.
Inherited from LDClientImpl.identify
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:76

isOffline

isOffline(): boolean
Returns boolean
Inherited from LDClientImpl.isOffline
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:37

jsonVariation

jsonVariation(key, defaultValue): unknown
Parameters
- key: string
- defaultValue: unknown
Returns unknown
Inherited from LDClientImpl.jsonVariation
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:99

jsonVariationDetail

jsonVariationDetail(key, defaultValue): LDEvaluationDetailTyped<unknown>
Parameters
- key: string
- defaultValue: unknown
Returns LDEvaluationDetailTyped<unknown>
Inherited from LDClientImpl.jsonVariationDetail
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:105

numberVariation

numberVariation(key, defaultValue): number
Parameters
- key: string
- defaultValue: number
Returns number
Inherited from LDClientImpl.numberVariation
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:100

numberVariationDetail

numberVariationDetail(key, defaultValue): LDEvaluationDetailTyped<number>
Parameters
- key: string
- defaultValue: number
Returns LDEvaluationDetailTyped<number>
Inherited from LDClientImpl.numberVariationDetail
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:103

off

off(eventName, listener): void
Parameters
- eventName: EventName
- listener: Function
Returns void
Inherited from LDClientImpl.off
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:91

on

on(eventName, listener): void
Parameters
- eventName: EventName
- listener: Function
Returns void
Inherited from LDClientImpl.on
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:92

setConnectionMode

setConnectionMode(mode): Promise<void>
Sets the SDK connection mode.
Parameters
- mode: ConnectionMode
  
  One of supported ConnectionMode. Default is 'streaming'.
Returns Promise<void>
Inherited from LDClientImpl.setConnectionMode
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:32

stringVariation

stringVariation(key, defaultValue): string
Parameters
- key: string
- defaultValue: string
Returns string
Inherited from LDClientImpl.stringVariation
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:101

stringVariationDetail

stringVariationDetail(key, defaultValue): LDEvaluationDetailTyped<string>
Parameters
- key: string
- defaultValue: string
Returns LDEvaluationDetailTyped<string>
Inherited from LDClientImpl.stringVariationDetail
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:104

track

track(key, data?, metricValue?): void
Parameters
- key: string
- Optional data: any
  Optional
- Optional metricValue: number
  Optional
Returns void
Inherited from LDClientImpl.track
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:93

variation

variation(flagKey, defaultValue?): any
Parameters
- flagKey: string
- Optional defaultValue: any
  Optional
Returns any
Inherited from LDClientImpl.variation
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:95

variationDetail

variationDetail(flagKey, defaultValue?): LDEvaluationDetail
Parameters
- flagKey: string
- Optional defaultValue: any
  Optional
Returns LDEvaluationDetail
Inherited from LDClientImpl.variationDetail
- Defined in packages/shared/sdk-client/dist/LDClientImpl.d.ts:96

Class ReactNativeLDClient

Example

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

sdkKey: string

autoEnvAttributes: AutoEnvAttributes

options: LDOptions = {}

Returns ReactNativeLDClient

Properties

Readonly autoEnvAttributes

config

Optional context

Optional diagnosticsManager

Optional eventProcessor

Readonly highTimeoutThreshold

identifyTimeout

logger

Readonly platform

Readonly sdkKey

Optional streamer

Methods

allFlags

Returns LDFlagSet

boolVariation

Parameters

key: string

defaultValue: boolean

Returns boolean

boolVariationDetail

Parameters

key: string

defaultValue: boolean

Returns LDEvaluationDetailTyped<boolean>

close

Returns Promise<void>

createStreamUriPath

Parameters

context: LDContext

Returns string

flush

Returns Promise<{ error?: Error; result: boolean; }>

getConnectionMode

Returns ConnectionMode

getContext

Returns undefined | LDContext

identify

Parameters

pristineContext: LDContext

Optional identifyOptions: LDIdentifyOptions

Returns Promise<void>

isOffline

Returns boolean

jsonVariation

Parameters

key: string

defaultValue: unknown

Returns unknown

jsonVariationDetail

Parameters

key: string

defaultValue: unknown

Returns LDEvaluationDetailTyped<unknown>

numberVariation

Parameters

key: string

defaultValue: number

Returns number

numberVariationDetail

Parameters

key: string

defaultValue: number

Returns LDEvaluationDetailTyped<number>

off

Parameters

`Readonly` autoEnvAttributes

`Optional` context

`Optional` diagnosticsManager

`Optional` eventProcessor

`Readonly` highTimeoutThreshold

`Readonly` platform

`Readonly` sdkKey

`Optional` streamer

Returns Promise<{
error?: Error;
result: boolean;
}>

`Optional` identifyOptions: LDIdentifyOptions

`Optional` data: any

`Optional` metricValue: number

`Optional` defaultValue: any

`Optional` defaultValue: any