使用 jev-leftpad 通过 Jev 为 JavaScript 值左侧填充空格

jev-leftpad 的作用

jev-leftpad 会请求 Jev 选择应添加的空格数量，从而在值的左侧填充空格。它的设计有意不同寻常：尽管 JavaScript 内置的 padStart() 无需网络请求即可解决此问题，但此软件包通过 TypeSafe 原生的 @typesafe-ai/sdk 使用 jev-latest。

每次调用都会发出一个 TypeSafe API 请求。Jev 会在名为 space_0 到 space_10 的选项中进行选择，JavaScript 随后将所选选项转换为空格，并把原始值放在这些空格之后。

前提条件

你需要 Node.js 20 或更高版本，以及一个 TypeSafe API 密钥。使用此软件包前，请设置 TYPESAFE_API_KEY 环境变量。

export TYPESAFE_API_KEY="your-api-key"

在 Windows PowerShell 中，可以使用以下命令为当前会话设置变量：

$env:TYPESAFE_API_KEY="your-api-key"

安装

创建或打开一个 Node.js 项目，然后使用 npm 安装软件包：

npm install jev-leftpad

软件包文档示例使用 ECMAScript 模块语法，因此请确保项目配置为支持 import 语句。

基本用法

导入默认导出，并使用值和目标长度调用 leftPad。由于软件包会发出 API 请求，该函数是异步的，必须使用 await。

import leftPad from 'jev-leftpad';

const result = await leftPad('jev', 8);

console.log(JSON.stringify(result));
// "     jev"（可能如此）

目标长度是返回值所需的总长度。在此示例中，jev 包含三个字符，目标长度为八，因此 Jev 应选择 space_5。JavaScript 随后创建五个空格，并将 jev 放在这些空格之后。

了解 API

leftPad(value, targetLength)

• value：要放在填充内容之后的值。
• targetLength：表示请求目标长度的非负安全整数。

该软件包支持添加零到十个空格。如果需要超过十个空格，Jev 就没有正确的选项。README 将此限制描述为项目设计中的有意安排。

运行注意事项

每次调用都会发出一个 TypeSafe API 请求，并且禁用了重试。请求可能失败，或者 Jev 可能选择错误的选项。与 JavaScript 原生的 padStart() 相比，此操作的成本也更高。

不要在生产环境或任何重要场景中使用 jev-leftpad。

对于普通应用代码，请改用 String.prototype.padStart()。jev-leftpad 最适合作为实验，或用于演示如何使用 AI 支持的实现来完成简单操作。

测试与开发

要参与项目开发或运行测试，请安装开发依赖并执行测试命令：

npm install
npm test

测试会模拟 Jev，因此不需要 TypeSafe API 密钥，也不会消耗 TypeSafe 配额。这使测试套件适合本地开发，无需发出真实 API 请求。

结论

jev-leftpad 提供了由 Jev 和 TypeSafe 驱动的异步左侧填充函数。使用 npm 安装它，配置 TYPESAFE_API_KEY，调用 leftPad(value, targetLength)，并记住其严格的 0 到 10 个空格范围以及不支持重试的特性。对于可靠的生产环境填充操作，优先使用内置的 padStart()。