@borewit/text-codec

中文文档
0.2.3发布于 2026/10/29MITTypeScriptES Module零依赖近 30 天下载 1.3亿

文本解码器

中文使用文档
文档目录6 节
  1. 支持的编码
  2. * 特性
  3. * 安装
  4. textDecode(bytes, encoding): string
  5. textEncode(input, encoding): Uint8Array
  6. 许可证

CI npm version npm downloads bundlejs License: MIT

@borewit/text-codec

A 类 文字编码和解码器的轻量级多填充 覆盖一小组常用编码.

一些 JavaScript 运行时间通过提供有限或不一致的编码支持 TextEncoder 财务报告和审定财务报表 TextDecoder。 。 。 .
实例包括环境 Hermes (土著反应) 或特定 节点.js 构建时伊斯兰法院联盟的支持有限。 。 。 .

本单元提供 可靠编码/解码支持一小组编码,这些编码在这些环境中可能缺失或不可靠。 。 。 .

  • 如果本地的UTF-8 TextEncoder 编号 : TextDecoder 可用,可用.
  • 所有其他编码都由这个库执行.

支持的编码

  • utf-8 编号 : utf8
  • utf-16le
  • ascii
  • latin1 编号 : iso-8859-1
  • windows-1252

这些编码常见于元数据格式和遗留文本数据.

* 特性

  • 编码和解码公用事业
  • 轻巧
  • 输入的 API

* 安装

npm install @borewit/text-codec

API 文档

textDecode(bytes, encoding): string

将二进制数据解码为JavaScript字符串.

参数

  • bytes (单位:千美元)Uint8Array)——解码的二进制数据.
  • encoding (单位:千美元)SupportedEncoding,可选)——编码类型. 默认为 "utf-8"。 。 。 .

回返

  • string ——解码文本.

示例

import { textDecode } from "@borewit/text-codec";

const bytes = new Uint8Array([0x48, 0x65, 0x6c, 0x6c, 0x6f]);
const text = textDecode(bytes, "ascii");
console.log(text); // "Hello"

textEncode(input, encoding): Uint8Array

用指定的编码将 JavaScript 字符串编码为二进制形式.

参数

  • input (单位:千美元)string)——要编码的字符串.
  • encoding (单位:千美元)SupportedEncoding,可选)——编码类型. 默认为 "utf-8"。 。 。 .

回返

Uint8Array ——被编码的二进制数据.

示例

import { textEncode } from "@borewit/text-codec";

const bytes = textEncode("Hello", "utf-16le");
console.log(bytes); // Uint8Array([...])

许可证

本项目根据以下规定获得许可证: MIT 许可证. 随意使用、修改和按需要分发.

版本与发布记录

@borewit/text-codec 共发布 6 个版本,首次发布于 2025/08/14;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.2.3latest2026/10/2910 天前
0.2.22026/03/127 个月前
0.2.12025/12/3010 个月前
0.2.02025/08/141.2 年前
0.1.12025/08/141.2 年前
0.1.02025/08/141.2 年前

关于 @borewit/text-codec 的常见问题

@borewit/text-codec 是什么?

文本解码器

如何安装 @borewit/text-codec?

在项目目录运行 npm install @borewit/text-codec,或使用 pnpm add / yarn add / bun add。

@borewit/text-codec 支持 TypeScript 吗?

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

@borewit/text-codec 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@borewit/text-codec 可以商用吗?

@borewit/text-codec 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@borewit/text-codec 的下载量有多少?

根据 npm 官方下载统计,@borewit/text-codec 在 2026/10/09 – 2026/11/07 这 30 天内被下载 129,777,723 次,日均约 4,325,924 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@borewit/text-codec 还在维护吗?

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