SuperAPI AI 工具集

javascript-pro

编程与开发

查看项目

更新于 10-16 23:14

技能介绍

用途

JavaScript Pro 是一个面向 JavaScript 开发的技能,用于编写、调试和重构 JavaScript 代码。它聚焦于使用 ES2023+ 的现代语言特性、async/await 异步模式、ESM 模块系统以及 Node.js API。

主要能力

该技能覆盖以下使用场景:

  • 构建原生(vanilla)JavaScript 应用
  • 实现 async/await 模式与 Promise 处理
  • 使用现代模块系统(ESM/CJS)
  • 优化浏览器性能与内存占用
  • 开发 Node.js 后端服务
  • 实现 Web Workers、Service Workers 或浏览器 API

使用方式

该技能定义了一套核心工作流程:

  1. 分析需求 — 检查 package.json、模块系统、Node 版本、浏览器目标;确认 .js/.mjs/.cjs 约定
  2. 设计架构 — 规划模块、异步流程与错误处理策略
  3. 实现 — 使用 ES2023+ 编写代码,采用恰当的模式与优化
  4. 校验 — 运行 linter(eslint --fix);若 linter 失败,修复所有报告的问题并重新运行后再继续。使用 DevTools 或 --inspect 检查内存泄漏,验证打包体积;若发现泄漏,解决后再继续
  5. 测试 — 使用 Jest 编写全面测试,达到 85%+ 覆盖率;若覆盖率不足,补充缺失用例并重新运行。确认没有未处理的 Promise rejection

该技能还提供按上下文加载的参考指南:

主题 参考文档 加载时机
现代语法 references/modern-syntax.md ES2023+ 特性、可选链、私有字段
异步模式 references/async-patterns.md Promise、async/await、错误处理、事件循环
模块 references/modules.md ESM 与 CJS、动态导入、package.json exports
浏览器 API references/browser-apis.md Fetch、Web Workers、Storage、IntersectionObserver
Node 核心 references/node-essentials.md fs/promises、streams、EventEmitter、worker threads

约束规范

必须遵守(MUST DO):

  • 仅使用 ES2023+ 特性
  • 使用 X | null 或 X | undefined 模式
  • 使用可选链(?.)与空值合并(??)
  • 所有异步操作使用 async/await
  • 新项目使用 ESM(import/export)
  • 使用 try/catch 实现正确的错误处理
  • 为复杂函数添加 JSDoc 注释
  • 遵循函数式编程原则

禁止事项(MUST NOT DO):

  • 使用 var(始终使用 const 或 let)
  • 使用基于回调的模式(优先使用 Promise)
  • 在同一模块中混用 CommonJS 与 ESM
  • 忽略内存泄漏或性能问题
  • 在异步函数中跳过错误处理
  • 在 Node.js 中使用同步 I/O
  • 修改函数参数
  • 在浏览器中创建阻塞操作

关键模式示例

Async/Await 错误处理:

// ✅ Correct — always handle async errors explicitly
async function fetchUser(id) {
  try {
    const response = await fetch(`/api/users/${id}`);
    if (!response.ok) throw new Error(`HTTP ${response.status}`);
    return await response.json();
  } catch (err) {
    console.error("fetchUser failed:", err);
    return null;
  }
}

// ❌ Incorrect — unhandled rejection, no null guard
async function fetchUser(id) {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}

可选链与空值合并:

// ✅ Correct
const city = user?.address?.city ?? "Unknown";

// ❌ Incorrect — throws if address is undefined
const city = user.address.city || "Unknown";

ESM 模块结构:

// ✅ Correct — named exports, no default-only exports for libraries
// utils/math.mjs
export const add = (a, b) => a + b;
export const multiply = (a, b) => a * b;

// consumer.mjs
import { add } from "./utils/math.mjs";

// ❌ Incorrect — mixing require() with ESM
const { add } = require("./utils/math.mjs");

避免 var / 优先 const:

// ✅ Correct
const MAX_RETRIES = 3;
let attempts = 0;

// ❌ Incorrect
var MAX_RETRIES = 3;
var attempts = 0;

输出模板

实现 JavaScript 功能时,应提供:

  1. 具有清晰导出的模块文件
  2. 具有全面覆盖的测试文件
  3. 面向公共 API 的 JSDoc 文档
  4. 所用模式的简要说明

适用场景与限制

该技能适用于原生 JavaScript 应用开发、异步与 Promise 处理、现代模块系统使用、浏览器性能与内存优化、Node.js 后端服务开发以及 Web Workers、Service Workers 等浏览器 API 实现。其约束要求仅使用 ES2023+ 特性、避免 var 与回调模式、不在同一模块混用 CommonJS 与 ESM、不在 Node.js 中使用同步 I/O。关于收费、价格、平台支持范围等信息,资料中暂未提供。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明