frontend/src/common/gettext.js - develop - githubmirror/photoprism

frontend/src/common/gettext.js
97 строк3 KB
Michael Mayer
Frontend: Harden i18n positional shim against literal % in translations #5682
23 июн 2026, 16:30
23 июн 2026, 16:3095ae2be
import { createGettext as vue3Gettext } from "vue3-gettext";

function interpolate(message, params = {}) {
  if (message === null || message === undefined) {
    return "";
  }

  const text = String(message);

  if (!params || typeof params !== "object") {
    return text;
  }

  return text.replace(/%\{(\w+)\}/g, (_, key) => {
    if (!Object.prototype.hasOwnProperty.call(params, key)) {
      return "";
    }

    const value = params[key];
    return value === undefined || value === null ? "" : String(value);
  });
}

// interpolatePositional substitutes Go printf verbs (%s, %d, %v, %%, …) sequentially from an
// ordered params array, bridging the backend's positional placeholders to the frontend runtime.
// The verb must be a real Go fmt letter and no space flag is allowed, so a literal percent in a
// translated string (e.g. "100% sicher") is not mistaken for a verb and corrupted.
function interpolatePositional(message, params) {
  if (message === null || message === undefined) {
    return "";
  }

  const text = String(message);

  if (!Array.isArray(params) || params.length === 0) {
    return text;
  }

  let i = 0;

  return text.replace(/%(%|[-+0#]*\d*(?:\.\d+)?[vTtbcdoOqxXUeEfFgGsp])/g, (match, verb) => {
    if (verb === "%") {
      return "%";
    }

    if (i >= params.length) {
      return match;
    }

    const value = params[i++];
    return value === undefined || value === null ? "" : String(value);
  });
}

export let gettext = {
  $gettext: (msgid, params) => interpolate(msgid, params),
  $ngettext: (msgid, plural, n, params) => interpolate(n > 1 ? plural : msgid, params),
  $pgettext: (context, msgid, params) => interpolate(msgid, params),
  $npgettext: (domain, context, msgid, plural, n, params) => interpolate(n > 1 ? plural : msgid, params),
};

export function T(msgid, params) {
  return gettext.$gettext(msgid, params);
}

// Tp translates a backend message by its English source id, then substitutes the ordered
// positional params, so backend notifications render in the current UI language.
export function Tp(msgid, params) {
  return interpolatePositional(gettext.$gettext(msgid), params);
}

export function $gettext(msgid, params) {
  return gettext.$gettext(msgid, params);
}

export function $ngettext(msgid, plural, n) {
  return gettext.$ngettext(msgid, plural, n);
}

export function $pgettext(context, msgid, params) {
  return gettext.$pgettext(context, msgid, params);
}

export function $npgettext(domain, context, msgid, plural, n) {
  return gettext.$npgettext(domain, context, msgid, plural, n);
}

export function createGettext(config) {
  gettext = vue3Gettext({
    translations: config.translations,
    silent: true, // !config.values.debug,
    defaultLanguage: config.getLanguageLocale(),
    // autoAddKeyAttributes: true,
  });

  return gettext;
}