Catalog caching

cacheMode

RuntimeI18nOptions.cacheMode chooses how loaded catalogs are retained. There are three values:

• none keeps only the active fallback chain in memory, which is good for memory-constrained apps.
• memory (default) caches every loaded catalog for the current session.
• storage hydrates catalogs from localStorage, serves them instantly on the next load, and refreshes them in the background.

provideRuntimeI18n(config, {
  options: {
    cacheMode: 'storage',
    cacheKeyPrefix: '@ngx-runtime-i18n:catalog:',
  },
});

cacheKeyPrefix

options.cacheKeyPrefix is the storage prefix used when cacheMode === 'storage'. Set it when you run multiple apps or multiple i18n instances against the same origin, so their cached catalogs don't collide in localStorage.