Getting all flags

This topic explains how the all flags feature works in the LaunchDarkly SDKs that support it.

Overview

This topic explains how the all flags feature works in the LaunchDarkly SDKs that support it. The all flags feature is available for client-side, server-side, and edge SDKs.

About the all flags feature

The all flags feature returns an object containing the variation values of all the feature flags targeted to a specific context object or user object.

Server-side SDKs also return metadata for use on the front end, including information on flag keys, variations, and prerequisites. You can use this metadata to provide bootstrap flag settings for LaunchDarkly’s JavaScript-based SDKs. To learn more, read the JavaScript SDK reference.

You can find the expected flag values for a specific context on its details page:

The allFlags method does not send analytics events to LaunchDarkly by default for most SDKs. The exceptions to this are Electron, Node.js (client-side), Vue, and older versions of the JavaScript SDKs, which do send analytics events by default. For these SDKs, you can disable sending analytics events when calling the all flags method if needed. To learn more about what analytics events do in LaunchDarkly, read Analytics events.

For client-side SDKs, the all flags feature may return a null value in cases where a flag’s fallback value would be served to the end user.

For server-side SDKs, you can use the all flags feature to pass feature flags to your front end. In particular, you can use it to provide bootstrap flag settings for the JavaScript SDK. To learn more about bootstrapping from a client-side SDK, read Bootstrapping.

Details about each SDK’s configuration are available in the SDK-specific sections below:

• Client-side SDKs
• Server-side SDKs
• Edge SDKs

A context is a generalized way of referring to the people, services, machines, or other resources that encounter feature flags in your product. Contexts replace another data object in LaunchDarkly: “users.”

Creating contexts and evaluating flags based on them is supported in the latest major versions of most of our SDKs. For these SDKs, the code samples on this page include the two most recent versions.

Client-side SDKs

Before you implement this feature, read About the all flags feature.

This feature is available in the following client-side SDKs:

• .NET (client-side)
• Android
• C++ (client-side)
• Electron
• Flutter
• iOS
• JavaScript
• Node.js (client-side)
• React Native
• React Web
• Roku

.NET (client-side)

Expand .NET (client-side) code sample

The AllFlags method produces a map of feature flag keys to their values for a context object:

C#

      client.AllFlags();

To learn more, read the API documentation.

Android

Expand Android code sample

The allFlags method produces a map of feature flag keys to their values for a context object:

Java

      client.allFlags();

To learn more, read the API documentation.

C++ (client-side)

Expand C++ (client-side) code sample

The AllFlags method produces a map of feature flag keys to their values for a context object:

C++ SDK v3.0 (native)

      for (auto [flag_key, flag_value] : client.AllFlags()) {
          std::cout << flag_key << ": " << flag_value << std::endl;
      }

To learn more, read AllFlags in the LDClient documentation.

Electron

Expand Electron code sample

The allFlags() method produces a map of feature flag keys to their values for a user object. The map contains null values for any flags that would return the fallback value. The fallback value is the second argument that you normally pass to variation.

Unlike most of our SDKs, our Electron SDK’s allFlags() method sends analytics events to LaunchDarkly. If you do not want allFlags() to generate any analytics events, you can turn this off by setting the configuration option sendEventsOnlyForVariation to true.

To use the all flags feature:

JavaScript

      let allFlagsResult = client.allFlags();

To learn more, read the API documentation.

Flutter

Expand Flutter code sample

The allFlags method produces a map of feature flag keys to their values for a context object:

Flutter SDK v4

      Map<String, LDValue> flagValues = client.allFlags();

To learn more, read allFlags.

iOS

Expand iOS code sample

The all flags method produces a dictionary of feature flag keys to their values for a context object. If the LDClient is not started, it returns nil.

To use the all flags feature:

Swift

      let allFlags: [String: LDValue] = LDClient.get()!.allFlags

To learn more, read the API documentation for Swift or Objective-C.

Java

Script

Expand JavaScript code sample

The allFlags() method produces a map of feature flag keys to their values for a context object.

