sanity/src/core/i18n/localeStore.ts

Sanity is a real-time content infrastructure with a scalable, hosted backend featuring a Graph Oriented Query Language (GROQ), asset pipelines and fast edge caches

import {supportsLocalStorage} from '../util/supportsLocalStorage'

/**
 * @todo Rework to use settings store
 */

const LOCAL_STORAGE_PREFIX = 'sanity-locale'

/**
 * Get the users' preferred locale, if any
 *
 * @param projectId - Project ID to segment on
 * @param sourceId - Source ID to segment on
 * @returns Locale identifier, or `undefined`
 * @internal
 * @hidden
 */
export function getPreferredLocale(projectId: string, sourceId: string): string | undefined {
  if (!supportsLocalStorage) {
    return undefined
  }
  const locale = localStorage.getItem(getItemKey(projectId, sourceId))
  return locale ?? undefined
}

/**
 * Store the users' preferred locale
 *
 * @param projectId - Project ID to segment on
 * @param sourceId - Source ID to segment on
 * @param locale - Locale to store
 * @returns
 * @internal
 * @hidden
 */
export function storePreferredLocale(projectId: string, sourceId: string, locale: string): void {
  if (!supportsLocalStorage) {
    return
  }
  localStorage.setItem(getItemKey(projectId, sourceId), locale)
}

/**
 * Get the key used to store the setting in localStorage
 *
 * @param projectId - Project ID to segment on
 * @param sourceId - Source ID to segment on
 * @returns Storage key
 * @internal
 */
function getItemKey(projectId: string, sourceId: string) {
  return [LOCAL_STORAGE_PREFIX, projectId, sourceId].join(':')
}