Translator and Language Detector APIs
The Translator interface of the Translator and Language Detector APIs contains all the associated translation functionality, including checking AI model availability, creating a new Translator instance, using it to create a translation, and more.
Instance properties
- Translator.inputQuota
- : The input quota available to the browser for generating translations.
- Translator.sourceLanguage
- : The expected language of the input text to be translated.
- Translator.targetLanguage
- : The language that the input text will be translated into.
Static methods
- Translator.availability_static
- : Returns an enumerated value that indicates the availability of the AI model for the given
Translatorconfiguration.
- : Returns an enumerated value that indicates the availability of the AI model for the given
- Translator.create_static
- : Creates a new
Translatorinstance from which to generate translations.
- : Creates a new
Instance methods
- Translator.destroy
- : Releases the resources assigned to the
Translatorinstance it is called on and stops any further activity on it.
- : Releases the resources assigned to the
- Translator.measureInputUsage
- : Reports how much input quota would be used by a translation operation for a given text input.
- Translator.translate
- : Returns a string containing a translation of the input string.
- Translator.translateStreaming
- : Generates a translation of the input string as a ReadableStream.
Examples
See Using the Translator and Language Detector APIs for a complete example.
Creating a Translator instance
const translator = await Translator.create({
sourceLanguage: "en",
targetLanguage: "ja",
});
Generating a translation
const translation = await translator.translate(myTextString);
console.log(translation);
Generating a translation stream
const stream = translator.translateStreaming(myTextString);
let translation = "";
for await (const chunk of stream) {
translation += chunk;
}
console.log("Stream complete");
console.log(translation);
Specifications
Browser compatibility
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
