PhpStorm 2026.1 Help

JavaScript

PhpStorm を使用すると、 JavaScript を使って最新の Web、モバイル、デスクトップアプリケーションを開発できます。

JavaScript 対応のコーディング支援には、キーワード、ラベル、変数、パラメーター、関数の 補完エラーと構文ハイライト 、フォーマット、 コードインスペクションクイックフィックス 、さらに 一般および JavaScript 固有のリファクタリングが含まれます。 PhpStorm は、 JavaScript リンターFlow 型チェッカーとの統合も行います。

組み込みのデバッガーを使用すると、クライアント側とサーバー側の両方のコードをデバッグでき、 対話的なデバッガーコンソールで JavaScript コードスニペットを実行することもできます。 PhpStorm は、 Chrome または Chrome ファミリの他のブラウザーでのみ JavaScript のデバッグをサポートしている点に注意してください。 Chrome での JavaScript のデバッグ から詳細を参照してください。

PhpStorm は、 JestKarmaProtractorCucumberMocha テストフレームワークと統合します。 PhpStorm は、テストの実行やデバッグ、テストとサブジェクト間、あるいは失敗したテストと問題の原因となったコードのフラグメント間のナビゲーションにも対応しています。

このページには、Web アプリケーションの作成からデバッグやテストまでをステップ実行中に案内する短いスタートガイドがあります。

始める前に

設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript and TypeScript と入力します。 プラグインの詳細については、 プラグイン管理を参照してください。

新しいアプリケーションを作成する

PhpStorm で基本的な JavaScript プロジェクトを作成できるので、最小限の設定でプロジェクトをセットアップできます。 生成されたプロジェクトには、 console.log() ウェルカムメッセージを含む package.json ファイルと index.js ファイルが含まれており、さらにサンプル Web アプリケーションを生成することもできます。

デフォルトで、PhpStorm は自動的に Git リポジトリを作成し、 生成されたソースを Git 管理下に置きます

  1. ウェルカム 画面で 新規プロジェクト をクリックするか、メインメニューから ファイル | 新規 | プロジェクト を選択します。 新規 プロジェクト ダイアログが開きます。

  2. 左側のペインで、 新規プロジェクト を選択します。

  3. 右側のペインで、 JavaScript を選択し、プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。

  4. サンプル Web アプリケーションを生成するには、 オンボーディングのヒントを使用して playground プロジェクトを生成する チェックボックスを選択します。 PhpStorm は、 Vite テンプレートに基づいてプロジェクトを作成し、スムーズなオンボーディングのためのヒントを提供します。

  5. 作成 をクリックしてください。

既存の JavaScript アプリケーションから始める

既存の JavaScript アプリケーションの開発を継続する場合は、PhpStorm で開き、 使用する JavaScript バージョンを選択して、ライブラリを構成してください。 オプションで、 必要な npm 依存関係をダウンロードします

すでにマシン上にあるアプリケーションソースを開く

  • ウェルカム 画面で Open をクリックするか、メインメニューから ファイル | ディレクトリを開く を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

バージョン管理からアプリケーションのソースをチェックアウト

  1. ウェルカム 画面で リポジトリのクローン をクリックします。

    あるいは、メインメニューから ファイル | 新規 | バージョン管理からプロジェクト…Git | クローン…VCS | バージョン管理から取得 を選択します。

    メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例: Mercurial または Perforce​​

  2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする (クローン)を参照してください。

プロジェクトのセキュリティ

PhpStorm の外で作成しインポートされたプロジェクトを開くと、PhpStorm は未知のソースコードを扱う方法を決定できるダイアログを表示します。

次のいずれかのオプションを選択してください:

  • セーフモードでプレビュー :この場合、PhpStorm はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。

    PhpStorm はエディター領域上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックすればいつでもプロジェクトをロードできます。

  • プロジェクトを信頼 :この場合、PhpStorm はプロジェクトを開いてロードします。 つまり、プロジェクトが初期化され、プラグインが解決され、依存関係が追加され、すべての PhpStorm 機能が利用可能になります。

  • 開かない :この場合、PhpStorm はプロジェクトを開きません。

詳細については プロジェクトのセキュリティ を参照してください。

JavaScript 言語バージョンを選択する

