---
title: JavaScript の命名規則
sidebar:
  label: 命名規則
description: 変数・関数・クラス・ファイルの命名規則と、JavaScript から要素を参照する方法
---

## ケースの使い分け

| 対象 | 形式 | 例 |
| --- | --- | --- |
| 変数・関数 | キャメルケース | `userName`、`getUserData()` |
| クラス | パスカルケース | `UserManager` |
| 定数（モジュール直下で固定値を表すもの） | 大文字スネークケース | `MAX_RETRY_COUNT` |
| ファイル名 | ケバブケース | `show-alert.js` |

`const` で宣言した値がすべて定数ではありません。大文字スネークケースは、設定値のようにモジュール全体で共有する固定値だけに使います。

```javascript
const MAX_RETRY_COUNT = 3;

// 関数名は動詞から始める
function getUserData(userId) {
  const userName = "山田太郎";
  // ...
}

class UserManager {
  // ...
}
```

## 具体的な名前

変数や関数名は、内容や役割が分かるように具体的に付けます。

```javascript
// ✅ 良い例
const userAge = 25;

// ❌ 悪い例
const x = 25;
```

## 真偽値

真偽値は `is` / `has` / `can` / `should` などで始め、判定であることが分かる名前にします。

```javascript
// ✅ 良い例
const isLoggedIn = true;

// ❌ 悪い例
const login = true;
```

## 配列とオブジェクト

配列は複数形、オブジェクトは内容が分かる名前にします。

```javascript
// ✅ 良い例
const users = [];
const userProfile = { name: "山田太郎", age: 25 };

// ❌ 悪い例
const user = [];
const obj = { name: "山田太郎", age: 25 };
```

## 要素の参照

JavaScript から HTML 要素を取得するときは、スタイル用のクラス名を使わず、`data-js` 属性などの JavaScript 専用の目印を使います。スタイル用のクラス名を参照すると、CSS の修正でクラス名を変えたときに JavaScript が動かなくなります。

```html
<div class="accordion" data-js="accordion">...</div>
```

```javascript
// ✅ 良い例
const accordion = document.querySelector('[data-js="accordion"]');

// ❌ 悪い例：スタイル用のクラス名に依存している
const accordion = document.querySelector(".accordion");
```
