javascript-practices

eser 的头像作者 eser

JavaScript 和 TypeScript 关于语法、模块、类型和运行时行为的约定。在编写或审查 JS/TS 代码、实现模块、处理类型或使用运行时 API 时使用。

📖 中文导读:JavaScript 和 TypeScript 关于语法、模块、类型和运行时行为的约定。在编写或审查 JS/TS 代码、实现模块、处理类型或使用运行时 API 时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: javascript-practices description: JS/TS conventions for syntax, modules, and types. Use when writing or reviewing JavaScript/TypeScript code.

JavaScript/TypeScript Practices

Conventions for JS/TS syntax, modules, types, and runtime behavior.

Quick Start

import * as path from "@std/path"; // namespace import
import { utils } from "./utils.ts"; // explicit extension

export function buildConfig() {} // direct named export
const port = config.port ?? 8000; // nullish coalescing

Key Principles

Modules: Direct named exports, namespace imports, explicit .ts extensions

Syntax: const over let, always semicolons, === strict equality, ?? over ||

Types: Number() over +, instanceof over typeof, prefer null over undefined

Runtime: import.meta.dirname, globalThis over window, optional projectRoot params

Async: Use return await consistently for better stack traces and correct error handling

Avoid: eval, prototype mutation, truthy/falsy checks on non-booleans

References

See rules.md for complete guidelines with examples.