信頼性が高く効率的なコーディング支援を得るには、プロジェクト内のすべての JavaScript ファイルでデフォルトで使用される言語バージョンを指定する必要があります。

  1. 設定 ダイアログ(Ctrl+Alt+S )で 言語 & フレームワーク | JavaScript に移動します。 JavaScript ページが開きます。

  2. リストからサポートされている JavaScript 言語バージョンのいずれかを選択します:

    • ECMAScript 5.1(英語)

    • ECMAScript 6 以降 (英語): このバージョンでは、ECMAScript 2015-2020 で導入された機能と JSX 構文のサポート、および標準に対するいくつかの現在の提案が追加されています。

    • Flow(英語): このバージョンでは、Flow 構文がサポートされています。

複数の JavaScript バージョンを使用する

ECMAScript 5.1 と新しいバージョンの ECMAScript の両方を使用するアプリケーションに取り組んでいる場合、最も簡単な方法は、 JavaScript ページ (設定 | 言語 & フレームワーク | JavaScript) のリストからプロジェクト全体の最も高い言語バージョンを選択することです。

  1. JavaScript ページで、 JavaScript 言語バージョン リストの横にある 閲覧ボタン をクリックします。 JavaScript 言語バージョン ダイアログが開きます。

  2. 追加 をクリックして表示されるダイアログで、カスタム言語バージョンが必要なフォルダーを選択します。 PhpStorm は、選択したフォルダーが パス フィールドに表示される JavaScript 言語バージョン ダイアログに戻ります。

  3. 言語 リストから、選択したフォルダー内のファイルの言語バージョンを選択します。 プロジェクトの他のすべての JavaScript ファイルでは、PhpStorm は JavaScript ページで選択したバージョンを使用します。

    個別のフォルダーの言語バージョンを選択する

JavaScript コードの JSX 構文

JavaScript コードで JSX 構文を使用している場合は、 ECMAScript 6 以降 を有効にします。

  • 設定 ダイアログ(Ctrl+Alt+S )で、 言語 & フレームワーク | JavaScript に移動し、 JavaScript 言語バージョン リストから ECMAScript 6 以降 を選択します。

  • JSX 構文が誤って使用された場合に警告されるようにするには、 設定 ダイアログ(Ctrl+Alt+S )を開き、 エディター | インスペクション に移動して、 JavaScript and TypeScript | 一般 ノードで JSX 構文の使用 インスペクションを有効にします。 検索フィールドを使用してインスペクションを見つけます。

    React JSX 構文インスペクションを有効にする

    オプションで、インスペクションの重大度とスコープを構成します。 コードインスペクションから詳細をご確認ください。

プロジェクトの依存関係をダウンロードする

アプリケーションでツールやライブラリ、フレームワークを使用する場合は、必要なパッケージをダウンロードしてください。 プロジェクトの依存関係管理には、 npmYarn 1Yarn 2 が利用でき、詳しくは npm と Yarn をご参照ください。

空のプロジェクトにパッケージをインストールする

  • 組み込み ターミナル (Alt+F12) で次のように入力します。

    npm install <package name>

すでにプロジェクトに package.json ファイルがある場合

  • エディターまたは プロジェクト ツールウィンドウ(Alt+1 )で package.json ファイルを右クリックし、コンテキストメニューから 'npm install' の実行 を選択します。

  • または、 ターミナル Alt+F12npm install を実行します。

プロジェクトの依存関係に合わせてコード補完を構成する

プロジェクトの依存関係に対するコード補完を提供するために、PhpStorm は自動的に node_modules ライブラリを作成します。 言語と IDE のコンテキストでは、 ライブラリはファイルまたはファイルのセットです。 これらのファイルの関数とメソッドは、編集するプロジェクトコードから PhpStorm が取得する関数とメソッドに加えて、PhpStorm の内部知識に追加されます。 詳細については、 JavaScript ライブラリを構成する および コード補完 を参照してください。

インレイヒントを見る

インレイヒントはエディターに表示され、コードの読みやすさや移動のしやすさのために追加情報を提供します。

パラメーターヒント

パラメーターヒントは、コードを読みやすくするためのメソッドや関数のパラメーター名を示します。 デフォルトでは、リテラルまたは関数式であるが名前付きオブジェクトではない値に対してのみ、パラメーターヒントが表示されます。

JavaScript のパラメーターヒント

パラメーターのヒントを設定する

  1. 設定 ダイアログ(Ctrl+Alt+S )を開き、 エディター | インレイヒント に進みます。

  2. パラメーター名JavaScript を展開します。

  3. 該当するチェックボックスを選択して、パラメーターヒントを表示したいコンテキストを指定します。

    プレビューは、設定の変更がコードの見た目にどのように反映されるかを表示します。

  4. 一部のメソッドや関数では、PhpStorm はどのコンテキストでもパラメーターヒントを表示しません。 除外リスト… をクリックして、これらのメソッドと機能を表示したり、それらのパラメーターヒントを有効にしたり、リストに新しいアイテムを追加したりします。

  5. 任意のコンテキストで任意の値型のパラメーターヒントを非表示にするには、 パラメーター名JavaScript チェックボックスをオフにします。

