js-google

Google JavaScript ベストプラクティス

Google の公式 JavaScript スタイルガイドに基づく、包括的な JavaScript のスタイルとベストプラクティスのガイドです。AI エージェントと LLM 向けに設計されています。8 つのカテゴリにわたる 47 のルールを含み、自動リファクタリングやコード生成の指針となるよう、影響度に応じて優先順位を付けています。

適用するタイミング

次の場合にこれらのガイドラインを参照してください。

• 新しい JavaScript または ES6 以降のコードを記述するとき
• モジュールの構成やインポート／エクスポートを管理するとき
• JSDoc の型注釈やドキュメントを追加するとき
• 命名やスタイルの一貫性についてコードをレビューするとき
• 既存の JavaScript コードをリファクタリングするとき

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	モジュールシステムとインポート	CRITICAL	module-
2	言語機能	CRITICAL	lang-
3	型安全性と JSDoc	HIGH	type-
4	命名規則	HIGH	naming-
5	制御フローとエラー処理	MEDIUM-HIGH	control-
6	関数とパラメーター	MEDIUM	func-
7	オブジェクトと配列	MEDIUM	data-
8	書式とスタイル	LOW	format-

クイックリファレンス

1. モジュールシステムとインポート（CRITICAL）

• module-avoid-circular-dependencies - 循環インポートによる読み込みの失敗を防ぎます
• module-file-extension-in-imports - インポートパスに .js 拡張子を含めます
• module-named-exports-over-default - 一貫性を保つため、名前付きエクスポートを優先します
• module-no-duplicate-imports - 同じファイルからインポートするのは 1 回だけにします
• module-no-import-aliasing - 元のエクスポート名を維持します
• module-source-file-structure - 標準的なファイル構成の順序に従います

2. 言語機能（CRITICAL）

• lang-const-over-let-over-var - 既定では const を使い、var は使いません
• lang-es6-classes-over-prototypes - プロトタイプの操作ではなく、class 構文を使います
• lang-explicit-semicolons - 常にセミコロンを明示します
• lang-no-eval - eval や Function コンストラクターは使いません
• lang-no-modify-builtins - 組み込みプロトタイプは変更しません
• lang-no-non-standard-features - 標準の ECMAScript 機能のみを使います
• lang-no-primitive-wrappers - プリミティブのラッパーオブジェクトは使いません
• lang-no-with-statement - with 文は使いません

3. 型安全性と JSDoc（HIGH）

• type-cast-with-parentheses - 型キャストには括弧を使います
• type-enum-annotations - 列挙型には静的なリテラル値で注釈を付けます
• type-explicit-nullability - null 許容性修飾子を明示的に使います
• type-jsdoc-required-for-exports - エクスポートする関数には JSDoc を必須とします
• type-template-parameters - テンプレートパラメーターを常に指定します
• type-typedef-for-complex-types - 複雑なオブジェクト型には typedef を使います

4. 命名規則（高）

• naming-constant-case-for-constants - 不変値にはCONSTANT_CASEを使用します
• naming-descriptive-over-brief - 簡潔さよりも分かりやすい名前を優先します
• naming-file-naming-conventions - 小文字とハイフンまたはアンダースコアを使用します
• naming-lowercamelcase-for-methods - メソッドと変数にはlowerCamelCaseを使用します
• naming-no-dollar-prefix - 識別子の先頭にドル記号を付けないでください
• naming-uppercamelcase-for-classes - クラスにはUpperCamelCaseを使用します

5. 制御フローとエラー処理（中〜高）

• control-comment-empty-catch - 空のcatchブロックには説明を記述します
• control-for-of-over-for-in - for-inよりもfor-ofを優先します
• control-strict-equality - nullのチェックを除き、厳密等価演算子を使用します
• control-switch-default-last - switchには必ずdefaultケースを含めます
• control-throw-error-objects - 必ずErrorオブジェクトをスローします

6. 関数とパラメーター（中）

• func-arrow-functions-for-nested - ネストされた関数にはアロー関数を優先します
• func-arrow-parentheses - アロー関数のパラメーターは必ず括弧で囲みます
• func-default-parameters - 条件分岐の代わりにデフォルトパラメーターを使用します
• func-rest-parameters-over-arguments - argumentsよりもレストパラメーターを使用します
• func-spread-over-apply - applyの代わりにスプレッド演算子を使用します

7. オブジェクトと配列（中）

• data-array-literals-over-constructor - Arrayコンストラクターよりも配列リテラルを使用します
• data-destructuring-for-multiple-values - 複数のプロパティには分割代入を使用します
• data-no-mixing-quoted-unquoted-keys - 引用符付きキーと引用符なしキーを混在させないでください
• data-object-literals-over-constructor - コンストラクターよりもオブジェクトリテラルを使用します
• data-spread-over-concat-slice - concatやsliceよりもスプレッド演算子を使用します
• data-trailing-commas - 複数行のリテラルでは末尾にカンマを付けます

8. 書式とスタイル（低）

• format-braces-required - 制御構文では必ず波括弧を使用します
• format-column-limit - 1行を80文字以内にします
• format-one-statement-per-line - 1行に1つの文を記述します
• format-single-quotes - 文字列リテラルにはシングルクォートを使用します
• format-two-space-indent - 2スペースでインデントします

使用方法

詳しい説明とコード例については、個別のリファレンスファイルを参照してください。

• セクションの定義 - カテゴリーの構成と影響度
• ルールのテンプレート - 新しいルールを追加するためのテンプレート

完全版のコンパイル済みドキュメント

すべてのルールをまとめた完全版ガイドについては、AGENTS.mdを参照してください。

参考ファイル

ファイル	説明
AGENTS.md	すべてのルールをまとめた完全なガイド
references/_sections.md	カテゴリーの定義と順序
assets/templates/_template.md	新しいルール用のテンプレート
metadata.json	バージョンと参照情報