Node SDK

variation

Evaluate a flag of any type and get its value, or your default.

Evaluates the flag locally for the context and returns the value. Any failure (unknown flag, invalid context, malformed flag, no snapshot) returns defaultValue.

Use a typed helper when you know the flag’s type: it also guards against a flag whose type changed.

Signature

variation<T>(key: string, ctx: Context, defaultValue: T): T

Example

const theme = flags.variation('checkout-theme', { key: 'user-42' }, 'classic');

The SDK is @rollkit/sdk in the repository (packages/sdk). It is for server-side Node; browsers use a client key with the delivery API.

More sdk methods

All sdk methods →

01
createFlagClient
Create the one client your process uses. It starts fetching the snapshot at once.
02
waitForInitialization
Wait until the first snapshot is loaded, or fail after a timeout or a rejected key.
03
variationDetail
Evaluate a flag and get the value with the reason, variation id and versions.

More sdk methods

createFlagClient

waitForInitialization

variationDetail