# @ambassify/twitter-text 中文文档

规范地址：https://npmcn.com/package/%40ambassify/twitter-text/

版本：4\.0\.0
npm 元数据更新时间：2025-10-09T08:36:39.954Z
中文译文更新时间：2026-11-06T03:50:24.860Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ambassify/twitter-text
原文对照：https://npmcn.com/package/%40ambassify/twitter-text/?lang=original
项目主页：https://github.com/ambassify/twitter-text
源码仓库：https://github.com/ambassify/twitter-text

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：316 kB，269 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2021-11-04T08:44:06.720Z
- 最新版本发布：2023-09-18T16:22:09.189Z
- 近 30 天下载量：5332（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

官方推特文本链接库的澄清

## 安装

```sh
npm install @ambassify/twitter-text
```

也可以使用：`pnpm add @ambassify/twitter-text`、`yarn add @ambassify/twitter-text`、`bun add @ambassify/twitter-text`

## README

# @ambassify/twitter-text (英语)

这是Ambassify在推特文本库的叉子.

我们提取了图书馆的JS部分,因为我们不需要其他语言,他们的依赖性触发了依赖性警报,这些警报需要固定在安贝斯化寄存器上. 为那些我们不使用的语言修补这些语言所需的努力太高了.

我们希望,如果上游一揽子计划有任何改变,它们也会解决其安全问题和过时的建筑.

国家防范机制有 `npm install @ambassify/twitter-text`

## 我们所做的改变

-   [更新核心J和多填充战略](https://github.com/twitter/twitter-text/pull/363)
-   删除单位测试
-   已更新 Bail- eslint 至 @ Babel/ eslint- parser
-   删除了 UMD 构建( 使用滚动)

# 轨道读取

## 国家预防机制用户

安装于 : `npm install twitter-text`

这个 `twttr.txt` 名称空间导出, 并按此提供:

```js
var twitter = require('twitter-text')
twitter.autoLink(twitter.htmlEscape('#hello < @world >'))
```

## 采掘实例

```
// basic extraction
var usernames = twttr.txt.extractMentions("Mentioning @twitter and @jack")
// usernames == ["twitter", "jack"]
```

## 自动链接示例

```
twttr.txt.autoLink("link @user, please #request");

twttr.txt.autoLink("link @user, and expand url... http://t.co/0JG5Mcq", {
    urlEntities: [
        {
          "url": "http://t.co/0JG5Mcq",
          "display_url": "blog.twitter.com/2011/05/twitte…",
          "expanded_url": "http://blog.twitter.com/2011/05/twitter-for-mac-update.html",
          "indices": [
            30,
            48
          ]
        }
    ]});
```

见 [图文实体](https://developer.twitter.com/en/docs/twitter-api/v1/data-dictionary/overview/entities-object) 从Twitter的API获得更多信息.

## 图文解析

之前版本的Twitter-Text为Tweet验证,Tweet长度,和剩余字符计算提供了不同的帮助方法. 为了简化API并仅用一通电话获取此信息,Twitter-Text现在揭露出一种新的"parseTweet"方法,该方法将返回以下字段:

-   **加权Length :** 整数表示由上方算法所计算的加权长度.
-   **平方千米 :** 整数值对应消费加权长度与最大加权长度之比.
-   **无效 :** 布尔表示它是否为有效的 Tweet .
-   **解除支付程序启动 :** Tweet 字符串上的启动索引整数
-   **显示区域尾端 :** Tweet 字符串( 包含) 上含有端索引的整数
-   **无效的Display RangeStart :** 在 Tweet 字符串上表示有效启动索引的整数
-   **无效的 Display 路由结束 :** 整数表示 Tweet 字符串上的有效端索引 。 这可以小于显示 RangEnd(包括).

```js
var tweet = "This is a test Tweet";
twttr.txt.parseTweet(tweet);
/* Returns:
  {
    weightedLength: 20,
    permillage: 71,
    valid: true,
    displayRangeEnd: 19,
    displayRangeStart: 0,
    validRangeEnd: 19,
    validRangeStart: 0
  }
*/
```

推特的加权计票计划详情请访问 [官方开发者网站](https://developer.twitter.com/en/docs/counting-characters)。 。 。 .

### 标记为折旧

`getTweetLength` 返回由 parseTweet 计算的 Tweet 的加权长度。 将在随后的释放中移除。 请使用 parseTweet 代替 .

## 用户名

用户名提取和链接匹配所有有效的 Twitter 用户名, 但确实 不验证用户名是有效的Twitter账户 .

## 名单

以 @ user/ list- name 撰写时自动链接和提取列表名称 格式.

## 长发

自动链接并提取标签,其中标签包含任何 latin 字母或 数字,但不能仅仅是数字.

## URL( URL)

中文、日文或韩文等亚洲语言不得使用诸如 从 URL 中分离出普通文本的空格, 从而难以识别何处 uRL结束并开始文字.

因此,Twitter-Text目前不支持提取或自动链接 非拉丁字符紧接着的 URL .

例:"http://twitter.com/は素晴らしい". 普通文字为"QQ",虽然不是 URL 的一部分 空间不是分开的.

## 国际

已特别注意确保自动连接和取出工作 在各种语言的图文中。 这意味着语言在 语言应同样有效.

## 点击高亮显示

用于在搜索 API 返回的“ hits” 周围提供强调 以对抗已经自动链接的文本.

## 测试

所有Twitter-Text测试,运行:

```
npm run test
```

这将进行符合性和Javascript测试.

### 遵约

主测试套房为twitter-text-conference. 测试在您的浏览器中运行,使用QUnit. 要运行兼容套件,从项目根,运行:

```
rake test:conformance
```

您的默认浏览器将打开测试套件 。 您应该打开您其他浏览器中的测试套件 .

### 其他测试

有些测试是针对twitter-text-js的, 要运行这些,从项目根,运行:

```
rake test
```

您的默认浏览器将打开测试套件 .

## 包装

正式版本保留在 `pkg/` 目录。 要滚动新版本, (前 v1.1. 0) 从工程根运行如下 :

```
rake package[1.1.0]
```

这将在 `pkg/twitter-text-1.1.0.js`。 。 。 .

## 报告错误

请直接向错误报告 [gitHub 的Twitter文本追踪器](https://github.com/twitter/twitter-text/issues)

## 版权和许可证

版权2012-2020年 腾讯网.

根据Apache许可证第2.0版("License"); 除非符合许可证,否则您不得使用此作品. 您可以在LICENSE文件中获取许可证副本,或:

[http://www.apache.org/licenses/LICENSE-2.0 (中文(简体) )](http://www.apache.org/licenses/LICENSE-2.0)

除非适用的法律要求或书面同意,否则软件 根据许可证发放的是在“AS IS”BASIS上发放的, 没有任何明示或暗示的警告或条件. 有关许可的特定语言的许可证 许可证的限制.

## 常见问题

### @ambassify/twitter-text 是什么？

官方推特文本链接库的澄清

### 如何安装 @ambassify/twitter-text？

在项目目录运行 npm install @ambassify/twitter-text，或使用 pnpm add / yarn add / bun add。

### @ambassify/twitter-text 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ambassify\_\_twitter-text 是否存在。

### @ambassify/twitter-text 支持 ESM 还是 CommonJS？

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

### @ambassify/twitter-text 可以商用吗？

@ambassify/twitter-text 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @ambassify/twitter-text 的下载量有多少？

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

### @ambassify/twitter-text 还在维护吗？

最新版本 4\.0\.0 发布于 2023/09/19（3 年前）；至今共发布 2 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/11/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。