feat(i18n): fallback to null to avoid setting undetermined values

Author: guilherme6191

packages/clerk-js/src/utils/__tests__/locale.test.ts

@@ -12,30 +12,30 @@ describe('getBrowserLocale()', () => {
     expect(getBrowserLocale()).toBe('es-ES');
   });
 
-  it('returns en-US as default when navigator.language is not available', () => {
+  it('returns null as default when navigator.language is not available', () => {
     Object.defineProperty(window.navigator, 'language', {
       value: undefined,
       configurable: true,
     });
 
-    expect(getBrowserLocale()).toBe('en-US');
+    expect(getBrowserLocale()).toBeNull();
   });
 
-  it('returns en-US when navigator.language is empty string', () => {
+  it('returns null as default when navigator.language is empty string', () => {
     Object.defineProperty(window.navigator, 'language', {
       value: '',
       configurable: true,
     });
 
-    expect(getBrowserLocale()).toBe('en-US');
+    expect(getBrowserLocale()).toBeNull();
   });
 
-  it('returns en-US when navigator object is not defined', () => {
+  it('returns null as default when navigator object is not defined', () => {
     Object.defineProperty(window, 'navigator', {
       value: undefined,
       configurable: true,
     });
 
-    expect(getBrowserLocale()).toBe('en-US');
+    expect(getBrowserLocale()).toBeNull();
   });
 });

packages/clerk-js/src/utils/locale.ts

@@ -1,14 +1,14 @@
 import { inBrowser } from '@clerk/shared/browser';
 
-const DEFAULT_LOCALE = 'en-US';
+const DEFAULT_LOCALE = null;
 
 /**
  * Detects the user's preferred locale from the browser.
- * Falls back to 'en-US' if locale cannot be determined.
+ * Falls back to null if locale cannot be determined.
  *
- * @returns The detected locale string in BCP 47 format (e.g., 'en-US', 'es-ES')
+ * @returns The detected locale string in BCP 47 format (e.g., 'en-US', 'es-ES') or null if locale cannot be determined.
  */
-export function getBrowserLocale(): string {
+export function getBrowserLocale(): string | null {
   if (!inBrowser()) {
     return DEFAULT_LOCALE;
   }