@ambassify/twitter-text

中文文档
4.0.0发布于 2023/09/19ESM + CJS近 30 天下载 5332

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

中文使用文档
文档目录18 节
  1. 我们所做的改变
  2. 国家预防机制用户
  3. 采掘实例
  4. 自动链接示例
  5. 图文解析
  6. 标记为折旧
  7. 用户名
  8. 名单
  9. 长发
  10. URL( URL)
  11. 国际
  12. 点击高亮显示
  13. 测试
  14. 遵约
  15. 其他测试
  16. 包装
  17. 报告错误
  18. 版权和许可证

@ambassify/twitter-text (英语)

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

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

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

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

我们所做的改变

轨道读取

国家预防机制用户

安装于 : npm install twitter-text

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

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
          ]
        }
    ]});

见 图文实体 从Twitter的API获得更多信息.

图文解析

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

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

推特的加权计票计划详情请访问 官方开发者网站。 。 。 .

标记为折旧

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文本追踪器

版权2012-2020年 腾讯网.

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

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

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

版本与发布记录

@ambassify/twitter-text 共发布 2 个版本,首次发布于 2021/11/04;过去 12 个月发布了 0 个版本。

版本发布日期距今
4.0.0latest2023/09/193 年前
3.1.02021/11/045 年前

关于 @ambassify/twitter-text 的常见问题

@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 和提交记录判断。