Source code
Revision control
Copy as Markdown
Other Tools
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
const lazy = {};
ChromeUtils.defineESModuleGetters(lazy, {
TranslationsParent: "resource://gre/actors/TranslationsParent.sys.mjs",
});
/**
* This parent is blank because the Translations actor handles most of the features
* needed in AboutTranslations.
*/
export class AboutTranslationsParent extends JSWindowActorParent {
#isDestroyed = false;
didDestroy() {
this.#isDestroyed = true;
}
async receiveMessage({ name, data }) {
switch (name) {
case "AboutTranslations:GetTranslationsPort": {
if (this.#isDestroyed) {
return undefined;
}
const { fromLanguage, toLanguage } = data;
try {
const port = await lazy.TranslationsParent.requestTranslationsPort(
fromLanguage,
toLanguage
);
// At the time of writing, you can't return a port via the `sendQuery` API,
// so results can't just be returned. The `sendAsyncMessage` method must be
// invoked. Additionally, in the AboutTranslationsChild, the port must
// be transferred to the content page with `postMessage`.
this.sendAsyncMessage(
"AboutTranslations:SendTranslationsPort",
{
fromLanguage,
toLanguage,
port,
},
[port] // Mark the port as transferable.
);
} catch (error) {
console.error(error);
}
return undefined;
}
case "AboutTranslations:GetSupportedLanguages": {
return lazy.TranslationsParent.getSupportedLanguages();
}
case "AboutTranslations:IsTranslationsEngineSupported": {
return lazy.TranslationsParent.getIsTranslationsEngineSupported();
}
case "AboutTranslations:Telemetry": {
const { telemetryFunctionName, telemetryData } = data;
const aboutTranslationsTelemetry =
lazy.TranslationsParent.telemetry().aboutTranslationsPage();
const telemetryFunction =
aboutTranslationsTelemetry[telemetryFunctionName];
if (typeof telemetryFunction !== "function") {
throw new Error(
`Unknown AboutTranslationsTelemetry function name '${telemetryFunctionName}'`
);
}
aboutTranslationsTelemetry[telemetryFunctionName](telemetryData);
return undefined;
}
default:
throw new Error("Unknown AboutTranslations message: " + name);
}
}
}