Feature Request: `useDecisions` hook

[ivanngbowtie]

The current useDecision hook can only work with one feature flag and return only one OptimizelyDecision.

In situation where more than one decision is needed, a useDecisions hook can be used rather than using multiple useDecision hooks. This is especially important for cases where the flags used would change dynamically, for example a switchByFeatureFlags function, which accept multiple flags as argument.

[celineotter]

bumping,

what is the recommended way to handle a view that might have multiple a/b tests / assigned decision variants please?

Is there a way to see all the a/b test decisions that a user has been assigned on instead of having to check "useDecision" on each flag and handling "didTimeout" and "isClientReady" on each flag please?

Much appreciated

[mikechu-optimizely]

I've created an internal work ticket (FSSDK-9620) for this.

Question (and please forgive my in-progress React knowledge): could we separate out by component where useDecision() is used ie react inside each component separately (I'm sort of guess at the implementation too here 😁 )

[junaed-optimizely]

This is now fully addressed in v4. We've introduced a suite of decision hooks that cover single-flag, multi-flag, and all-flag use cases:

Hook	Description
useDecide(flagKey)	Single flag decision (replaces useDecision)
useDecideForKeys(flagKeys[])	Batch decisions for multiple flag keys
useDecideAll()	Decisions for all active flags

For the exact scenario described in this issue - needing multiple decisions at once or working with dynamic flag keys -useDecideForKeys is a direct fit:

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

const { decisions, isLoading, error } = useDecideForKeys(['flag-a', 'flag-b', 'flag-c']);

if (!isLoading) {
  const flagA = decisions['flag-a'];
  const flagB = decisions['flag-b'];
}

And for cases where you want to see all assigned decisions for a user without specifying keys upfront, useDecideAll handles that:

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

const { decisions, isLoading, error } = useDecideAll();

All hooks share a consistent { decisions, isLoading, error } return type, so there's no need to handle readiness separately per flag. Async variants (useDecideForKeysAsync, useDecideAllAsync) are also available for setups involving CMAB or async User Profile Service lookups.

For more details, see the Hooks documentation and the Migration Guide.