@ef-carbon/fluent-langneg

中文文档
0.7.0发布于 2025/11/24Apache-2.0TypeScriptESM + CJS零依赖近 30 天下载 5134

流利语言谈判 API

中文使用文档
文档目录8 节
  1. 安装
  2. 如何使用
  3. 战略
  4. 过滤( 默认)
  5. 匹配
  6. 查询
  7. API 用途 :
  8. 可能是亚种

@ 流利/ langneg

@fluent/langneg 为谈判语言提供API。 这是一部分 项目流利它的主要功能是提供环绕欧洲的功能 内通. 语言 以语言谈判、匹配和 选择.

安装

@fluent/langneg 可以在客户端和服务器端使用. 您可以从 npm 注册处安装, 或者将其作为独立的脚本使用 .

npm install @fluent/langneg

如何使用

import { negotiateLanguages } from "@fluent/langneg";

const supportedLocales = negotiateLanguages(
  navigator.languages, // requested locales
  ["de", "en-US", "pl"], // available locales
  { defaultLocale: "en-US" }
);

API 参考文献见 https://projectfluent.org/fluent.js/langneg 页面存档备份,存于互联网档案馆。 。 。 .

战略

API支持三项谈判战略:

过滤( 默认)

在这个策略中,算法将尝试匹配尽可能多的可用地块 尽可能为每个请求的地址.

示例

请求 : ['de-DE','fr-FR'] 可用: ['it','de','en-US','fr-CA','de-DE','fr','de-AU']

支持: ['de-DE','de','fr','fr-CA']

匹配

在此策略中, 算法将寻找最佳匹配 每个请求的地块的地块 .

示例

请求 : ['de-DE','fr-FR'] 可用: ['it','de','en-US','fr-CA','de-DE','fr','de-AU']

支持 : ['de-DE','fr']

查询

在这个策略中,算法将尝试找到单一的最佳地盘 用于在可用的本地地址列表中查找所要求的本地地址列表.

示例

请求 : ['de-DE','fr-FR'] 可用: ['it','de','en-US','fr-CA','de-DE','fr','de-AU']

支持: ['de-DE']

API 用途 :

let supported = negotiateLanguages(requested, available, {
  strategy: "matching",
});

可能是亚种

流利语言谈判模块载有它自己的可能 子数据,用于查找最可能可用的本地地址 如果所请求的语境过于笼统.

这种情形的一个例子是用户要求 en 语言,和 应用程序支持 en-GB 财务报告和审定财务报表 en-US。 。 。 .

版本与发布记录

@ef-carbon/fluent-langneg 共发布 1 个版本,首次发布于 2025/11/24;过去 12 个月发布了 1 个版本。

版本发布日期距今
0.7.0latest2025/11/2411 个月前

关于 @ef-carbon/fluent-langneg 的常见问题

@ef-carbon/fluent-langneg 是什么?

流利语言谈判 API

如何安装 @ef-carbon/fluent-langneg?

在项目目录运行 npm install @ef-carbon/fluent-langneg,或使用 pnpm add / yarn add / bun add。

@ef-carbon/fluent-langneg 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@ef-carbon/fluent-langneg 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@ef-carbon/fluent-langneg 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=14.0.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ef-carbon/fluent-langneg 可以商用吗?

@ef-carbon/fluent-langneg 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@ef-carbon/fluent-langneg 的下载量有多少?

根据 npm 官方下载统计,@ef-carbon/fluent-langneg 在 2026/10/13 – 2026/11/11 这 30 天内被下载 5,134 次,日均约 171 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ef-carbon/fluent-langneg 还在维护吗?

最新版本 0.7.0 发布于 2025/11/24(11 个月前);至今共发布 1 个版本,其中过去 12 个月发布了 1 个;首次发布于 2025/11/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。