useOptimizelyClient for the React Native SDK v4+

Minimum SDK version

v4.0.0+

For versions 3.x and earlier, the equivalent functionality was provided by the withOptimizely higher-order component. See React Native SDK prior to v4.

Description

The useOptimizelyClient hook returns the Optimizely Client instance from context. Use this hook when you need direct access to the client for operations not covered by the decide hooks.

To use this hook, call useOptimizelyClient within a component wrapped by OptimizelyProvider. See OptimizelyProvider for the React Native SDK.

Returns

Returns the Optimizely Client instance provided to <OptimizelyProvider> via the client prop.

Example

import { useOptimizelyClient } from '@optimizely/react-sdk';

function MyComponent() {
  const client = useOptimizelyClient();

  const handleClick = () => {
    if (client) {
      const user = client.createUserContext('user-123', { plan: 'gold' });
      const decision = user.decide('flag-key');
      console.log('Decision:', decision);
    }
  };

  return <button onClick={handleClick}>Check Flag</button>;
}

Source files

The language and platform source files containing the implementation for the React Native SDK are available on GitHub.