JavaScript
PyCharm を使うと、 JavaScript で最新の Web、モバイル、デスクトップアプリケーションを開発できます。
利用できる機能は、契約の種類によって異なります。
JavaScript 対応のコーディング支援には、キーワード、ラベル、変数、パラメーター、関数の 補完、 エラーと構文ハイライト 、フォーマット、 コードインスペクションや クイックフィックス 、および 一般的および JavaScript 固有のリファクタリングが含まれます。 PyCharm は JavaScript リンターとも統合されています。
JavaScript 対応のコーディング支援には、キーワード、ラベル、変数、パラメーター、関数の 補完、 エラーと構文ハイライト 、フォーマット、 コードインスペクションや クイックフィックス 、および 一般的および JavaScript 固有のリファクタリングが含まれます。 PyCharm は、 JavaScript リンターや Flow 型チェッカーとも統合できます。
組み込みのデバッガーを使用すると、クライアント側とサーバー側の両方のコードをデバッグでき、 対話的なデバッガーコンソールで JavaScript コードスニペットを実行することもできます。 PyCharm は、 Chrome または Chrome ファミリの他のブラウザーでのみ JavaScript のデバッグをサポートしています。 Chrome での JavaScript のデバッグ から詳細を参照してください。
PyCharm は Jest、 Karma、 Protractor、 Cucumber、 Mochaテストフレームワークと統合します。 PyCharm は、テストの実行・デバッグ、およびテストとサブジェクト間や、失敗したテストと問題を引き起こしたコード片間のナビゲーションをサポートしています。
このページには、Web アプリケーションの作成からデバッグやテストまでを順を追って説明する短いスタートガイドが掲載されています。
始める前
設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript and TypeScript と入力します。 プラグインの詳細については、 Managing plugins を参照してください。
新しいアプリケーションを作成する
PyCharm では基本的な JavaScript プロジェクトを作成できるため、最小限の構成でプロジェクトをセットアップできます。 生成されたプロジェクトには、 console.log() ウェルカムメッセージを含む package.json ファイルと index.js ファイルが含まれており、さらにサンプル Web アプリケーションを生成することもできます。
デフォルトで、PyCharm は自動的に Git リポジトリを作成し、 生成されたソースを Git の管理下に置きます。
ようこそ 画面で 新規プロジェクト をクリックするか、メインメニューから を選択します。 新規 Project ダイアログが開きます。
左側のペインで、JavaScript アプリケーションの開発を目的とするプロジェクトタイプ(Angular CLI、AngularJS、React アプリ、React Native など)を選択します。
右側のウィンドウで、プロジェクト関連のファイルが保存されるフォルダーのパスを指定します。
More settings を展開し、その他の必要なプロジェクトオプションを指定します。
既存の JavaScript アプリケーションから始める
既存の JavaScript アプリケーションの開発を続ける場合は、PyCharm で開き、 使用する JavaScript バージョンを選択して、その中でライブラリを構成してください。 オプションで、 必要な npm 依存関係をダウンロードします。
すでにマシン上にあるアプリケーションソースを開く
ようこそ 画面の左側のペインで オープン をクリックするか、メインメニューから を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。
バージョン管理からアプリケーションのソースをチェックアウト
ようこそ 画面の左側のペインで クローン をクリックします。
あるいは、メインメニューから 、 、 を選択します。
メインメニューの Gitサポート の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例: Mercurial または Perforce。
表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする (クローン) を参照してください。
プロジェクトのセキュリティ
PyCharm の外部で作成され、インポートされたプロジェクトを開くと、PyCharm は知らないソースコードを含むプロジェクトをどのように処理するか決定できるダイアログを表示します。

次のいずれかのオプションを選択します:
セーフモードでプレビュー :この場合、PyCharm はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。
PyCharm はエディター領域の上部に通知を表示し、 Trust project… リンクをクリックして、いつでもプロジェクトをロードできます。
プロジェクトを信頼 :この場合、PyCharm はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての PyCharm 機能が利用可能になることを意味します。
開かない :この場合、PyCharm はプロジェクトを開きません。
詳細は プロジェクトのセキュリティ をご覧ください。
JavaScript 言語バージョンを選択する
信頼性が高く効率的なコーディング支援を得るには、プロジェクトのすべての JavaScript ファイルでデフォルトで使用される言語バージョンを指定する必要があります。
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。 JavaScript ページが開きます。
リストからサポートされている JavaScript 言語バージョンのいずれかを選択してください:
ECMAScript 6 以降 (英語): このバージョンでは、ECMAScript 2015-2020 で導入された機能と JSX 構文のサポート、および標準に対するいくつかの現在の提案が追加されています。
Flow(英語): このバージョンでは、Flow 構文がサポートされています。
複数の JavaScript バージョンを使用する
ECMAScript 5.1 と新しいバージョンの ECMAScript の両方を使用するアプリケーションに取り組んでいる場合、最も簡単な方法は、 JavaScript ページ () のリストからプロジェクト全体の最も高い言語バージョンを選択することです。
JavaScript ページで、 JavaScript language version リストの横にある
をクリックします。 JavaScript Language Versions ダイアログが開きます。
をクリックして表示されるダイアログで、カスタム言語バージョンが必要なフォルダーを選択します。 PyCharm は、選択したフォルダーが パス フィールドに表示される JavaScript Language Versions ダイアログに戻ります。
言語 リストから、選択したフォルダー内のファイルの言語バージョンを選択します。 プロジェクト内の他のすべての JavaScript ファイルに対して、PyCharm は JavaScript ページで選択されたバージョンを使用します。

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

