majiayu000 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.