The map contains null values for any flags that would return the fallback value. The fallback value is the second argument that you normally pass to variation.

In the JavaScript SDK v3.x and earlier, the allFlags method sends analytics events to LaunchDarkly. You can turn this off by setting the configuration option sendEventsOnlyForVariation to true.

In the JavaScript SDK v4.x, the allFlags method no longer sends analytics events to LaunchDarkly.

To use the all flags feature:

JavaScript SDK

      let allFlagsResult = client.allFlags();

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read allFlags.

Node.js (client-side)

Expand Node.js (client-side) code sample

The allFlags method produces a map of feature flag keys to their values for a context object.

The map contains null values for any flags that would return the fallback value. The fallback value is the second argument that you normally pass to variation.

Unlike most of our SDKs, our Node.js (client-side) SDK’s allFlags method sends analytics events to LaunchDarkly. If you do not want allFlags to generate any analytics events, you can turn this off by setting the sendEventsOnlyForVariation option to true.

To use the all flags feature:

JavaScript

      let allFlagsResult = client.allFlags();

To learn more, read the API documentation.

React Web

Expand React Web code sample

The allFlags() method produces a map of feature flag keys to their values for a context object.

Here is an example:

React Web SDK

      const allFlags = ldClient.allFlags();

The React Web SDK relies on the JavaScript SDK for its allFlags functionality. However, unlike JavaScript, the React Web SDK does not send analytics events for allFlags by default. It only sends analytics events for variation or useFlags calls. This behavior matches the behavior of most of our other SDKs, besides the JavaScript SDK.

If you do need to generate analytics events for the allFlags method, you can set the sendEventsOnlyForVariation configuration option to false. We do not recommend this, because then you will receive events for all flags. You will have no way to differentiate events for flags that are in use from events for flags that are not in use.

Analytics events include feature events, debug events, and evaluation events. To learn more, read About the all flags feature, above.

React Native

Expand React Native code sample

The allFlags method returns a map of feature flag keys to their values for a context, or an empty object if flags cannot be evaluated.

To use the all flags feature:

React Native SDK, v10

      let allFlagsResult = client.allFlags()

To learn more, read allFlags.

Roku

Expand Roku code sample

The all flags method produces a map of feature flag keys to their values for a context object:

BrightScript

      allFlags = launchDarkly.allFlagsState()

Server-side SDKs

Before you implement this feature, read About the all flags feature.

This feature is available in the following server-side SDKs:

• .NET (server-side)
• Apex
• C++ (server-side)
• Erlang
• Go
• Haskell
• Java
• Lua
• Node.js (server-side)
• PHP
• Python
• Ruby
• Rust

.NET (server-side)

Expand .NET (server-side) code sample

The AllFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