オプションで、インスペクションの重大度とスコープを構成します。 コードインスペクションから詳細を参照してください。
プロジェクトの依存関係をダウンロードする
アプリケーションでツールやライブラリ、フレームワークを使用する場合は、必要なパッケージをダウンロードしてください。 プロジェクトの依存関係を管理するには、 npm、 Yarn 1 、または Yarn 2を利用し、詳細は npm と Yarnを参照してください。
空のプロジェクトにパッケージをインストールする
組み込み ターミナル (Alt+F12) で次のように入力します。
npm install <package name>。
すでにプロジェクトに package.json ファイルがある場合
エディターまたは Project ツールウィンドウ(Alt+1 )で package.json ファイルを右クリックし、コンテキストメニューから 'npm install' の実行 を選択します。
または、 ターミナル Alt+F12 で
npm installを実行します。
プロジェクトの依存関係に合わせてコード補完を構成する
プロジェクトの依存関係に対してコード補完を提供するため、PyCharm は自動的に node_modulesライブラリを作成します。 言語および IDE のコンテキストでは、 ライブラリはファイルまたはファイルのセットです。 これらのファイルの関数やメソッドは、編集されているプロジェクトコードから PyCharm が取得する関数やメソッドに加えて、PyCharm の内部知識に追加されます。 詳細については、 JavaScript ライブラリを構成する および コード補完 を参照してください。
インレイヒントを見る
インレイヒントはエディターに表示され、コードに関する追加情報を提供して、読みやすくナビゲートしやすくします。
パラメーターヒント
パラメーターヒントは、コードを読みやすくするためのメソッドや関数のパラメーター名を示します。 デフォルトでは、リテラルまたは関数式であるが名前付きオブジェクトではない値に対してのみ、パラメーターヒントが表示されます。

パラメーターのヒントを設定する
設定 ダイアログ(Ctrl+Alt+S )を開き、 に進みます。
パラメーター名 の JavaScript を展開します。
対応するチェックボックスを選択して、パラメーターヒントを表示するコンテキストを指定します。
プレビューには、設定で行った変更がコードの外観にどのように影響するかが表示されます。
一部のメソッドや関数では、PyCharm はどのコンテキストでもパラメーターヒントを表示しません。 除外リスト… をクリックして、これらのメソッドと機能を表示したり、それらのパラメーターヒントを有効にしたり、リストに新しいアイテムを追加したりします。
任意のコンテキストで任意の値型のパラメーターヒントを非表示にするには、 パラメーター名 の JavaScript チェックボックスをオフにします。
戻り型のヒント
PyCharm は、関数呼び出しや呼び出しチェーンで関数の戻り値の型を表示できます。
関数の戻り値のヒントは、 JSDoc コメントから、またはコードの静的解析に基づいて推論されます。
メソッドチェーンで型ヒントを返すは、メソッド呼び出しが複数行に分かれており、少なくとも 2 つの異なる型を返す場合に表示されます。
メソッドチェーンの戻り値の型のヒントは、内部 PyCharm エバリュエーターによって提供されます。
メソッドの戻り型のヒントを構成する
設定 ダイアログ(Ctrl+Alt+S )を開き、 に進みます。
タイプ で JavaScript ノードを展開し、 関数の戻り値の型 チェックボックスをオンにします。
メソッドチェーンで戻り値の型のヒントを表示するには、 メソッドチェーン ノードを展開し、 JavaScript チェックボックスを選択します。
プレビューには、設定で行った変更がコードの外観にどのように影響するかが表示されます。
型ヒント
型ヒントは、変数、フィールド、パラメーターの型を示します。 変数とフィールドの型は、その定義の横に表示されます。 パラメーターの型ヒントは関数呼び出しに表示されます。 型ヒントは、 JSDoc コメントまたはコードの静的解析から推論されます。

型ヒントを構成する
設定 ダイアログ(Ctrl+Alt+S )を開き、 に進みます。
カテゴリのツリーで、 を展開します。
型ヒントを表示するコンテキストを指定してください。
プレビューには、設定で行った変更がコードの外観にどのように影響するかが表示されます。
任意のコンテキストで任意の値の型のパラメーターパラメーターの型と戻り型のヒントを非表示にするには、 タイプ の JavaScript チェックボックスをオフにします。
Import ステートメントの追加
PyCharm は、モジュール、クラス、コンポーネント、そしてエクスポートされているその他のシンボルに対してインポート文を生成できます。 インポートステートメントは、シンボルの作成時にその場で追加することも、後からインポートツールチップ、クイックフィックス、インテンションアクションを使用して追加することもできます。 詳細は 自動インポート をご覧ください。
PyCharm は、 ES6 スタイルまたは CommonJS スタイルのインポート文を生成できます。 PyCharm は、インポート文のスタイルを自動的に決定するか、必要なスタイルを選択できるポップアップを表示します。
PyCharm がファイルで使用する構文を自動的に判別できない場合、ES6 構文と CommonJS 構文のどちらかを選択できるポップアップが表示されます。