戻り型のヒント

PhpStorm は関数呼び出しや呼び出しチェーンで関数の戻り値の型を表示できます。

  • 関数の戻り値の型ヒントは、 JSDoc コメントから、またはコードの静的解析に基づき推論されます。

  • メソッドチェーンで型ヒントを返すは、メソッド呼び出しが複数行に分かれており、少なくとも 2 つの異なる型を返す場合に表示されます。

    メソッドチェーンの戻り値の型ヒントは、内部 PhpStorm エバリュエーターによって提供されます。

メソッドの戻り型のヒントを構成する

  1. 設定 ダイアログ(Ctrl+Alt+S )を開き、 エディター | インレイヒント に進みます。

  2. タイプJavaScript ノードを展開し、 関数の戻り値の型 チェックボックスをオンにします。

  3. メソッドチェーンで戻り値の型のヒントを表示するには、 メソッドチェーン ノードを展開し、 JavaScript チェックボックスを選択します。

プレビューは、設定の変更がコードの見た目にどのように反映されるかを表示します。

型ヒント

型ヒントは、変数、フィールド、パラメーターの型を示します。 変数とフィールドの型は、その定義の横に表示されます。 パラメーターの型ヒントは関数呼び出しに表示されます。 型ヒントは JSDoc コメントやコードの静的解析から推論されます。

JavaScript でアノテーションを入力する

型ヒントを構成する

  1. 設定 ダイアログ(Ctrl+Alt+S )を開き、 エディター | インレイヒント に進みます。

  2. カテゴリのツリーで、 タイプ | JavaScript を展開します。

  3. 型ヒントを表示するコンテキストを指定してください。

    プレビューは、設定の変更がコードの見た目にどのように反映されるかを表示します。

  4. 任意のコンテキストで任意の値の型のパラメーターパラメーターの型と戻り型のヒントを非表示にするには、 タイプJavaScript チェックボックスをオフにします。

Import ステートメントの追加

PhpStorm はエクスポートされているモジュール、クラス、コンポーネント、その他のシンボルのためにインポートステートメントを生成できます。 インポートステートメントは、シンボルの作成時にその場で追加することも、後からインポートツールチップ、クイックフィックス、インテンションアクションを使用して追加することもできます。 詳細については 自動インポート を参照してください。

PhpStorm は、 ES6 または CommonJS のスタイルでインポートステートメントを生成することができます。 PhpStorm は、インポートステートメントのスタイルを自動で決定するか、必要なスタイルを選択できるポップアップを表示します。

PhpStorm がファイルで使用すべき構文を自動的に判別できない場合、ES6 構文と CommonJS 構文のどちらかを選択できるポップアップが表示されます。

クイックフィックス: インポートスタイルを選択

コード補完に ES6 インポート文を常に自動的に追加するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | 一般 | 自動インポート に移動して、 TypeScript/JavaScript 領域の JavaScript のインポートを自動的に追加する チェックボックスを選択します。

ES6 インポートステートメントを追加する

インポートステートメントは、シンボルの作成時にその場で追加することも、後からインポートツールチップ、クイックフィックス、インテンションアクションを使用して追加することもできます。

プロジェクトから ES6 モジュールであるファイル、またはすでに ES インポートステートメントが含まれているファイルにシンボルをインポートする場合、PhpStorm はシンボル補完時に自動的に ES6 インポートを挿入します。

