今日のペースの速い開(kāi)発の世界では、ソリューションを迅速に提供することが不可欠です。ただし、コードの品質(zhì)を手抜きすると、バグ、セキュリティの脆弱性、保守不能なコードが発生することがよくあります。コード倫理は、機(jī)能的なコードだけでなく、保守可能で効率的かつ安全なコードを作成する上で極めて重要な役割を果たします。 JavaScript 開(kāi)発における重要な倫理原則と、それによってコードの品質(zhì)がどのように向上するかを例を用いて見(jiàn)てみましょう。

1. 賢さよりも明晰さ 倫理原則: 「賢い」ソリューションや複雑なソリューションよりも、コードの読みやすさとシンプルさを優(yōu)先します。コードは書(shū)かれるよりも読まれることが多くなります。長(zhǎng)期的なメンテナンスには、分かりやすさが重要です。

例: より明確な代替手段が存在する場(chǎng)合は、簡(jiǎn)潔な構(gòu)成や複雑な構(gòu)成の使用を避けてください。

悪い例


良い例
const doubleArray = arr => arr.map(x => x * 2); // 明確でわかりやすい
この例では、ビット演算子 <<動(dòng)作しますが、単純な乗算を使用する場(chǎng)合よりも読みにくくなります。明確さを選択すると、チームや將來(lái)の自分がコードを簡(jiǎn)単に理解して保守できるようになります。

1. 地球規(guī)模の汚染を回避する 倫理原則: 変數(shù)をグローバルに宣言してグローバル スコープを汚染しないようにしてください。これにより、名前の衝突や予期しない動(dòng)作が発生する可能性があります。

悪い例

カウント = 0 にします。 // グローバルスコープで宣言されています
関數(shù) increment() {
カウント ;
}
良い例

(() => {
カウント = 0 とします。 // クロージャーにカプセル化されます
関數(shù) increment() {
カウント ;
}
})();
IIFE (Immediately Invoked Function Expression) でコードをラップすることにより、count 変數(shù)のスコープがローカルに設(shè)定され、コードの他の部分との潛在的な競(jìng)合が回避されます。

1. エラー処理は慎重に 倫理原則: エラーを適切に処理し、有益なメッセージを提供します。サイレント障害は、予期しない動(dòng)作につながる可能性があります。

悪い例

関數(shù) getUser(id) {
return fetch(/user/${id}).then(res => res.json()); // エラー処理なし
}
良い例

非同期関數(shù) getUser(id) {
{
を試してください const res = await fetch(/user/${id});
if (!res.ok) {
throw new Error(ユーザーの取得に失敗しました: ${res.statusText});
}
return await res.json();
} キャッチ (エラー) {
console.error('ユーザー取得エラー:', error);
null を返す;
}
}
エラー処理を追加すると、アプリがサイレントに失敗するのを防ぐだけでなく、何が問(wèn)題だったのかについての意味のある情報(bào)も提供されます。

1. コードをモジュール化する 倫理原則: 大きな関數(shù)やファイルを、より小さな再利用可能なモジュールに分割します。これにより、コードの構(gòu)成、テスト、読みやすさが向上します。

悪い例

関數(shù) processOrder(order) {
// 注文を検証するコード
// 合計(jì)を計(jì)算するコード
// 支払いを処理するコード
// レシートを生成するコード
}
良い例

`function validateOrder(order) { /* ... / }
function CalculateTotal(order) { / ... / }
function processPayment(paymentInfo) { / ... / }
functiongenerateReceipt(order) { / ... */ }

関數(shù) processOrder(order) {
if (!validateOrder(order)) return;
const total = CalculateTotal(order);
processPayment(order.paymentInfo);
generateReceipt(order);
}`
このモジュール式アプローチにより、コードの理解、テスト、保守が容易になります。各機(jī)能には単一の責(zé)任があり、単一責(zé)任原則 (SRP) に従っています。

1. データプライバシーを尊重する 倫理原則: 機(jī)密データは慎重に取り扱います。ログ、コンソール メッセージ、またはパブリック エンドポイント內(nèi)の不要なデータを公開(kāi)しないでください。

悪い例

