コンテンツにスキップ
開発ガイドライン
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

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");

このページは役に立ちましたか?