如何利用 Intl.DisplayNames 零依赖异步转换全球国家/语言代码的本地化名称-js教程-PHP中文网

intl.displaynames 是浏览器和 node.js（v18.0+）原生支持的国际化 api，可将 iso 国家或语言代码同步转为本地化名称，无需依赖、零网络请求，需检测支持性并妥善处理降级与非法输入。

如何利用 intl.displaynames 零依赖异步转换全球国家/语言代码的本地化名称

Intl.DisplayNames 是浏览器和 Node.js（v18.0+）原生支持的国际化 API，无需安装任何依赖，就能把 ISO 3166 国家代码（如 "CN"、"US"）或 ISO 639 语言代码（如 "zh"、"en"）异步转成对应语言环境下的本地化名称（比如在法语环境下显示 "Chine"、"États-Unis"）。

确认运行环境支持

Intl.DisplayNames 在现代浏览器中已全面支持（Chrome 90+、Firefox 96+、Safari 15.4+），Node.js 需 v18.0 或更高版本。使用前可简单检测：

if (typeof Intl.DisplayNames === 'function') {
  // ✅ 支持
} else {
  // ❌ 降级方案（如静态映射表）
}

基础用法：同步生成 DisplayNames 实例

虽然 API 本身是同步构造的，但“异步转换”实际指：先按用户语言环境动态创建实例，再调用其 of() 方法——整个流程无需网络请求，零依赖、无 bundle 体积开销。

国家名称转换示例：

const countryNames = new Intl.DisplayNames('zh-CN', { type: 'region' });
console.log(countryNames.of('US')); // "美国"
console.log(countryNames.of('JP')); // "日本"

语言名称转换示例：

const langNames = new Intl.DisplayNames('ja-JP', { type: 'language' });
console.log(langNames.of('en')); // "英語"
console.log(langNames.of('fr')); // "フランス語"

动态适配用户语言：结合 navigator.language 或 i18n 框架

真实场景中，需根据用户当前语言环境（而非写死）创建实例。可封装为一个轻量函数：

实现基于qmt智能交易终端的A股交易数据本地化

基于QMT平台，支持自然语言指令下载并实时监控A股多周期历史行情，含智能错误处理与任务控制。

下载

function getLocalizedName(code, type = 'region', locale) {
  const userLocale = locale || navigator.language || 'en-US';
  try {
    const dn = new Intl.DisplayNames(userLocale, { type });
    return dn.of(code) || code; // fallback 到原始 code
  } catch {
    return code;
  }
}

// 使用
getLocalizedName('DE', 'region');   // 如在 es-ES 下返回 "Alemania"
getLocalizedName('ko', 'language'); // 如在 pt-BR 下返回 "coreano"

注意：Intl.DisplayNames 构造时若 locale 不被完全支持（如 'zh-Hant-TW'），会自动降级到最接近的可用 locale（如 'zh-Hant' 或 'zh'），无需手动处理。