Vue.js Azure App Configuration

Wrapper library of Microsofts Azure App Configuration SDK for JavaScript for Vue.js applications.

Setup

Install the Package

npm

npm install @4com/vue-azure-app-configuration

yarn

yarn add @4com/vue-azure-app-configuration

Use the Plugin

Install the plugin by adding it to your main.js.

import { VueAzureAppConfiguration } from '@4com/vue-azure-app-configuration'

Vue.use(VueAzureAppConfiguration, { see configuration options })

Configuration

The following options can be passed within the second object parameter when installing the plugin.

| Option | Description | | :-- | :-- | | connectionString | For authenticating the client using a connection string. | | featureFlagLabel | The default feature flag label used as a fallback if no label argument is passed to any of the getFeatureFlagAsync() or isFeatureFlagEnabledAsync() methods, or the feature-flag component. |

Access the options passed when installing the plugin in components at this.$azureAppConfig.options.

Components

| Example | Description | | :-- | :-- | | <feature-flag name="MyFeatureFlag" label="Label" user="[email protected]"> | Conditionally renders the element based on whether the feature flag with the provided name and (optional) label is enabled for the (optional) specified user. The label property overrides the featureFlagLabel if provided in the plugin options. |

Global Methods

Call the following global methods from components at this.$azureAppConfig.

| Signature | Description | | :-- | :-- | | getFeatureFlagAsync(name, label) | Gets the feature flag with the passed name and (optional) label. Returns the ConfigurationSetting<FeatureFlagValue>. Returns null if the feature flag is not found. | | isFeatureFlagEnabledAsync(name, label) | Returns true when the feature flag with the passed name and (optional) label is enabled. Returns false when the feature flag is not found. | | isFeatureFlagEnabledForUserAsync(name, label, user) | Returns true when the feature flag with the passed name and (optional) label is enabled for the (optional) specified user. Returns false when the feature flag is not found. |

Limitations

Features

This library currently only provides instance methods and a component for ease with using feature flags.

However, the AppConfigurationClient is exposed at this.$azureAppConfig.client.

Authentication

This library currently only supports authentication using a connection string.

Development

Sandbox

The sandbox can be used while developing and testing out features of the library. It uses BootstrapVue components.

Use yarn serve to start the sandbox live reload server.