JavaScript ライブラリを構成する
言語と IDE のコンテキストでは、 ライブラリはファイルまたはファイルのセットです。 これらのファイルの関数やメソッドは、編集対象プロジェクトのコードから GoLand が取得する関数やメソッドに加えて、GoLand の内部知識として追加されます。 プロジェクトのスコープでは、そのライブラリはデフォルトで書き込み保護されています。
GoLand は 2 つの事前定義された自動生成ライブラリフォルダーを予約します：
node_modules プロジェクト package.json の
依存関係オブジェクトにリストされている Node.js パッケージを保持します。 詳細については、 node_modules ライブラリの構成を参照してください。ダウンロードした TypeScript 定義ファイルや CDN リンクから参照したライブラリ、 Node.js コア結節や任意の カスタムサードパーティライブラリを格納するための 外部ライブラリ 。
TypeScript コミュニティスタブをダウンロード (TypeScript 定義ファイル)
GoLand では、 DefinitelyTyped スタブをライブラリとして設定および使用できます。これは、次のような場合に特に役立ちます。
コード補完を改善するには、GoLand の静的解析で解析できないほど高度なライブラリやフレームワークのシンボルを解決し、そのようなシンボルに型情報を追加します。
テストフレームワークからグローバルに定義されたシンボルを解決します。
以下の例は、 post() 関数が解決されていない Express アプリケーションのコードを示しています。
TypeScript 定義ファイルをインストールすると、GoLand は post() を正常に解決します：
GoLand を使用すると、インテンションアクションを使用してエディターから直接 TypeScript 定義ファイルをダウンロードできます。または、 設定: JavaScript ライブラリ ページでそれを行うこともできます。
インテンションアクションを使用して TypeScript 定義をダウンロードする
このライブラリまたはフレームワークの
インポートまたはrequireステートメントにキャレットを置き、 Alt+Enter を押して、 より良いタイプ情報を得るための TypeScript 定義のインストール を選択します。GoLand はライブラリの型定義をダウンロードし、 JavaScript。 ライブラリ ページのライブラリリストに追加します：
あるいは、 package.json を開き、型定義をダウンロードするパッケージにキャレットを置き、 Alt+Enter を押して、 「@types/<package name>」をインストールする。 を選択します。
JavaScript ライブラリページで TypeScript 定義をダウンロードする
Ctrl+Alt+S を押して設定を開き、 を選択します。
開いた ライブラリ ページで ダウンロード をクリックし、開いた ライブラリのダウンロード ダイアログで必要なライブラリを選択し、 ダウンロードしてインストール をクリックします。
GoLand は、ダウンロードした型定義を プロジェクト ツールウィンドウ（Alt+1 ）の 外部ライブラリ ノードの下に表示します。
Node.js コアライブラリを構成する
Node.js バイナリにコンパイルされる fs(英語)、 path(英語)、 http(英語) などのコアモジュールのコード補完と参照解決を取得するには、 Node.js コアモジュールソースを JavaScript ライブラリとして構成する必要があります。
Ctrl+Alt+S を押して設定を開き、 を選択します。
推奨ランタイム フィールドで Node.js が選択されていることを確認してください。
Node.js ランタイム リストから必要な Node.js インストールを選択します。
Node.js コーディング支援 チェックボックスを選択します。
Node.js Core ライブラリはバージョン固有であることに注意してください。 そのため、Node.js のバージョンを変更した場合は、チェックボックスを再度選択する必要があります。 その後、GoLand はこの新しいバージョン用の新しいライブラリを作成します。
node_modules ライブラリを構成する
プロジェクトの依存関係にコード補完を提供するため、GoLand は node_modules ライブラリを自動的に作成し、Node.js モジュールはプロジェクトに保持されますが、それらに対してインスペクションは実行されず、パフォーマンスが向上します。
プロジェクト ツールウィンドウ（Alt+1 ）では、 node_modules もライブラリとしてマークされています。
ただし、 node_modules ライブラリには、プロジェクトの package.json ファイルの 依存関係 オブジェクトにリストされているモジュールのみが含まれています。 GoLand は依存関係の依存関係を node_modules ライブラリに含めず、実際にはそれらをプロジェクトから除外します。
ライブラリのスコープを構成する
GoLand が、クライアント側コードで Node.js API など無関係な補完を提案する場合があります。 これは、デフォルトで GoLand がプロジェクトフォルダー全体の補完のためにライブラリを使用するためです。 GoLand では、ライブラリのスコープを設定することでコード補完を調整できます。
Ctrl+Alt+S を押して設定を開き、 を選択します。
ライブラリ ページには、利用可能なライブラリのリストが表示されます。
必要なライブラリの横にある 有効化 チェックボックスをオフにして、 スコープの管理 をクリックします。
{0} ライブラリ使用スコープ ダイアログで、 追加 ボタン (
) をクリックし、ライブラリスコープに含めるファイルまたはフォルダーを選択します。 {0} ライブラリ使用スコープ ダイアログでは、 パス フィールドに選択したファイルまたはフォルダーが表示されます。追加されたファイルまたはフォルダーごとに、 ライブラリ リストから、構成するライブラリを選択します。
サンプル: HTML および Node.js コアライブラリのスコープを構成する
GoLand でフルスタック JavaScript アプリケーションを扱っていると、コード補完がクライアント側コードに Node.js API を、Node.js コードに DOM API を提案することがよくあります。 これは、DOM API を使用する HTML ライブラリと Node.js API を使用する Node.js コアライブラリがプロジェクト全体でデフォルトで有効になっているために発生します。 無関係な補完候補を取り除くには、これらのライブラリのスコープを構成する必要があります。
Ctrl+Alt+S を押して設定を開き、 を選択します。
ライブラリ ページには、利用可能なライブラリのリストが表示されます。
HTML および Node.js コア 項目の横にある 有効化 チェックボックスをオフにします。
スコープの管理 をクリックしてください。 「JavaScript ライブラリの使用スコープ 」ダイアログが開きます。
HTML ライブラリのスコープを構成するには、「
」をクリックします。開いたダイアログで、クライアント側のコードが含まれるフォルダーを選択し、 開く をクリックします。
JavaScript ライブラリの使用スコープ ダイアログに戻り、選択したフォルダーがリストに追加されます。
各フォルダーの横にある ライブラリ リストから、 HTML を選択します。
Node.js コア ライブラリのスコープを構成するには、
を再度クリックし、サーバー側コードを含むフォルダーを追加し、それぞれに対して ライブラリ リストから Node.js コア を選択します。現在、GoLand は HTML および Node.js コアライブラリのアイテムを解決し、これらの選択したプロジェクトフォルダー内のファイルでのみ補完を提案します。
同様に、自動生成される node_modules ライブラリのスコープも設定できます。詳しくは Configuring node_modules library を参照してください。
CDN リンク経由で追加されたライブラリを構成する
ライブラリ .js ファイルが CDN リンク経由で参照される場合、ランタイムでは利用できますが、GoLand では認識できません。 そのようなライブラリ .js ファイルから補完リストにオブジェクトを追加するには、ファイルをダウンロードして外部ライブラリとして構成します。
ライブラリをダウンロードする
ライブラリへの CDN リンクにキャレットを置き、 Alt+Enter を押して、リストから ライブラリをダウンロード を選択します。
ライブラリは GoLand のキャッシングにダウンロードされ（プロジェクトには保存されません）、情報メッセージ付きのポップアップが表示されます：
JavaScript ライブラリ ページで、ダウンロードしたライブラリがリストに追加されます。
プロジェクト ツールウィンドウ（Alt+1 ）では、ライブラリは 外部ライブラリ ノードに表示されます。
ライブラリの可視性を変更する
デフォルトで、GoLand はダウンロードしたライブラリに グローバル をマークします。これは、他の GoLand プロジェクトでも有効化して再利用できることを意味します。 このデフォルト設定を変更するには、一覧でダウンロードしたライブラリを選択し、 編集 をクリックして、表示された ライブラリの編集 ダイアログで プロジェクト を選択します。
カスタムのサードパーティ JavaScript ライブラリを構成する
プロジェクトまたはマシン上の他の場所に JavaScript フレームワークファイルがあり、それを編集可能なプロジェクトコードとしてではなく、ライブラリとして GoLand で扱いたい場合があります。
必要なフレームワークファイルをダウンロードします。
Ctrl+Alt+S を押して設定を開き、 を選択します。
ライブラリ ページで、 追加 をクリックします。
新規ライブラリ ダイアログで、外部 JavaScript ライブラリの名前を指定します。
追加 ボタン (
) をクリックし、リストから ファイルを添付… または ディレクトリを添付… を選択します。
ファイルブラウザーで、ダウンロードしたフレームワークのファイルまたはフォルダーを選択します。
OK をクリックすると、 ライブラリ ページに戻り、新しいライブラリがリストに追加されます。
プロジェクト ツールウィンドウ（Alt+1 ）では、ライブラリは 外部ライブラリ ノードに表示されます。
オプション
デフォルトでは、ライブラリは現在のプロジェクト全体の有効範囲で有効になっています。 ライブラリのスコープの構成の説明に従って、このデフォルト設定を変更することができます。
ドキュメント URL 領域で、ライブラリまたはフレームワークの公式ドキュメントへのパスを指定します。 このライブラリのシンボルで Shift+F1 を押すと、GoLand はこの URL を開きます。
ファイルに関連付けられたライブラリを表示する
エディターでファイルを開き、 Ctrl+Shift+A を押して、リストから JavaScript ライブラリの使用 を選択します。
GoLand には、利用可能な構成済みライブラリのリストが表示されます。 現在のファイルに関連付けられているライブラリにはチェックマークが付いています。
現在のファイルをライブラリのスコープから削除するには、このライブラリの横にあるチェックマークを外します。
ライブラリを現在のファイルに関連付けるには、このライブラリの横にチェックを入れます。
ライブラリを削除する
Ctrl+Alt+S を押して設定を開き、 を選択します。
ライブラリ ページには、使用可能なライブラリのリストが表示されます。
ライブラリを選択して 削除 をクリックします。