@shopify/polaris/dist/esm/utilities/i18n/I18n.js

Shopify’s product component library

import { get as get$1 } from '../get.js';
import { merge as merge$1 } from '../merge.js';

var REPLACE_REGEX = /{([^}]*)}/g;
class I18n {
  /**
   * @param translation A locale object or array of locale objects that overrides default translations. If specifying an array then your desired language dictionary should come first, followed by your fallback language dictionaries
   */
  constructor(translation) {
    this.translation = {};
    // slice the array to make a shallow copy of it, so we don't accidentally
    // modify the original translation array
    this.translation = Array.isArray(translation) ? merge$1(...translation.slice().reverse()) : translation;
  }

  translate(id, replacements) {
    var text = get$1(this.translation, id, '');

    if (!text) {
      return '';
    }

    if (replacements) {
      return text.replace(REPLACE_REGEX, match => {
        var replacement = match.substring(1, match.length - 1);

        if (replacements[replacement] === undefined) {
          var replacementData = JSON.stringify(replacements);
          throw new Error("Error in translation for key '".concat(id, "'. No replacement found for key '").concat(replacement, "'. The following replacements were passed: '").concat(replacementData, "'"));
        } // This could be a string or a number, but JS doesn't mind which it gets
        // and can handle that cast internally. So let it, to save us calling
        // toString() on what's already a string in 90% of cases.


        return replacements[replacement];
      });
    }

    return text;
  }

  translationKeyExists(path) {
    return Boolean(get$1(this.translation, path));
  }

}

export { I18n };