Übersicht

Die Methode requiresTranslation ermittelt anhand von Quell- und Ziel-Locales, ob eine Übersetzung erforderlich ist. Sie prüft, ob der Quellinhalt übersetzt werden muss, indem sie Locale-Codes vergleicht und eine genehmigte Liste von Locales berücksichtigt.

Referenz

Parameter

Parameterbeschreibung

Rückgabewert

boolean – true, wenn eine Übersetzung erforderlich ist, sonst false

Löst aus

• Error – Wenn keine Quell-locale angegeben ist und die Instanz keine sourceLocale konfiguriert hat
• Error – Wenn keine Ziel-locale angegeben ist und die Instanz keine targetLocale konfiguriert hat

Beispiele

const gt = new GT({
  sourceLocale: 'en-US',
  targetLocale: 'es-ES',
  locales: ['en-US', 'es-ES', 'fr-FR', 'de-DE']
});

// Unterschiedliche Sprachen erfordern eine Übersetzung
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// Dieselbe Sprache erfordert keine Übersetzung
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

// Unterschiedliche Dialekte derselben Sprache erfordern keine Übersetzung
console.log(gt.requiresTranslation('en-US', 'en-GB')); // false
console.log(gt.requiresTranslation('es-ES', 'es-MX')); // false

// Ziel ist nicht in den zugelassenen locales
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT ist nicht in den zugelassenen locales)

Hinweise

• Berücksichtigt Sprachfamilien von locales, nicht nur exakte Übereinstimmungen
• Respektiert freigegebene locale-Listen
• Gibt false zurück, wenn die Ziel-locale nicht in den freigegebenen locales enthalten ist (falls angegeben)

Nächste Schritte

• Sprachbeziehungen mithilfe von isSameLanguage prüfen
• Die optimale locale mit determineLocale ermitteln
• locales mit isValidLocale validieren