|
| 1 | +/* i18n smoke test for web/i18n.js |
| 2 | + * |
| 3 | + * Confirms: |
| 4 | + * - All non-English locales define every key that English defines (no |
| 5 | + * accidental missing-key gaps that would silently fall back to English). |
| 6 | + * - normalizeLocale() maps representative real-world tags correctly: |
| 7 | + * en-GB → en, fr-CA → fr, zh-CN/zh-SG → zh-Hans, |
| 8 | + * zh-HK/zh-TW/yue-HK → zh-Hant, fil-PH/tl-PH → fil, |
| 9 | + * unknown → null |
| 10 | + * - Auto-detect picks the first supported tag from navigator.languages. |
| 11 | + * |
| 12 | + * Run: node tests/web/i18n_smoke.mjs |
| 13 | + */ |
| 14 | +import { readFileSync } from 'fs'; |
| 15 | +import { fileURLToPath } from 'url'; |
| 16 | +import { dirname, resolve } from 'path'; |
| 17 | + |
| 18 | +const __dirname = dirname(fileURLToPath(import.meta.url)); |
| 19 | +const I18N_JS = resolve(__dirname, '..', '..', 'web/i18n.js'); |
| 20 | + |
| 21 | +function assert(cond, msg) { |
| 22 | + if (!cond) { |
| 23 | + console.error('FAIL:', msg); |
| 24 | + process.exit(1); |
| 25 | + } |
| 26 | +} |
| 27 | + |
| 28 | +function makeDom() { |
| 29 | + const els = {}; |
| 30 | + const make = () => ({ |
| 31 | + _txt: '', _cls: '', value: '', disabled: false, |
| 32 | + innerHTML: '', |
| 33 | + setAttribute() {}, getAttribute() { return null; }, |
| 34 | + appendChild() {}, addEventListener() {}, |
| 35 | + querySelectorAll: () => [], |
| 36 | + }); |
| 37 | + return { |
| 38 | + documentElement: { lang: 'en', dir: 'ltr' }, |
| 39 | + readyState: 'complete', |
| 40 | + getElementById: () => null, |
| 41 | + addEventListener: () => {}, |
| 42 | + querySelectorAll: () => [], |
| 43 | + createElement: () => make(), |
| 44 | + }; |
| 45 | +} |
| 46 | + |
| 47 | +// `navigator` is a getter-only accessor on globalThis in Node >= 21, so a |
| 48 | +// direct assignment throws. defineProperty works whether the global is unset |
| 49 | +// (Node 20) or a built-in getter (Node 22+/24+). We use the same helper for |
| 50 | +// every shim so behavior is uniform regardless of which globals the runtime |
| 51 | +// has already populated. |
| 52 | +function setGlobal(name, value) { |
| 53 | + Object.defineProperty(globalThis, name, { |
| 54 | + value, |
| 55 | + writable: true, |
| 56 | + configurable: true, |
| 57 | + enumerable: false, |
| 58 | + }); |
| 59 | +} |
| 60 | + |
| 61 | +async function loadI18n({ languages = ['en'] } = {}) { |
| 62 | + setGlobal('document', makeDom()); |
| 63 | + setGlobal('window', { |
| 64 | + addEventListener() {}, |
| 65 | + dispatchEvent() {}, |
| 66 | + }); |
| 67 | + setGlobal('location', { href: 'http://localhost/', hash: '', search: '' }); |
| 68 | + setGlobal('history', { replaceState() {} }); |
| 69 | + setGlobal('navigator', { languages, language: languages[0] }); |
| 70 | + setGlobal('localStorage', undefined); |
| 71 | + setGlobal('URL', URL); |
| 72 | + setGlobal('URLSearchParams', URLSearchParams); |
| 73 | + setGlobal('CustomEvent', class CustomEvent { |
| 74 | + constructor(n, o) { this.name = n; this.detail = o && o.detail; } |
| 75 | + }); |
| 76 | + |
| 77 | + const src = readFileSync(I18N_JS, 'utf8') + `\n//# salt=${Math.random()}\n`; |
| 78 | + await import('data:text/javascript;base64,' + Buffer.from(src).toString('base64')); |
| 79 | + return globalThis.window.i18n; |
| 80 | +} |
| 81 | + |
| 82 | +async function main() { |
| 83 | + const i18n = await loadI18n(); |
| 84 | + assert(i18n, 'window.i18n must be exposed'); |
| 85 | + |
| 86 | + // ---- normalizeLocale ---- |
| 87 | + const cases = [ |
| 88 | + ['en-GB', 'en'], |
| 89 | + ['en-US', 'en'], |
| 90 | + ['fr-CA', 'fr'], |
| 91 | + ['fr', 'fr'], |
| 92 | + ['es-419', 'es'], |
| 93 | + ['pt-BR', 'pt'], |
| 94 | + ['de-AT', 'de'], |
| 95 | + ['it-CH', 'it'], |
| 96 | + ['ja-JP', 'ja'], |
| 97 | + ['ko-KR', 'ko'], |
| 98 | + ['hi-IN', 'hi'], |
| 99 | + ['zh', 'zh-Hans'], |
| 100 | + ['zh-CN', 'zh-Hans'], |
| 101 | + ['zh-SG', 'zh-Hans'], |
| 102 | + ['zh-Hans', 'zh-Hans'], |
| 103 | + ['zh-HK', 'zh-Hant'], |
| 104 | + ['zh-TW', 'zh-Hant'], |
| 105 | + ['zh-Hant', 'zh-Hant'], |
| 106 | + ['yue', 'zh-Hant'], |
| 107 | + ['yue-HK', 'zh-Hant'], |
| 108 | + ['fil', 'fil'], |
| 109 | + ['fil-PH', 'fil'], |
| 110 | + ['tl', 'fil'], |
| 111 | + ['tl-PH', 'fil'], |
| 112 | + ['ar', 'ar'], |
| 113 | + ['ar-SA', 'ar'], |
| 114 | + ['xx-YY', null], |
| 115 | + ['', null], |
| 116 | + ]; |
| 117 | + for (const [tag, want] of cases) { |
| 118 | + const got = i18n.normalizeLocale(tag); |
| 119 | + assert(got === want, `normalizeLocale(${JSON.stringify(tag)}) → ${got}, want ${want}`); |
| 120 | + } |
| 121 | + |
| 122 | + // ---- key coverage ---- |
| 123 | + const L = i18n._LOCALES; |
| 124 | + const enKeys = Object.keys(L.en).filter((k) => k[0] !== '_'); |
| 125 | + for (const code of i18n.supported()) { |
| 126 | + if (code === 'en') continue; |
| 127 | + const missing = enKeys.filter((k) => !(k in L[code])); |
| 128 | + assert(missing.length === 0, `locale ${code} missing keys: ${missing.join(', ')}`); |
| 129 | + assert(L[code]._name, `locale ${code} missing _name`); |
| 130 | + assert(L[code]._dir === 'ltr' || L[code]._dir === 'rtl', |
| 131 | + `locale ${code} bad _dir: ${L[code]._dir}`); |
| 132 | + } |
| 133 | + |
| 134 | + // ---- supported list contains the requested set ---- |
| 135 | + const want = ['en', 'es', 'fr', 'de', 'it', 'pt', |
| 136 | + 'zh-Hans', 'zh-Hant', 'ja', 'ko', 'hi', 'fil', 'ar']; |
| 137 | + for (const code of want) { |
| 138 | + assert(i18n.supported().indexOf(code) >= 0, `expected locale ${code} to be supported`); |
| 139 | + } |
| 140 | + |
| 141 | + // ---- t() interpolates positional args ---- |
| 142 | + i18n.setLocale('en'); |
| 143 | + const s = i18n.t('refreshed', 1234); |
| 144 | + assert(s.includes('1234'), `expected interpolation, got: ${s}`); |
| 145 | + |
| 146 | + // ---- t() falls back to English on missing key in non-English locale ---- |
| 147 | + i18n.setLocale('fr'); |
| 148 | + const fr = i18n.t('hero_title'); |
| 149 | + assert(fr && fr !== 'hero_title' && fr !== 'Offline MAC Address Lookup', |
| 150 | + `expected French hero_title, got: ${fr}`); |
| 151 | + |
| 152 | + // ---- direction switches on Arabic ---- |
| 153 | + i18n.setLocale('ar'); |
| 154 | + assert(document.documentElement.dir === 'rtl', 'expected dir=rtl for ar'); |
| 155 | + assert(document.documentElement.lang === 'ar', 'expected lang=ar for ar'); |
| 156 | + i18n.setLocale('en'); |
| 157 | + assert(document.documentElement.dir === 'ltr', 'expected dir=ltr for en'); |
| 158 | + |
| 159 | + console.log('OK — i18n smoke test passes'); |
| 160 | +} |
| 161 | + |
| 162 | +main().catch((e) => { console.error('test threw:', e); process.exit(1); }); |
0 commit comments