npm 包 cldr-data-downloader 使用教程

随着 Web 应用程序的不断发展，越来越多的开发者开始关注国际化和本地化问题。而 CLDR（Common Locale Data Repository，通用地域数据存储库）则是很好的一个解决方案。而本文将介绍一下 npm 包 cldr-data-downloader，它是一个使用简单方便，可自动下载并缓存 CLDR 数据的工具。

安装

你可以通过 npm 来安装 cldr-data-downloader：

npm install cldr-data-downloader

或者你也可以通过 yarn 来安装：

yarn add cldr-data-downloader

使用

基本用法

首先，你需要将 cldr-data-downloader 导入你的项目中：

import cldrDataDownloader from 'cldr-data-downloader';

现在，你可以使用 cldrDataDownloader 函数下载或者获取 CLDR 数据了。

-- -------------------- ---- -------
-- --------
--------------------------------------- -- -
  ------------------
---

-- -------------------------
--------------------------------------- -- -
  ------------------
---

-- ---------------------- ---- --
------------------------- ---------------- -- -
  ------------------
---
展开代码

使用自定义存储库

默认情况下，cldr-data-downloader 会将下载下来的数据存储在项目的 node_modules/cldr-data-downloader/cache 目录下。不过你也可以通过设置 cachePath 参数来自定义存储位置。比如，你可以将 CLDR 数据存储到你的项目的 public 目录下。

// 将 CLDR 数据存储到 public 目录下
cldrDataDownloader('en', {
  cachePath: 'public/cldr-cache'
}).then(data => {
  console.log(data);
});

更新缓存

如果你需要更新 CLDR 数据的话，你可以给 manifest 参数传入最新的 CLDR 数据清单文件路径。当它和缓存中的清单文件不一样时，cldr-data-downloader 会自动下载并缓存最新的数据。比如：

// 更新中文简体数据
cldrDataDownloader('zh-Hans', {
  manifest:
    'https://raw.githubusercontent.com/unicode-cldr-json/unicode-cldr-json/master/cldr-json/cldr-core/31.0.1/supplemental/likelySubtags.json',
}).then((data) => {
  console.log(data);
});

其他参数

除了前面的参数之外，你还可以通过传入其他参数来进行更加精细化的控制。比如：

• cacheName - 可以设置缓存数据的名称。
• cacheExpiration - 可以设置缓存数据的过期时间（以秒为单位）。
• log - 可以设置日志级别（支持 "info" 或 "debug" 两种级别）。

// 设置参数示例
cldrDataDownloader('zh-Hans', {
  cacheName: 'cldr-data',
  cacheExpiration: 60 * 60 * 24 * 7, // 缓存数据有效期为一周
  log: 'debug',
}).then((data) => {
  console.log(data);
});

总结

cldr-data-downloader 是一个非常方便易用的 npm 库，它可以自动下载并缓存 CLDR 数据，大大简化了 Web 应用程序国际化和本地化的开发工作。因此，使用 cldr-data-downloader 可以让开发者更加专注于业务本身，提高开发效率。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/70317