Unit tests

Author: EmilianoSanchez

.github/workflows/ci-cd.yml

@@ -49,7 +49,7 @@ jobs:
         run: echo "VERSION=$(cat package.json | jq -r .version)" >> $GITHUB_ENV
 
       - name: SonarQube Scan (Push)
-        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/fallback-treatment-support')
+        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/development')
         uses: SonarSource/sonarcloud-github-action@v1.9
         env:
           SONAR_TOKEN: ${{ secrets.SONARQUBE_TOKEN }}
@@ -77,7 +77,7 @@ jobs:
             -Dsonar.pullrequest.base=${{ github.event.pull_request.base.ref }}
 
       - name: Store assets
-        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/fallback-treatment-support')
+        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref == 'refs/heads/development')
         uses: actions/upload-artifact@v4
         with:
           name: assets
@@ -88,7 +88,7 @@ jobs:
     name: Upload assets
     runs-on: ubuntu-latest
     needs: build
-    if: github.event_name == 'push' && github.ref == 'refs/heads/fallback-treatment-support'
+    if: github.event_name == 'push' && github.ref == 'refs/heads/development'
     strategy:
       matrix:
         environment:

CHANGES.txt

@@ -1,4 +1,4 @@
-2.6.0 (October 31, 2025)
+2.6.0 (November 4, 2025)
  - Added `useTreatment`, `useTreatments`, `useTreatmentWithConfig` and `useTreatmentsWithConfig` hooks to replace the now deprecated `useSplitTreatments` hook.
  - Updated @splitsoftware/splitio package to version 11.8.0 that includes minor updates:
       - Added new configuration for Fallback Treatments, which allows setting a treatment value and optional config to be returned in place of "control", either globally or by flag. Read more in our docs.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@splitsoftware/splitio-react",
-  "version": "2.5.1-rc.0",
+  "version": "2.6.0",
   "description": "A React library to easily integrate and use Split JS SDK",
   "main": "cjs/index.js",
   "module": "esm/index.js",
@@ -63,7 +63,7 @@
   },
   "homepage": "https://github.com/splitio/react-client#readme",
   "dependencies": {
-    "@splitsoftware/splitio": "11.7.2-rc.5",
+    "@splitsoftware/splitio": "11.8.0",
     "memoize-one": "^5.1.1",
     "shallowequal": "^1.1.0",
     "tslib": "^2.3.1"

package.json

@@ -4,3 +4,11 @@ export const sdkBrowser: SplitIO.IBrowserSettings = {
     key: 'customer-key',
   },
 };
+
+export const sdkBrowserWithConfig: SplitIO.IBrowserSettings = {
+  ...sdkBrowser,
+  fallbackTreatments: {
+    global: 'control_global',
+    byFlag: { ff1: { treatment: 'control_ff1', config: 'control_ff1_config' } }
+  }
+};

src/__tests__/testUtils/sdkConfigs.ts

@@ -7,7 +7,7 @@ jest.mock('@splitsoftware/splitio/client', () => {
   return { SplitFactory: mockSdk() };
 });
 import { SplitFactory } from '@splitsoftware/splitio/client';
-import { sdkBrowser } from './testUtils/sdkConfigs';
+import { sdkBrowser, sdkBrowserWithConfig } from './testUtils/sdkConfigs';
 import { CONTROL, EXCEPTION_NO_SFP } from '../constants';
 
 /** Test target */
@@ -96,7 +96,7 @@ describe('useTreatment', () => {
     }).toThrow(EXCEPTION_NO_SFP);
   });
 
-  test('useTreatment must update on SDK events', async () => {
+  test('must update on SDK events', async () => {
     const outerFactory = SplitFactory(sdkBrowser);
     const mainClient = outerFactory.client() as any;
     const user2Client = outerFactory.client('user_2') as any;
@@ -171,4 +171,16 @@ describe('useTreatment', () => {
     expect(user2Client.getTreatment).toHaveBeenLastCalledWith('split_test', undefined, undefined);
   });
 
+  test('returns fallback treatment if the client is not operational', () => {
+    render(
+      <SplitFactoryProvider config={sdkBrowserWithConfig} >
+        {React.createElement(() => {
+          expect(useTreatment({ name: featureFlagName, attributes, properties }).treatment).toEqual('control_global');
+          expect(useTreatment({ name: 'ff1', attributes, properties }).treatment).toEqual('control_ff1');
+          return null;
+        })}
+      </SplitFactoryProvider>
+    );
+  });
+
 });

src/__tests__/useTreatment.test.tsx

@@ -7,7 +7,7 @@ jest.mock('@splitsoftware/splitio/client', () => {
   return { SplitFactory: mockSdk() };
 });
 import { SplitFactory } from '@splitsoftware/splitio/client';
-import { sdkBrowser } from './testUtils/sdkConfigs';
+import { sdkBrowser, sdkBrowserWithConfig } from './testUtils/sdkConfigs';
 import { CONTROL_WITH_CONFIG, EXCEPTION_NO_SFP } from '../constants';
 
 /** Test target */
@@ -96,7 +96,7 @@ describe('useTreatmentWithConfig', () => {
     }).toThrow(EXCEPTION_NO_SFP);
   });
 
