JSLintプラグイン

• 概要
• インストール手順
  • プラグインのインストール
    • アップデートサイトから取得できない場合
    • 任意のバージョンのJSLint, JSHintを使用する場合
• 機能
  • JSLintのオプションを設定する
  • メッセージで問題ビューに反映するエラーをフィルタリングする
  • 他プロジェクトの設定を利用する
  • 保管時に自動的にチェックを実行する
  • チェック対象ソースを指定する
  • ライブラリを指定する
• バージョンアップ履歴
  • ver.1.2.1
  • ver.1.2.0
  • ver.1.1.0
  • ver.1.0.0

概要

JSLint ・JSHint をEclipse上で簡単に実行できるようにするためのEclipseプラグインです。

主な機能

• JSLintまたはJSHintを利用したJavaScriptファイルの構文チェック
• JSDTのインクルードパス連携
• 保管時に自動チェック
• ライブラリ選択
• エラーメッセージによるフィルタリング機能
• 他プロジェクト設定参照機能

インストール手順

プラグインのインストール

1. アップデートサイトからJSLintプラグインをインストールします。
2. プロジェクトプロパティ -> JSLint設定からチェックエンジンファイル(JSLint.jsまたはJSHint.js)を設定します。
   1. JSLintファイルパス項目のファイル選択ボタンをクリックします。
   2. JSLintかJSHintを選択、出力先ディレクトリを指定しOKを押下します。
   3. ライセンスに同意しOKを押下します。
3. チェックを行うプロジェクト、またはjsファイルを右クリック -> CheckJavascript -> jslint コードチェック実行します。
4. 問題ビュー及びマーカーで指摘箇所を確認します。

アップデートサイトから取得できない場合

1. 下記よりjarファイルを取得し、展開したフォルダをeclipseフォルダのfeaturesにコピーしてください
   http://www.htmlhifive.com/eclipse-plugins/updatesite/features/com.htmlhifive.tools.jslint_1.2.1.v201601141519.jar
2. 下記よりjarファイルを取得し、展開したフォルダをeclipseフォルダのpluginsにコピーしてください
   http://www.htmlhifive.com/eclipse-plugins/updatesite/plugins/com.htmlhifive.tools.jslint.H5JSLintPluginLibrary_1.0.1.v201601141519.jar
3. 下記よりjarファイルを取得し、取得したファイルをeclipseフォルダのpluginsにコピーしてください
   http://www.htmlhifive.com/eclipse-plugins/updatesite/plugins/com.htmlhifive.tools.jslint.H5JSLintPlugin_1.2.1.v201601141519.jar

任意のバージョンのJSLint, JSHintを使用する場合

プラグインを利用してJSLint.js等を取得する場合、プラグイン側で動作が確認できるバージョンを取得します。他のバージョンを使用したい場合は以下のサイトから取得してください。

1. JSLint取得先
   • https://github.com/douglascrockford/JSLint のjslint.jsを取得する。
2. JSHintダウンロード先
   • https://github.com/jshint/jshint のjshint.jsを取得する。

機能

JSLintのオプションを設定する

JSLintのオプションを変更するときに指定します。

1. プロジェクトプロパティ -> JSLint設定 -> JSLint設定ファイルパス -> 新規ボタンを押下します。
2. 出力先ディレクトリと設定ファイル名を入力しOKボタンを押下します。
3. 編集ボタンを押下します。
   • 編集ボタンはエンジンファイルが設定されていないと有効になりません。
4. 有効にするプロパティにチェックを入れOKボタンを押下します。

メッセージで問題ビューに反映するエラーをフィルタリングする

特定のメッセージの指摘を無視したいとき、またはエラーとして検知したいときに指定します。

1. プロジェクトプロパティ -> JSLint設定 -> フィルタリング -> 追加ボタンを押下します。
2. フィルタリングするメッセージ文字列を正規表現カラムの欄に指定します。
   • 例. Expected.*(Expectedで始まるエラーメッセージの指摘事項)
3. 分類を設定します。
   • 無視 -> 正規表現にマッチする指摘を問題ビュー及びマーカーから無視します。
   • エラー -> 正規表現にマッチする指摘をエラーとして問題ビュー及びマーカーに反映します。
4. 有効カラムのチェックボックスをONにします。

他プロジェクトの設定を利用する

他のプロジェクトの設定をそのまま利用したいときに指定します。

1. プロジェクトプロパティ -> JSLint設定 -> プロジェクト参照 -> 他プロジェクトの設定を利用するにチェックをONにします。
2. 設定を利用したいプロジェクトを選択します。
   • ワークスペース内のプロジェクトでJSLintの設定が行われているプロジェクトが表示されます。

保管時に自動的にチェックを実行する

jsファイルを編集しながら随時チェックを行いたい場合に設定します。

1. プロジェクト右クリック -> CheckJavascript -> jslintで自動的にチェックを選択します

チェック対象ソースを指定する

チェック対象のソースを絞り込みたいときに指定します。
JSLintプラグインはJSDTのインクルードパス指定機能と連携をしているのでインクルードパスを適切に設定します。

1. プロジェクトプロパティ -> JavaScript -> インクルードパス -> ソースを選択します。
2. ソース対象を設定します。
   • チェック対象ソースはプロジェクトプロパティ -> JSLint設定 -> チェック対象ソースで確認できます。

ライブラリを指定する

チェック時にライブラリを考慮したいときに指定します。
JSLintプラグインはJSDTのインクルードパス指定機能と連携をしているのでインクルードパスを適切に設定します。

1. プロジェクトプロパティ -> JavaScript -> インクルードパス -> ライブラリータブをを選択します。
2. ライブラリを指定します。
3. プロジェクトプロパティ -> JSLint設定 -> ソース構成タブを選択します。
4. チェック時に考慮するライブラリのチェックボックスをONにします。

バージョンアップ履歴

ver.1.2.1

• JSLintPluginのJSLint/JSHintの最新バージョンへの対応■しかく
• JSLintPluginのデフォルトの設定オプションの最新化 ■しかく
• DLで取得するJSLint/JSHintのファイルを、プラグインに内蔵したファイルを使用するようにする ■しかく

ver.1.2.0

GitHub Issue一覧

• フィーチャーIDの変更 ■しかく
• eclipse起動時の文字コードがUTF-8以外の場合にチェックが動作しない ■しかく
• JSLint.jsダウンロードダイアログに取得先URL情報を追加 ■しかく
• コードチェック進捗ダイアログのメッセージを変更 ■しかく

ver.1.1.0

GitHub Issue一覧

• エンジンファイル(JSLint.js等)のダウンロード機能 ■しかく
• インクルードパス確認画面追加 ■しかく
• 設定ファイル生成機能、デフォルト機能 ■しかく
• パフォーマンス改善 ■しかく
• JSLint、JSHint公式サイトリンク追加 ■しかく
• ヘルプページリンク追加 ■しかく

ver.1.0.0

• 最初のリリース