コード補完時に ES6 のインポートを追加する

    未解決のシンボルにカーソルを合わせると、自動インポートのツールチップが表示され、インポート文を追加するように提案されます。

    • 提案を受け入れるには、 Alt+Enter を押してください。

      自動インポートツールチップを使用して ES6 インポートを追加する
    • ツールチップを無効にするには、エディターの右上隅にあるインスペクションウィジェットにカーソルを合わせ、 詳細 をクリックして、 自動インポートツールチップを表示 オプションのチェックを外します。

      自動インポートツールチップを無効にする

    以前の JavaScript バージョンや、 補完時の自動インポートが無効化されている場合、PhpStorm はシンボルを未解決としてマークし、エラーの説明とクイックフィックスの提案が表示されるポップアップを表示します:

    • 提案を受け入れるには、 Alt+Shift+Enter を押してください。

      クイックフィックスによる自動インポート: 情報ツールチップ
    • または、 Alt+Enter を押します。

      クイックフィックスによる自動インポート: 候補リスト
    • インポートソースが複数ある場合、PhpStorm は候補リストを表示します:

      クイックフィックスによる自動インポート: 多肢選択

    PhpStorm は、プロジェクトの依存関係で定義されたシンボルのインポートステートメントも生成できます。 自動インポートは、 TypeScript 定義ファイル(英語)を含むパッケージ(moment(英語)redux(英語) など)や ES モジュールとして記述されたソースのシンボルに対して機能します。

    現在のファイルにすでに ES6 インポートステートメントが含まれている場合、PhpStorm は新しいステートメントも ES6 スタイルで挿入します。

    Auto import from project dependencies

    CommonJS(必須)インポートステートメントを追加する

    プロジェクトからすでに CommonJS モジュール(require ステートメントまたは module.export )であるファイルにシンボルをインポートする場合、PhpStorm はシンボル補完時に自動的に CommonJS インポートを挿入します。

    Auto import with CommonJS import statement

    あるいは、インポートするシンボルにキャレットを置き、 Alt+Enter を押して、CommonJS (require) インポートスタイルのクイックフィックスを選択します。

    クイックフィックス: インポートスタイルを選択

    import defer ステートメントを追加する

    PhpStorm は JavaScript コンテキストでの import defer構文をサポートし、コード補完、エラーハイライト、 import ステートメントのライブテンプレートや使用箇所の検索が可能です。

    import.defer 構文もサポートされています。

    インポートソースステートメントを追加する

    PhpStorm は JavaScript コンテキストでの import source構文をサポートし、コード補完、エラーハイライト、 import ステートメントのライブテンプレートや使用箇所の検索が可能です。

    import.source 構文もサポートされています。

    自動インポートを構成する

    1. コード補完に ES6 インポート文を常に自動的に追加するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | 一般 | 自動インポート に移動して、 TypeScript/JavaScript 領域の JavaScript のインポートを自動的に追加する チェックボックスを選択します。

    2. import ステートメントの外観を構成するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | コードスタイル | JavaScript に移動し、 インポート タブのコントロールを使用します。 詳細については、「インポートタブ 」を参照してください。

    構文ハイライトを構成する

    JavaScript 対応の構文ハイライトは、環境設定や使い方に応じて設定できます。

    1. 設定 ダイアログ(Ctrl+Alt+S )で エディター | カラースキーム | JavaScript に移動します。

    2. カラースキームを選択し、デフォルトから継承されたハイライト設定を使用するか、 色とフォント の説明に従ってカスタマイズできます。

    コードの整形

    PhpStorm では、現在の コードスタイルスキームに従って JavaScript コードを整形できます。

    .editorconfig でフォーマット設定を指定したり、 Prettier を利用することもできます

    デコレーター

    デコレータでは、整形時に各デコレータの後へ改行を挿入しないことが重要な場合があります。

    デコレーターのためのフォーマットオプションは以下の通りです:

    折り返さない

    このオプションを選択すると、装飾文字を使用して行を再フォーマットする際に、折り返しは適用されません。

    長い場合は折り返す

    このオプションを選択すると、行が右端を超えた場合に折り返されます。

    右余白は 次でハードラップ フィールドが 設定 | エディター | コードスタイル | JavaScript | 折り返しと波括弧 上で定義されています。 行が指定された数値を超えると、折り返されます。

    長い場合は切り捨てる

    このオプションを選択すると、デコレーターが右余白を超える場合、1 行に 1 つフォーマットされます。

    常に折り返す

    このオプションを選択すると、全てのデコレーターが 1 行に 1 つずつフォーマットされます。

    ブラウザーで JavaScript を実行する

    1. エディターで、JavaScript リファレンスを使用して HTML ファイルを開きます。 この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。

    2. 次のいずれかを実行します:

      • メインメニューから 表示 | ブラウザーで開く を選択するか、 Alt+F2 を押します。 次にリストから目的のブラウザーを選択します。

      • コードの上にカーソルを置くと、ブラウザーのアイコンバー the PhpStorm icon Chrome Firefox Safari Opera Internet Explorer Edge が表示されます。 目的のブラウザーを示すアイコンをクリックします。

    JavaScript のデバッグ

    PhpStorm は、 Chrome または Chrome ファミリの他のブラウザーで動作するクライアントサイド JavaScript コード用に組み込みデバッガーを提供します。 PhpStorm を使用すると、組み込みサーバー、外部サーバー、またはリモートサーバーで実行されている JavaScript アプリケーションをデバッグできます。 詳細については、 Chrome での JavaScript のデバッグ を参照してください。

    2026 年 5 月 22 日