clean-codejs-functions

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Clean Code JavaScript – Function Patterns

Clean Code JavaScript – 函数设计模式

Table of Contents

目录

  • Single Responsibility
  • Function Size
  • Parameters
  • Side Effects
  • 单一职责
  • 函数规模
  • 参数
  • 副作用

Single Responsibility

单一职责

js
// ❌ Bad
function handleUser(user) {
  saveUser(user);
  sendEmail(user);
}

// ✅ Good
function saveUser(user) {}
function notifyUser(user) {}
js
// ❌ 不良示例
function handleUser(user) {
  saveUser(user);
  sendEmail(user);
}

// ✅ 良好示例
function saveUser(user) {}
function notifyUser(user) {}

Function Size

函数规模

Keep functions small (ideally < 20 lines).
保持函数精简(理想情况下少于20行)。

Parameters

参数

js
// ❌ Bad
function createUser(name, age, city, zip) {}

// ✅ Good
function createUser({ name, age, address }) {}
js
// ❌ 不良示例
function createUser(name, age, city, zip) {}

// ✅ 良好示例
function createUser({ name, age, address }) {}

Side Effects

副作用

js
// ❌ Bad
let total = 0;
function add(value) {
  total += value;
}

// ✅ Good
function add(total, value) {
  return total + value;
}
js
// ❌ 不良示例
let total = 0;
function add(value) {
  total += value;
}

// ✅ 良好示例
function add(total, value) {
  return total + value;
}