コード補完に ES6 インポート文を常に自動的に追加するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 に移動して、 TypeScript / JavaScript 領域の Add JavaScript imports automatically チェックボックスを選択します。
ES6 インポートステートメントを追加する
インポートステートメントは、シンボルの作成時にその場で追加することも、後からインポートツールチップ、クイックフィックス、インテンションアクションを使用して追加することもできます。
プロジェクトから ES6 モジュールまたは既に ES インポート文を含むファイルにシンボルをインポートする場合、PyCharm はシンボル補完時に自動で ES6 インポートを挿入します。

未解決のシンボルにカーソルを合わせると、自動インポートのツールチップが表示され、インポート文を追加するように提案されます。
提案を受け入れるには、 Alt+Enter を押してください。

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

以前の JavaScript バージョン、または 完了時の自動インポートが無効の場合 、PyCharm はシンボルを未解決としてマークし、エラーの説明と推奨されるクイックフィックスを示すポップアップを表示します:
提案を受け入れるには、 Alt+Shift+Enter を押してください。

または、 Alt+Enter を押します。

インポートの可能なソースが複数ある場合、PyCharm が候補のリストを表示します:

PyCharm は、プロジェクトの依存関係で定義されたシンボルのインポート文も生成できます。 自動インポートは、 TypeScript 定義ファイル(英語)を含むパッケージ(moment(英語) や redux(英語) など)や ES モジュールとして記述されたソースのシンボルに対して機能します。
現在のファイルに既に ES6 インポート文が含まれている場合、PyCharm も ES6 スタイルで新しいものを挿入します。

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

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

import defer ステートメントを追加する
PyCharm は、JavaScript コンテキストで import defer 構文をサポートし、コード補完、エラーのハイライト、 import ステートメントのライブテンプレートや使用箇所の検索が可能です。
import.defer 構文もサポートされています。
インポートソースステートメントを追加する
PyCharm は、JavaScript コンテキストで import source 構文をサポートし、コード補完、エラーのハイライト、 import ステートメントのライブテンプレートや使用箇所の検索が可能です。
import.source 構文もサポートされています。
自動インポートを構成する
コード補完に ES6 インポート文を常に自動的に追加するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 に移動して、 TypeScript / JavaScript 領域の Add JavaScript imports automatically チェックボックスを選択します。
importステートメントの外観を構成するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 に移動し、 インポート タブのコントロールを使用します。 詳細については、「インポートタブ 」を参照してください。
構文ハイライトを構成する
好みや習慣に合わせて、JavaScript 対応の構文ハイライトを設定できます。
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
配色を選択するか、デフォルトから継承されたハイライト設定を受け入れるか、 色とフォント の説明に従ってカスタマイズできます。
コードの整形
PyCharm を使えば、現在の コードスタイルスキームに従って JavaScript コードを整形できます。
.editorconfig でフォーマット設定を指定したり、 Prettier. を使ったりすることもできます。
デコレーター
デコレーターの場合、再フォーマット時に各デコレーターの後へ改行を挿入しないことが重要な場合があります。
デコレータに利用できるフォーマットオプションは次のとおりです:
折り返さない
このオプションを選択すると、装飾文字を使用して行を再フォーマットする際に、折り返しは適用されません。
長い場合は折り返す
このオプションを選択すると、右余白を超える行は折り返されます。
右余白は、 次でハードラップ フィールドが 設定 | エディター | コードスタイル | JavaScript | 折り返しと波括弧 にあります。 行が指定された数値を超えると、折り返されます。
長い場合は切り捨てる
このオプションを選択すると、デコレータが右余白を超える場合、1 行ごとに 1 つずつフォーマットされます。
常に折り返す
このオプションを選択すると、すべてのデコレータは 1 行ごとに 1 つずつフォーマットされます。
ブラウザーで JavaScript を実行する
エディターで、JavaScript リファレンスを使用して HTML ファイルを開きます。 この HTML ファイルは、必ずしもアプリケーションの開始ページを実装するものである必要はありません。
次のいずれかを実行します:
メインメニューから を選択するか、 Alt+F2 を押します。 次にリストから目的のブラウザーを選択します。
コードの上にカーソルを置くと、ブラウザーのアイコンバー
が表示されます。 目的のブラウザーを示すアイコンをクリックします。
JavaScript のデバッグ
PyCharm は、 Chrome または Chrome ファミリの他のブラウザーで動作するクライアントサイド JavaScript コード用の組み込みデバッガーを提供します。 PyCharm を使用すれば、組み込みサーバー、外部サーバー、リモートサーバーで稼動している JavaScript アプリケーションもデバッグできます。 詳細は Chrome での JavaScript のデバッグ をご参照ください。