.NET SDK v7.0 (C#)

      var state = client.AllFlagsState(context);

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Apex

Expand Apex code sample

The allFlags method produces a map of feature flag keys to their values for a specific user object:

Apex

      Map<String, LDValue> values = client.allFlags(user);

To learn more, read the API documentation.

C++ (server-side)

Expand C++ (server-side) code sample

The AllFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context. Here’s how to call it and output the result:

C++ SDK v3.0 (native)

      auto const all_flags = client.AllFlagsState(context);
      if (all_flags.Valid() {
         for (auto const& [flag_key, flag_value] : all_flags.Values()) {
             std::cout << flag_key << ": " << flag_value << std::endl;
         }
      }  else {
         /* error evaluating all flags! */
      }

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Erlang

Expand Erlang code sample

The all_flags_state method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

v2.0+"

      ldclient:all_flags_state(#{key => <<"example-context-key">>})

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Go

Expand Go code sample

The AllFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object.

This example specifies the extra ClientSideOnly option so that only the feature flags designated for client-side use are included in the result.

To use the all flags feature:

Go SDK v7.13.4+, using LDScopedClient

      import (
          "github.com/launchdarkly/go-server-sdk/v7/interfaces/flagstate"
      )

      // There is not an AllFlagsState method in the LDScopedClient,
      // so you need to access the method from the LDClient.
      // Then, pass in the scoped client's current context.
      // LDScopedClient is in beta and may change without notice.

      state := scopedClient.Client().AllFlagsState(scopedClient.CurrentContext(), flagstate.OptionClientSideOnly())

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Haskell

Expand Haskell code sample

The allFlags method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

Haskell SDK v4.0

      state = allFlagsState client context False False False

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Java

Expand Java code sample

The allFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object:

Java SDK v6.0

      FeatureFlagsState state = client.allFlagsState(context);

To learn more, read allFlagsState.

Lua

Expand Lua code sample

The allFlags method produces a map of feature flag keys to their values and other metadata for a specific context.

Here’s how to call it and output the result:

Lua SDK v2

      local allFlags = client:allFlags(context)
      for flag, value in pairs(allFlags) do
          print(flag, value)
      end

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read [allFlags]](https://launchdarkly.github.io/lua-server-sdk/modules/launchdarkly-server-sdk.html#allFlags).

Node.js (server-side)

Expand Node.js (server-side) code sample

The allFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

Node.js SDK v7.x and later

      client.allFlagsState(context, options, (err, flagsState) => {
        // this object can be converted to JSON using toJSON()
        // or can be queried for flag values using allValues() or getFlagValue(flag-key)
      });

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

PHP

Expand PHP code sample

The allFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object:

PHP SDK v5.0

      $state  = $client->allFlagsState($context);

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Python

Expand Python code sample

The all_flags_state method produces a map of feature flag keys to their values and other metadata for a specific context object:

Python SDK v8.0

      state = ldclient.get().all_flags_state(context)

The metadata includes information on flag keys, variations, and prerequisites. The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Ruby

Expand Ruby code sample

The all_flags_state method produces a map of feature flag keys to their values and other metadata for a specific context object:

Ruby SDK v7.0

      state = client.all_flags_state(context)

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Rust

Expand Rust code sample

The all_flags_detail method produces a map of feature flag keys to their values and other metadata for a specific context object:

Rust SDK v1

      let state = ldclient.all_flags_detail(&context, FlagDetailConfig::new());

The metadata includes information on flag keys, variations, and prerequisites. To learn more, read the API documentation.

Edge SDKs

Before you implement this feature, read About the all flags feature.

This feature is available for the following edge SDKs:

• Akamai
• Cloudflare
• Fastly
• Vercel

Akamai

Expand Akamai code sample

The allFlagsState method produces an object that encapsulates the state of all feature flags for a given context. This method does not send analytics events back to LaunchDarkly.

To use the all flags feature:

Akamai SDK

      const allFlags = await client.allFlagsState(context);

To learn more, read the API documentation.

Every time you call allFlagsState, the SDK fetches the flag data from the EdgeKV store. Your Akamai resource tier may limit how many of these queries you can make while a single worker handler is being executed. Using the Akamai SDK cache can help alleviate this limit. To learn more, read Understand resource limits and caching options.

Cloudflare

Expand Cloudflare code sample

The allFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

TypeScript

      const allFlags = await client.allFlagsState(context);

To learn more, read the API documentation.

The Cloudflare SDK supports sending events. However, the allFlagsState method does not generate events in edge SDKs. Use the variation method instead. To learn more, read Evaluating flags.

Fastly

Expand Fastly code sample

The allFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

TypeScript

      const allFlags = await client.allFlagsState(context);

To learn more, read allFlagsState.

The Fastly SDK supports sending events. However, the allFlagsState method does not generate events in edge SDKs. Use the variation method instead. To learn more, read Evaluating flags.

Vercel

Expand Vercel code sample

The allFlagsState method produces a map of feature flag keys to their values and other metadata for a specific context object.

To use the all flags feature:

TypeScript

      const allFlags = await client.allFlagsState(context);

To learn more, read allFlagsState.

The Vercel SDK supports sending events. However, the allFlagsState method does not generate events in edge SDKs. Use the variation method instead. To learn more, read Evaluating flags.