/* Any copyright is dedicated to the Public Domain. http://creativecommons.org/publicdomain/zero/1.0/ */ "use strict"; /** * @type {typeof import("../../content/translations-document.sys.mjs")} */ const { TranslationsDocument } = ChromeUtils.importESModule( "chrome://global/content/translations/translations-document.sys.mjs" ); /** * @param {string} html * @param {{ * fakeTranslator?: (message: string) => Promise * }} [options] */ async function createDoc(html, options) { await SpecialPowers.pushPrefEnv({ set: [ ["browser.translations.enable", true], ["browser.translations.logLevel", "All"], ], }); const parser = new DOMParser(); const document = parser.parseFromString(html, "text/html"); /** * Fake translations by converting them to uppercase. * @param {string} message */ async function fakeTranslator(message) { /** * @param {Node} node */ function upperCaseNode(node) { if (typeof node.nodeValue === "string") { node.nodeValue = node.nodeValue.toUpperCase(); } for (const childNode of node.childNodes) { upperCaseNode(childNode); } } const translatedDoc = parser.parseFromString(message, "text/html"); upperCaseNode(translatedDoc.body); return [translatedDoc.body.innerHTML]; } const translationsDocument = new TranslationsDocument( document, "en", 0, // This is a fake innerWindowID options?.fakeTranslator ?? fakeTranslator, options?.fakeTranslator ?? fakeTranslator ); /** * Test utility to check that the document matches the expected markup * * @param {string} html */ async function htmlMatches(message, html) { const expected = naivelyPrettify(html); try { await BrowserTestUtils.waitForCondition( () => naivelyPrettify(document.body.innerHTML) === expected, "Waiting for HTML to match." ); ok(true, message); } catch (error) { console.error(error); // Provide a nice error message. const actual = naivelyPrettify(document.body.innerHTML); ok( false, `${message}\n\nExpected HTML:\n\n${expected}\n\nActual HTML:\n\n${actual}\n\n` ); } } function translate() { info("Running translation."); translationsDocument.addRootElement(document.body); } function cleanup() { SpecialPowers.popPrefEnv(); } return { translate, htmlMatches, cleanup, translationsDocument, document }; } add_task(async function test_translated_div_element() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
This is a simple translation.
`); await htmlMatches( "The document starts out as expected.", /* html */ `
This is a simple translation.
` ); translate(); await htmlMatches( "A single element with a single text node is translated into uppercase.", /* html */ `
THIS IS A SIMPLE TRANSLATION.
` ); cleanup(); }); add_task(async function test_translated_textnode() { const { translate, htmlMatches, cleanup } = await createDoc( "This is a simple text translation." ); translate(); await htmlMatches( "A Text node at the root is translated into all caps", "THIS IS A SIMPLE TEXT TRANSLATION." ); cleanup(); }); add_task(async function test_no_text_trees() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
`); translate(); await htmlMatches( "Trees with no text are not affected", /* html */ `
` ); cleanup(); }); add_task(async function test_no_text_trees() { const { translate, htmlMatches, cleanup } = await createDoc(""); translate(); await htmlMatches("No text is still no text", ""); cleanup(); }); add_task(async function test_translated_title() { const { cleanup, document, translationsDocument } = await createDoc(/* html */ ` This is an actual full page. `); info("The title element is the only element that is used as a root."); translationsDocument.addRootElement( document.getElementsByTagName("title")[0] ); const translatedTitle = "THIS IS AN ACTUAL FULL PAGE."; try { await BrowserTestUtils.waitForCondition( () => document.title === translatedTitle ); } catch (error) {} is(document.title, translatedTitle, "The title was changed."); cleanup(); }); add_task(async function test_translated_nested_elements() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ ` `); translate(); await htmlMatches( "The nested elements are translated into all caps.", /* html */ ` ` ); cleanup(); }); /** * Only translate elements with a matching "from" language. */ add_task(async function test_translated_language() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
No lang property
Language matches
Language mismatch is ignored.
Language match with region.
Language mismatch with
nested elements.
`); translate(); await htmlMatches( "Language matching of elements behaves as expected.", /* html */ `
NO LANG PROPERTY
LANGUAGE MATCHES
Language mismatch is ignored.
LANGUAGE MATCH WITH REGION.
Language mismatch with
nested elements.
` ); cleanup(); }); /** * Test elements that have been marked as ignored. */ add_task(async function test_ignored_translations() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
This is translated.
This is not translated.
This is not translated.
This is not translated.
This is not translated.
This is not translated.
This is translated.
`); translate(); await htmlMatches( "Language matching of elements behaves as expected.", /* html */ `
THIS IS TRANSLATED.
This is not translated.
This is not translated.
This is not translated.
This is not translated.
This is not translated.
THIS IS TRANSLATED.
` ); cleanup(); }); /** * Test excluded tags. */ add_task(async function test_excluded_tags() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
This is translated.
This is ignored `); translate(); await htmlMatches( "EXCLUDED_TAGS are not translated", /* html */ `
THIS IS TRANSLATED.
This is ignored ` ); cleanup(); }); add_task(async function test_comments() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
This is translated.
`); translate(); await htmlMatches( "Comments do not affect things.", /* html */ `
THIS IS TRANSLATED.
` ); cleanup(); }); /** * Test the batching behavior on what is sent in for a translation. */ add_task(async function test_translation_batching() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
This is a simple section.
This entire section continues in a batch.
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); await htmlMatches( "Batching", /* html */ `
aaaa aa a aaaaaa aaaaaaa.
bbbb bbbbbb bbbbbbb bbbbbbbbb bb b bbbbb .
` ); cleanup(); }); /** * Test what happens when there are many inline elements. */ add_task(async function test_many_inlines() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
This is a much longer section that includes many span elements to test what happens in cases like this.
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); await htmlMatches( "Batching", /* html */ `
aaaa aa a aaaa aaaaaa aaaaaaa aaaa aaaaaaaa aaaa aaaa aaaaaaaa aa aaaa aaaa aaaaaaa aa aaaaa aaaa aaaa.
` ); cleanup(); }); /** * Test what happens when there are many inline elements. */ add_task(async function test_many_inlines() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
This is a
much longer
section that includes
many div elements
to test what happens
in cases like this.
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); await htmlMatches( "Batching", /* html */ `
aaaa aa a
bbbb bbbbbb
ccccccc cccc cccccccc
dddd ddd dddddddd
ee eeee eeee eeeeeee
ff fffff ffff ffff.
` ); cleanup(); }); /** * Test the "presumed" inline content behavior. */ add_task(async function test_presumed_inlines1() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
Text node
Block element
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); await htmlMatches( "Mixing a text node with otherwise block elements will send it all in as one batch.", /* html */ `
aaaa aaaa
aaaaa aaaaaaa
` ); cleanup(); }); /** * Test what happens when there are many inline elements. */ add_task(async function test_presumed_inlines2() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
Text node Inline
Block Element
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); await htmlMatches( "Conflicting inline and block elements will be sent in together if there are more inlines", /* html */ `
aaaa aaaa aaaaaa
aaaaa aaaaaaa
` ); cleanup(); }); add_task(async function test_presumed_inlines3() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
Text node Inline
Block Element
Block Element
Block Element
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); // TODO - There is a bug in the implementation, see the untranslated "Text node" below. // this was in the original implementation. await htmlMatches( "Conflicting inlines will be sent in as separate blocks if there are more block elements", /* html */ `
Text node aaaaaa
bbbbb bbbbbbb
ccccc ccccccc
ddddd ddddddd
` ); cleanup(); }); add_task(async function test_chunking_large_text() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ `
        Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque fermentum est ante, ut porttitor enim molestie et. Nam mattis ullamcorper justo a ultrices. Ut ac sodales lorem. Sed feugiat ultricies lacus. Proin dapibus sit amet nunc a ullamcorper. Donec leo purus, convallis quis urna non, semper pulvinar augue. Nulla placerat turpis arcu, sit amet imperdiet sapien tincidunt ut. Donec sit amet luctus lorem, sed consectetur lectus. Pellentesque est nisi, feugiat et ipsum quis, vestibulum blandit nulla.

        Proin accumsan sapien ut nibh mattis tincidunt. Donec facilisis nibh sodales, mattis risus et, malesuada lorem. Nam suscipit lacinia venenatis. Praesent ac consectetur ante. Vestibulum pulvinar ut massa in viverra. Nunc tincidunt tortor nunc. Vivamus sit amet hendrerit mi. Aliquam posuere velit non ante facilisis euismod. In ullamcorper, lacus vel hendrerit tincidunt, dui justo iaculis nulla, sit amet tincidunt nisl magna et urna. Sed varius tincidunt ligula. Interdum et malesuada fames ac ante ipsum primis in faucibus. Nam sed gravida ligula. Donec tincidunt arcu eros, ac maximus magna auctor eu. Vivamus suscipit neque velit, in ullamcorper elit pulvinar et. Morbi auctor tempor risus, imperdiet placerat velit gravida vel. Duis ultricies accumsan libero quis molestie.

        Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia curae; Etiam nec arcu dapibus enim vulputate vulputate aliquet a libero. Nam hendrerit pulvinar libero, eget posuere quam porta eu. Pellentesque dignissim justo eu leo accumsan, sit amet suscipit ante gravida. Vivamus eu faucibus orci. Quisque sagittis tortor eget orci venenatis porttitor. Quisque mollis ipsum a dignissim dignissim.

        Aenean sagittis nisi lectus, non lacinia orci dapibus viverra. Donec diam lorem, tincidunt sed massa vel, vulputate tincidunt metus. In quam felis, egestas et faucibus faucibus, vestibulum quis tortor. Morbi odio mi, suscipit vitae leo in, consequat interdum augue. Quisque purus velit, dictum ac ante eget, volutpat dapibus ante. Suspendisse quis augue vitae velit elementum dictum nec aliquet nisl. Maecenas vestibulum quam augue, eu maximus urna blandit eu. Donec nunc risus, elementum id ligula nec, ultrices venenatis libero. Suspendisse ullamcorper ex ante, malesuada pulvinar sem placerat vel.

        In hac habitasse platea dictumst. Duis vulputate tellus arcu, at posuere ligula viverra luctus. Fusce ultrices malesuada neque vitae vehicula. Aliquam blandit nisi sed nibh facilisis, non varius turpis venenatis. Vestibulum ut velit laoreet, sagittis leo ac, pharetra ex. Aenean mollis risus sed nibh auctor, et feugiat neque iaculis. Fusce fermentum libero metus, at consectetur massa euismod sed. Mauris ut metus sit amet leo porttitor mollis. Vivamus tincidunt lorem non purus suscipit sollicitudin. Maecenas ut tristique elit. Ut eu volutpat turpis. Suspendisse nec tristique augue. Nullam faucibus egestas volutpat. Sed tempor eros et mi ultrices, nec feugiat eros egestas.
      
