23.10Naming Conventions / Uppercase

定数の大文字表記

定数を大文字にしてもよいのは、(1)エクスポートされ、(2)`const`であり、(3)その値(およびネストされたプロパティ)が決して変更されないとプログラマが信頼できる場合のみです。

`UPPERCASE_SNAKE_CASE` は、単なる `const` 宣言された変数以上に強い「不変性」を示唆する慣習です。これは、APIキーやアクションタイプのように、アプリケーション全体で共有され、決して変更されることのないハードコードされた値を表現するのに適しています。ファイル内でのみ使われる定数にこれを使うのは過剰です。

❌ Bad
// bad
const PRIVATE_VARIABLE = 'should not be unnecessarily uppercased within a file';
✅ Good
// better in most cases
export const API_KEY = 'SOMEKEY';