القائمة
Variable naming conventions for TypeScript/JavaScript. Prefer camelCase even for constants and avoid UPPER_SNAKE_CASE. Use when naming or reviewing variables or constants.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Generate a commit message from staged changes and let the user review before committing. Use when the user wants to commit changes or create a git commit.
Generate a GitHub pull request title and body from the current branch and let the user review before creation. Use when the user wants to create a pull request.
Investigate any topic by querying multiple external sources (web, official docs, GitHub, MCP servers). Use whenever a question requires information not already in the working context, including library behavior, API specifications, error diagnostics, version comparisons, or general factual lookup.
himari is ncaq's rio-like custom Haskell Prelude. Import it with a single `import Himari`, never `import Himari.Prelude` or other submodules directly. Use when writing or reviewing Haskell code in a project that depends on the himari package.
Prefer the most specific built-in method over general-purpose ones in TypeScript/JavaScript. Use includes over indexOf, some over filter().length, find over filter()[0], flatMap over map().flat(), at(-1) over length-based access, startsWith/endsWith/includes over indexOf on strings, structuredClone over JSON round-trip. Use when writing or reviewing code that searches, tests, transforms arrays, objects, or strings.
Avoid for loops (C-style, for...of, for...in) in TypeScript/JavaScript. Prefer higher-order Array methods like map, filter, find, some, every, reduce. Use when writing or reviewing loops or iteration over arrays, objects, Map, Set, or String.
| name | variable-naming |
| description | Variable naming conventions for TypeScript/JavaScript. Prefer camelCase even for constants and avoid UPPER_SNAKE_CASE. Use when naming or reviewing variables or constants. |
| user-invocable | false |
TypeScript/JavaScriptのコードにおける変数の命名規則です。
ファイル名やディレクトリ名についてはfile-namingを参照してください。
変数・パラメータには基本的にcamelCaseを使います。
const taxedPrice = itemPrice * (1 + taxRate);
const userName = profile.displayName;
再代入されない定数のように見える変数でも、 基本的にはUPPER_SNAKE_CASEではなくcamelCaseを使ってください。
// 良い
const maxRetryCount = 3;
const apiBaseUrl = "https://example.com";
const emailPattern = /^.+@.+$/;
// 避ける
const MAX_RETRY_COUNT = 3;
const API_BASE_URL = "https://example.com";
const EMAIL_PATTERN = /^.+@.+$/;
理由は以下の通りです。
constがデフォルトになった現代のコードでは、
再代入されないことはconstキーワードが既に表現しています。
UPPER_SNAKE_CASEで「再代入されない」ことを重ねて示すのは冗長です。
UPPER_SNAKE_CASEにすべき「真の定数」の判定は手間がかかります。
主要なスタイルガイド(GoogleやAirbnb)もconstを一律にUPPER_SNAKE_CASEにせよとは言っておらず、
「モジュールレベルかつ意味的に深く不変なプリミティブ値」のような狭い条件に限定しています。
newで生成したオブジェクトや関数、RegExpのように内部状態を持つ値は、
constであってもこの基準では「定数ではない」のでcamelCaseが自然です。
この境界はしばしば曖昧で、宣言のたびに判断するコストが高いです。
ハードコードしていた値を後から計算式や引数に変えるリファクタリングをすると、 UPPER_SNAKE_CASEのままでは名前を付け替える必要が出てきます。 最初からcamelCaseで統一しておけばこの付け替えが発生しません。
camelCaseに統一すれば、 個々の変数が「真の定数」かどうかを判断する必要がなくなり、 コードベース全体で一貫した命名になります。
Math.PINumber.MAX_SAFE_INTEGERWebSocket.OPENのように標準ライブラリやWeb APIにはUPPER_SNAKE_CASE/UPPER_CASEの定数が存在します。
これらは利用する側であって自分で命名するわけではないので、 提供されている名前をそのまま使ってください。 これらの存在は、 自分のコードでUPPER_SNAKE_CASEを使う理由にはなりません。
これらが大文字なのはC言語からJavaやWeb IDLへと受け継がれた歴史的慣習によるもので、 いずれもプリミティブ型の固定値や整数の列挙値という限られた性質のものです。 自分のコードがこの慣習に追従する義務はありません。
@typescript-eslint/naming-conventionルールのデフォルトは、
variableに対してcamelCaseとUPPER_CASEの両方を許容します。
したがってcamelCaseで統一してもlintは通ります。
さらにcamelCaseだけに強制したい場合は、
variableセレクタのformatを["camelCase"]のみに設定できます。
複数の固定値をまとめて持つ定数オブジェクトや、
文字列ユニオン型の元になる配列を定義する場合は、
キーも値もUPPER_SNAKE_CASEにせず、
camelCaseのオブジェクトにas constを付ける方法を優先します。
詳細はas-const-satisfiesを参照してください。
プロジェクトやチームで既にUPPER_SNAKE_CASEの規約が採用されている場合は、 そちらに従ってください。 新規に方針を決められる場面でcamelCaseを優先するという指針であり、 既存の規約を逐一覆すものではありません。