`, { fakeTranslator: createBatchFakeTranslator() } ); translate(); await htmlMatches( "Large chunks of text can be still sent in for translation in one big pass, " + "this could be slow bad behavior for the user.", /* html */ `
        aaaaa aaaaa aaaaa aaa aaaa, aaaaaaaaaaa aaaaaaaaaa aaaa. aaaaaaa aaaaaaaaa aaa aaaa, aa aaaaaaaaa aaaa aaaaaaaa aa. aaa aaaaaa aaaaaaaaaaa aaaaa a aaaaaaaa. aa aa aaaaaaa aaaaa. aaa aaaaaaa aaaaaaaaa aaaaa. aaaaa aaaaaaa aaa aaaa aaaa a aaaaaaaaaaa. aaaaa aaa aaaaa, aaaaaaaaa aaaa aaaa aaa, aaaaaa aaaaaaaa aaaaa. aaaaa aaaaaaaa aaaaaa aaaa, aaa aaaa aaaaaaaaa aaaaaa aaaaaaaaa aa. aaaaa aaa aaaa aaaaaa aaaaa, aaa aaaaaaaaaaa aaaaaa. aaaaaaaaaaaa aaa aaaa, aaaaaaa aa aaaaa aaaa, aaaaaaaaaa aaaaaaa aaaaa.

        aaaaa aaaaaaaa aaaaaa aa aaaa aaaaaa aaaaaaaaa. aaaaa aaaaaaaaa aaaa aaaaaaa, aaaaaa aaaaa aa, aaaaaaaaa aaaaa. aaa aaaaaaaa aaaaaaa aaaaaaaaa. aaaaaaaa aa aaaaaaaaaaa aaaa. aaaaaaaaaa aaaaaaaa aa aaaaa aa aaaaaaa. aaaa aaaaaaaaa aaaaaa aaaa. aaaaaaa aaa aaaa aaaaaaaaa aa. aaaaaaa aaaaaaa aaaaa aaa aaaa aaaaaaaaa aaaaaaa. aa aaaaaaaaaaa, aaaaa aaa aaaaaaaaa aaaaaaaaa, aaa aaaaa aaaaaaa aaaaa, aaa aaaa aaaaaaaaa aaaa aaaaa aa aaaa. aaa aaaaaa aaaaaaaaa aaaaaa. aaaaaaaa aa aaaaaaaaa aaaaa aa aaaa aaaaa aaaaaa aa aaaaaaaa. aaa aaa aaaaaaa aaaaaa. aaaaa aaaaaaaaa aaaa aaaa, aa aaaaaaa aaaaa aaaaaa aa. aaaaaaa aaaaaaaa aaaaa aaaaa, aa aaaaaaaaaaa aaaa aaaaaaaa aa. aaaaa aaaaaa aaaaaa aaaaa, aaaaaaaaa aaaaaaaa aaaaa aaaaaaa aaa. aaaa aaaaaaaaa aaaaaaaa aaaaaa aaaa aaaaaaaa.

        aaaaaaaaaa aaaa aaaaa aaaaaa aa aaaaaaaa aaaa aaaaaa aa aaaaaaaa aaaaaaa aaaaaaa aaaaa; aaaaa aaa aaaa aaaaaaa aaaa aaaaaaaaa aaaaaaaaa aaaaaaa a aaaaaa. aaa aaaaaaaaa aaaaaaaa aaaaaa, aaaa aaaaaaa aaaa aaaaa aa. aaaaaaaaaaaa aaaaaaaaa aaaaa aa aaa aaaaaaaa, aaa aaaa aaaaaaaa aaaa aaaaaaa. aaaaaaa aa aaaaaaaa aaaa. aaaaaaa aaaaaaaa aaaaaa aaaa aaaa aaaaaaaaa aaaaaaaaa. aaaaaaa aaaaaa aaaaa a aaaaaaaaa aaaaaaaaa.

        aaaaaa aaaaaaaa aaaa aaaaaa, aaa aaaaaaa aaaa aaaaaaa aaaaaaa. aaaaa aaaa aaaaa, aaaaaaaaa aaa aaaaa aaa, aaaaaaaaa aaaaaaaaa aaaaa. aa aaaa aaaaa, aaaaaaa aa aaaaaaaa aaaaaaaa, aaaaaaaaaa aaaa aaaaaa. aaaaa aaaa aa, aaaaaaaa aaaaa aaa aa, aaaaaaaaa aaaaaaaa aaaaa. aaaaaaa aaaaa aaaaa, aaaaaa aa aaaa aaaa, aaaaaaaa aaaaaaa aaaa. aaaaaaaaaaa aaaa aaaaa aaaaa aaaaa aaaaaaaaa aaaaaa aaa aaaaaaa aaaa. aaaaaaaa aaaaaaaaaa aaaa aaaaa, aa aaaaaaa aaaa aaaaaaa aa. aaaaa aaaa aaaaa, aaaaaaaaa aa aaaaaa aaa, aaaaaaaa aaaaaaaaa aaaaaa. aaaaaaaaaaa aaaaaaaaaaa aa aaaa, aaaaaaaaa aaaaaaaa aaa aaaaaaaa aaa.

        aa aaa aaaaaaaaa aaaaaa aaaaaaaa. aaaa aaaaaaaaa aaaaaa aaaa, aa aaaaaaa aaaaaa aaaaaaa aaaaaa. aaaaa aaaaaaaa aaaaaaaaa aaaaa aaaaa aaaaaaaa. aaaaaaa aaaaaaa aaaa aaa aaaa aaaaaaaaa, aaa aaaaaa aaaaaa aaaaaaaaa. aaaaaaaaaa aa aaaaa aaaaaaa, aaaaaaaa aaa aa, aaaaaaaa aa. aaaaaa aaaaaa aaaaa aaa aaaa aaaaaa, aa aaaaaaa aaaaa aaaaaaa. aaaaa aaaaaaaaa aaaaaa aaaaa, aa aaaaaaaaaaa aaaaa aaaaaaa aaa. aaaaaa aa aaaaa aaa aaaa aaa aaaaaaaaa aaaaaa. aaaaaaa aaaaaaaaa aaaaa aaa aaaaa aaaaaaaa aaaaaaaaaaaa. aaaaaaaa aa aaaaaaaaa aaaa. aa aa aaaaaaaa aaaaaa. aaaaaaaaaaa aaa aaaaaaaaa aaaaa. aaaaaa aaaaaaaa aaaaaaa aaaaaaaa. aaa aaaaaa aaaa aa aa aaaaaaaa, aaa aaaaaaa aaaa aaaaaaa.
    