-  test('useTreatmentWithConfig must update on SDK events', async () => {
+  test('must update on SDK events', async () => {
     const outerFactory = SplitFactory(sdkBrowser);
     const mainClient = outerFactory.client() as any;
     const user2Client = outerFactory.client('user_2') as any;
@@ -171,4 +171,16 @@ describe('useTreatmentWithConfig', () => {
     expect(user2Client.getTreatmentWithConfig).toHaveBeenLastCalledWith('split_test', undefined, undefined);
   });
 
+  test('returns fallback treatment if the client is not operational', () => {
+    render(
+      <SplitFactoryProvider config={sdkBrowserWithConfig} >
+        {React.createElement(() => {
+          expect(useTreatmentWithConfig({ name: featureFlagName, attributes, properties }).treatment).toEqual({ treatment: 'control_global', config: null });
+          expect(useTreatmentWithConfig({ name: 'ff1', attributes, properties }).treatment).toEqual({ treatment: 'control_ff1', config: 'control_ff1_config' });
+          return null;
+        })}
+      </SplitFactoryProvider>
+    );
+  });
+
 });

src/__tests__/useTreatmentWithConfig.test.tsx

@@ -7,7 +7,7 @@ jest.mock('@splitsoftware/splitio/client', () => {
   return { SplitFactory: mockSdk() };
 });
 import { SplitFactory } from '@splitsoftware/splitio/client';
-import { sdkBrowser } from './testUtils/sdkConfigs';
+import { sdkBrowser, sdkBrowserWithConfig } from './testUtils/sdkConfigs';
 import { CONTROL, EXCEPTION_NO_SFP } from '../constants';
 
 /** Test target */
@@ -132,7 +132,7 @@ describe('useTreatments', () => {
     );
   });
 
-  test('useTreatments must update on SDK events', async () => {
+  test('must update on SDK events', async () => {
     const outerFactory = SplitFactory(sdkBrowser);
     const mainClient = outerFactory.client() as any;
     const user2Client = outerFactory.client('user_2') as any;
@@ -226,4 +226,16 @@ describe('useTreatments', () => {
     );
   });
 
+  test('returns fallback treatments if the client is not operational', () => {
+    render(
+      <SplitFactoryProvider config={sdkBrowserWithConfig} >
+        {React.createElement(() => {
+          const { treatments } = useTreatments({ names: ['ff1', 'ff2'], attributes, properties });
+          expect(treatments).toEqual({ ff1: 'control_ff1', ff2: 'control_global' });
+          return null;
+        })}
+      </SplitFactoryProvider>
+    );
+  });
+
 });

src/__tests__/useTreatments.test.tsx

@@ -7,7 +7,7 @@ jest.mock('@splitsoftware/splitio/client', () => {
   return { SplitFactory: mockSdk() };
 });
 import { SplitFactory } from '@splitsoftware/splitio/client';
-import { sdkBrowser } from './testUtils/sdkConfigs';
+import { sdkBrowser, sdkBrowserWithConfig } from './testUtils/sdkConfigs';
 import { CONTROL_WITH_CONFIG, EXCEPTION_NO_SFP } from '../constants';
 
 /** Test target */
@@ -132,7 +132,7 @@ describe('useTreatmentsWithConfig', () => {
     );
   });
 
-  test('useTreatmentsWithConfig must update on SDK events', async () => {
+  test('must update on SDK events', async () => {
     const outerFactory = SplitFactory(sdkBrowser);
     const mainClient = outerFactory.client() as any;
     const user2Client = outerFactory.client('user_2') as any;
@@ -232,4 +232,16 @@ describe('useTreatmentsWithConfig', () => {
     );
   });
 
+  test('returns fallback treatments if the client is not operational', () => {
+    render(
+      <SplitFactoryProvider config={sdkBrowserWithConfig} >
+        {React.createElement(() => {
+          const { treatments } = useTreatmentsWithConfig({ names: ['ff1', 'ff2'], attributes, properties });
+          expect(treatments).toEqual({ ff1: { treatment: 'control_ff1', config: 'control_ff1_config' }, ff2: { treatment: 'control_global', config: null } });
+          return null;
+        })}
+      </SplitFactoryProvider>
+    );
+  });
+
 });