Übersicht

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

Referenz

Parameter

Parameterbeschreibung

Rückgabewert

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

Wirft

• 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']
});

// Verschiedene Sprachen benötigen eine Übersetzung
console.log(gt.requiresTranslation('en-US', 'es-ES')); // true
console.log(gt.requiresTranslation('en-US', 'fr-FR')); // true

// Gleiche Sprachen benötigen keine Übersetzung
console.log(gt.requiresTranslation('en-US', 'en-US')); // false
console.log(gt.requiresTranslation('es-ES', 'es-ES')); // false

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

// Ziel nicht in unterstützten Locales
console.log(gt.requiresTranslation('en-US', 'it-IT')); // false (it-IT nicht in unterstützten Locales)

Hinweise

• Berücksichtigt Sprachfamilien der locale, 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

• Sprachzugehörigkeiten mit isSameLanguage prüfen
• Geeignete locale mit determineLocale ermitteln
• locales mit isValidLocale validieren