関數(shù) processUser(user) {
console.log(処理中のユーザー: ${JSON.stringify(user)}); // 機(jī)密データの公開(kāi)
// ...
}
良い例

関數(shù) processUser(user) {
console.log(処理中のユーザー: ${user.id}); // 必要な詳細(xì)のみをログに記録します
// ...
}
この場(chǎng)合、悪い例により、機(jī)密性の高いユーザー情報(bào)がコンソールに公開(kāi)されてしまいます。良い例では、データ プライバシーのベスト プラクティスに従って、必要なものだけをログに記録します。

1. DRY (同じことを繰り返さない) 原則に従う 倫理原則: コードの重複を避けます。代わりに、繰り返されるロジックを再利用可能な関數(shù)に抽象化します。

悪い例

`function createAdmin(name, role) {
return { 名前、役割、権限: ['作成'、'読み取り'、'更新'、'削除'] };
}

function createEditor(名前, 役割) {
return { 名前、役割、権限: ['作成', '読み取り'] };
}`
良い例

`function createUser(名前、役割、権限) {
return { 名前、役割、権限 };
}

const admin = createUser('Alice', 'Admin', ['create', 'read', 'update', 'delete']);
const editor = createUser('Bob', 'Editor', ['create', 'read']);`
DRY 原則に従うことで、コードの重複を排除し、將來(lái)の更新で不一致やエラーが発生する可能性を減らします。

1. コードを文書(shū)化する 倫理原則: コードを文書(shū)化して、他の開(kāi)発者 (または將來(lái)の自分) に対して意図と思考プロセスが明確であることを確認(rèn)します。

悪い例

関數(shù) CalculateAPR(金額, レート) {
返金額 * レート / 100 / 12; // 數(shù)式が何を表すかについての説明はありません
}
良い例

`/**

• 毎月の年利を計(jì)算します
• @param {number} amount - 元金の金額
• @param {number} rate - 年間パーセント率
• @return {number} - 毎月の APR */ 関數(shù) CalculateAPR(金額, レート) { 返金額 * レート / 100 / 12; // APR の計(jì)算式はドキュメントで説明されています }` 適切なドキュメントを作成すると、コードを読む人は誰(shuí)でも、ロジックをリバース エンジニアリングすることなく、その動(dòng)作を理解できるようになります。

1. 単體テストを作成する 倫理原則: 単體テストを作成すると、コードが期待どおりに動(dòng)作することが保証され、コードの進(jìn)化に伴うバグの発生を防ぐことができます。

悪い例
// テストカバレッジなし
良い例
// Jest や Mocha などのテスト フレームワークを使用する
test('calculateAPR は正しい APR を返すはずです', () => {
Expect(calculateAPR(1000, 12)).toBe(10);
});
テストを作成することで、コードの信頼性、検証可能性、および自信を持ってリファクタリングが容易であることが保証されます。

1. コードスタイルガイドを採(cǎi)用する 倫理原則: チームまたはプロジェクト全體で一貫したコーディング スタイルに従います。これによりコラボレーションが向上し、誤解が減ります。

コードの一貫性を確保するには、ESLint や Prettier などのツールの使用を検討してください。

ESLint 構(gòu)成の例

{
"extends": "eslint:推奨",
"環(huán)境": {
"ブラウザ": true、
"es6": true
}、
「ルール」: {
"インデント": ["エラー", 2],
"引用符": ["エラー", "単一"],
"semi": ["エラー", "常に"]
}
}
スタイルガイドに従うことで、コードベースは一貫した構(gòu)造を維持し、他の人がコードを投稿したりレビューしたりしやすくなります。

結(jié)論
倫理的な JavaScript コーディングの実踐により、コードが機(jī)能するだけでなく、保守性、安全性、將來(lái)性も保証されます。明確さ、モジュール性、エラー処理、データ プライバシーに重點(diǎn)を置くことで、他の開(kāi)発者とエンド ユーザーの両方を尊重するコードベースを作成できます。これらのプラクティスをワークフローに組み込むと、よりクリーンで信頼性の高いコードを作成し、より健全な開(kāi)発環(huán)境を促進(jìn)することができます。

以上がJavaScript コード倫理: クリーンで倫理的なコードを書(shū)くの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。