JavaScript の命名規則
変数・関数・クラス・ファイルの命名規則と、JavaScript から要素を参照する方法
ケースの使い分け
| 対象 | 形式 | 例 |
|---|---|---|
| 変数・関数 | キャメルケース | userName、getUserData() |
| クラス | パスカルケース | UserManager |
| 定数(モジュール直下で固定値を表すもの) | 大文字スネークケース | MAX_RETRY_COUNT |
| ファイル名 | ケバブケース | show-alert.js |
const で宣言した値がすべて定数ではありません。大文字スネークケースは、設定値のようにモジュール全体で共有する固定値だけに使います。
const MAX_RETRY_COUNT = 3;
// 関数名は動詞から始める
function getUserData(userId) {
const userName = "山田太郎";
// ...
}
class UserManager {
// ...
}
具体的な名前
変数や関数名は、内容や役割が分かるように具体的に付けます。
// ✅ 良い例
const userAge = 25;
// ❌ 悪い例
const x = 25;
真偽値
真偽値は is / has / can / should などで始め、判定であることが分かる名前にします。
// ✅ 良い例
const isLoggedIn = true;
// ❌ 悪い例
const login = true;
配列とオブジェクト
配列は複数形、オブジェクトは内容が分かる名前にします。
// ✅ 良い例
const users = [];
const userProfile = { name: "山田太郎", age: 25 };
// ❌ 悪い例
const user = [];
const obj = { name: "山田太郎", age: 25 };
要素の参照
JavaScript から HTML 要素を取得するときは、スタイル用のクラス名を使わず、data-js 属性などの JavaScript 専用の目印を使います。スタイル用のクラス名を参照すると、CSS の修正でクラス名を変えたときに JavaScript が動かなくなります。
<div class="accordion" data-js="accordion">...</div>
// ✅ 良い例
const accordion = document.querySelector('[data-js="accordion"]');
// ❌ 悪い例:スタイル用のクラス名に依存している
const accordion = document.querySelector(".accordion");