zulip/static/js/translations.js

// commonjs code goes here

import i18next from 'i18next';
import XHR from 'i18next-xhr-backend';
import LngDetector from 'i18next-browser-languagedetector';
import Cache from 'i18next-localstorage-cache';

window.i18n = i18next;

var backendOptions = {
    loadPath: '/static/locale/__lng__/translations.json',
};
var callbacks = [];
var initialized = false;

var detectionOptions = {
    order: ['htmlTag'],
    htmlTag: document.documentElement,
};

var cacheOptions = {
    enabled: true,
    prefix: 'i18next:' + page_params.server_generation + ':',
    expirationTime: 2*7*24*60*60*1000,  // 2 weeks
};

i18next.use(XHR)
    .use(LngDetector)
    .use(Cache)
    .init({
        nsSeparator: false,
        keySeparator: false,
        interpolation: {
            prefix: "__",
            suffix: "__",
        },
        backend: backendOptions,
        detection: detectionOptions,
        cache: cacheOptions,
        fallbackLng: 'en',
    }, function () {
        var i;
        initialized = true;
        for (i=0; i<callbacks.length; i += 1) {
            callbacks[i]();
        }
    });

i18next.ensure_i18n = function (callback) {
    if (initialized) {
        callback();
    } else {
        callbacks.push(callback);
    }
};

// garbage collect all old i18n translation maps in localStorage.
$(function () {
    // this collects all localStorage keys that match the format of:
    //   i18next:dddddddddd:w+ => 1484902202:en
    // these are all language translation strings.
    var translations = Object.keys(localStorage).filter(function (key) {
        return /^i18next:\d{10}:\w+$/.test(key);
    });

    // by sorting them we get the lowest timestamps at the bottom and the
    // most recent at the top.
    translations = translations.sort();

    // Remove the latest few translations (should include the
    // currently in-use one for this and any recent tabs) from the
    // list of items to delete.
    translations.pop();
    translations.pop();
    translations.pop();

    // remove all the old translations.
    translations.forEach(function (translation_key) {
        localStorage.removeItem(translation_key);
    });
    return this;
});