` ); cleanup(); }); add_task(async function test_reordering() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ ` B - This was first. A - This was second. C - This was third. `, { fakeTranslator: reorderingTranslator } ); translate(); await htmlMatches( "Nodes can be re-ordered by the translator", /* html */ ` A - THIS WAS SECOND. B - THIS WAS FIRST. C - THIS WAS THIRD. ` ); cleanup(); }); add_task(async function test_reordering2() { const { translate, htmlMatches, cleanup } = await createDoc( /* html */ ` B - This was first. A - This was second. C - This was third. `, { fakeTranslator: reorderingTranslator } ); translate(); // Note: ${" "} is used below to ensure that the whitespace is not stripped from // the test. await htmlMatches( "Text nodes can be re-ordered.", /* html */ ` A - THIS WAS SECOND. B - THIS WAS FIRST. ${" "} C - THIS WAS THIRD. ` ); cleanup(); }); add_task(async function test_mutations() { const { translate, htmlMatches, cleanup, document } = await createDoc(/* html */ `
This is a simple translation.
`); translate(); await htmlMatches( "It translates.", /* html */ `
THIS IS A SIMPLE TRANSLATION.
` ); info('Trigger the "childList" mutation.'); const div = document.createElement("div"); div.innerText = "This is an added node."; document.body.appendChild(div); await htmlMatches( "The added node gets translated.", /* html */ `
THIS IS A SIMPLE TRANSLATION.
THIS IS AN ADDED NODE.
` ); info('Trigger the "characterData" mutation.'); document.querySelector("div").firstChild.nodeValue = "This is a changed node."; await htmlMatches( "The changed node gets translated", /* html */ `
THIS IS A CHANGED NODE.
THIS IS AN ADDED NODE.
` ); cleanup(); }); add_task(async function test_tables() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ `
Table header 1 Table header 2
Table data 1 Table data 2
`); translate(); await htmlMatches( "Tables are correctly translated.", /* html */ `
TABLE HEADER 1 TABLE HEADER 2
TABLE DATA 1 TABLE DATA 2
` ); cleanup(); }); // TODO(Bug 1819205) - Attribute support needs to be added.รง add_task(async function test_attributes() { const { translate, htmlMatches, cleanup } = await createDoc(/* html */ ` `); translate(); // This is what this test should assert: // eslint-disable-next-line no-unused-vars const actualExpected = /* html */ ` `; await htmlMatches( "Placeholders support needs to be added", /* html */ ` ` ); cleanup(); });