1. module i18n-express
   1. function i18n-express (opts)

module i18n-express

function i18n-express (opts)

• description and source-code

  i18n-express = function (opts) {
    var i18nTranslations = [];
    var translationsPath = opts.translationsPath || 'i18n';
    var cookieLangName = opts.cookieLangName || 'ulang';
    var browserEnable = opts.browserEnable !== false;
    var defaultLang = opts.defaultLang || 'en';
    var paramLangName = opts.paramLangName || 'clang';
    var siteLangs = opts.siteLangs || ['en'];
    var textsVarName = opts.textsVarName || 'texts';
  
    if (siteLangs.constructor !== Array) {
      throw new Error('siteLangs must be an Array with supported langs.');
    }
  
    var computedLang = '';
  
    i18nTranslations = loadLangJSONFiles(translationsPath, defaultLang);
  
    fs.watch(translationsPath, function (event, filename) {
      if (filename) {
        try {
          i18nTranslations = loadLangJSONFiles(translationsPath, defaultLang);
        } catch (ee) {
          // Some editors first empty the file and then save the content. This generate a "Unexpected end of input" error
        }
      }
    });
  
    return function i18n (req, res, next) {
      var alreadyTryCookie = false;
      var alreadyBrowser = false;
      // set textsVarName value for tests and variable recovery
      req.app.locals.textsVarName = textsVarName;
  
      while (1) {
        if (cookieLangName && alreadyTryCookie === false) {
          var cLang = getLangFromCookie(req, cookieLangName);
          if (cLang) {
            computedLang = cLang;
            break;
          } else {
            alreadyTryCookie = true;
            continue;
          }
        } else if (browserEnable && alreadyBrowser === false) {
          var wLang = getLangFromHeaders(req);
  
          if (wLang.length) {
            computedLang = wLang[0];
            break;
          } else {
            alreadyBrowser = true;
            continue;
          }
        } else {
          computedLang = defaultLang;
        }
        if (computedLang !== '') {
          break;
        }
      }
  
        // User is setting a lang via get param. Store and use it.
      if (paramLangName in req.query) {
        if (siteLangs.indexOf(req.query[paramLangName]) > -1) {
          if (cookieLangName && req.session) {
            req.session[cookieLangName] = req.query[paramLangName].toString();
          }
          computedLang = req.query[paramLangName].toString();
        }
      }
  
      function setDefaulti18n () {
        req.app.locals[textsVarName] = i18nTranslations[defaultLang];
        req.app.locals.lang = defaultLang;
      }
  
      computedLang = computedLang.toLowerCase();
  
      // setting translations to views
  
      if (computedLang in i18nTranslations) {
        req.app.locals[textsVarName] = i18nTranslations[computedLang];
        req.app.locals.lang = computedLang;
      } else {
        if (computedLang.indexOf('-') > -1) {
            // try extract "en" from "en-US"
          var soloLang = computedLang.split('-')[0];
          if (soloLang in i18nTranslations) {
            req.app.locals[textsVarName] = i18nTranslations[soloLang];
            req.app.locals.lang = soloLang;
          } else {
            setDefaulti18n();
          }
        } else {
          setDefaulti18n();
        }
      }
  
      // req.i18n_all_texts=i18nTranslations;
      req.i18n_texts = req.app.locals[textsVarName];
      req.i18n_lang = req.app.locals.lang;
  
      next();
    };
  }

• example usage

  n/a