Translator: availability() statische Methode

options

Ein Objekt, das Konfigurationsoptionen für den Translator angibt. Mögliche Werte sind:

sourceLanguage

Ein String, der die Sprache des Eingabetextes angibt, der übersetzt werden soll. Dies sollte ein gültiges BCP 47 Sprach-Tag sein (wie in RFC 5646 spezifiziert).

targetLanguage

Ein String, der die Sprache angibt, in die der Eingabetext übersetzt werden soll, und der ein gültiges BCP 47 Sprach-Tag sein sollte.

Ein Promise, das sich mit einem enumerierten Wert erfüllt, der angibt, ob Unterstützung für eine gegebene Translator Konfiguration verfügbar ist (oder verfügbar sein wird), oder null, wenn die Unterstützung nicht bestimmt werden konnte.

Mögliche Werte sind:

available

Der Browser unterstützt die gegebene Konfiguration und sie kann sofort genutzt werden.

downloadable

Der Browser unterstützt die gegebene Konfiguration, aber es muss zuerst ein KI-Modell oder einige Feindaten für das Modell heruntergeladen werden.

downloading

Der Browser unterstützt die gegebene Konfiguration, muss jedoch einen laufenden Download abschließen, bevor er fortfahren kann.

unavailable

Der Browser unterstützt die gegebene Konfiguration nicht. Dieser Wert wird auch zurückgegeben, wenn die angegebenen sourceLanguage und targetLanguage identisch sind.

InvalidStateError DOMException

Wird ausgelöst, wenn das Document der Seite noch nicht aktiv ist.

OperationError DOMException

Wird ausgelöst, wenn die Initialisierung des KI-Modells aus irgendeinem Grund fehlgeschlagen ist.

UnknownError DOMException

Wird ausgelöst, wenn der availability()-Aufruf aus einem anderen Grund fehlgeschlagen ist, oder aus einem Grund, den der Nutzer-Agent nicht offenlegen wollte.

Wenn die Nutzung der Methode durch eine translator Permissions-Policy blockiert wird, lehnt das Promise mit einem Wert von unavailable ab.

Im folgenden Beispiel überprüfen wir zuerst die Verfügbarkeit des Modells für die Übersetzung zwischen zwei Sprachen mit der Methode availability():

• Wenn sie unavailable zurückgibt, drucken wir eine entsprechende Fehlermeldung in die Konsole.
• Wenn sie available zurückgibt, erstellen wir einen Translator mit der Methode create(), indem wir die Quell- und Zielsprachen übergeben. Das erforderliche KI-Modell ist verfügbar, daher können wir es sofort verwenden.
• Wenn sie einen anderen Wert zurückgibt (das heißt, downloadable oder downloading), führen wir denselben create()-Methodenaufruf aus, jedoch diesmal mit einem monitor, der jedes Mal, wenn das downloadprogress Ereignis ausgelöst wird, den Prozentsatz des heruntergeladenen Modells protokolliert.

async function getTranslator(languages) {
  const availability = await Translator.availability(languages);

  if (availability === "unavailable") {
    console.log(
      `Translation not supported; try a different language combination.`,
    );
    return undefined;
  } else if (availability === "available") {
    return await Translator.create(languages);
  }
  return await Translator.create({
    ...languages,
    monitor(monitor) {
      monitor.addEventListener("downloadprogress", (e) => {
        console.log(`Downloaded ${Math.floor(e.loaded * 100)}%`);
      });
    },
  });
}

const translator = await getTranslator({
  sourceLanguage: "en",
  targetLanguage: "ja",
});

• Verwendung der Translator und Language Detector APIs