Qiita Teams that are logged in
You are not logged in to any team

Log in to Qiita Team
Community
OrganizationAdvent CalendarQiitadon (β)
Service
Qiita JobsQiita ZineQiita Blog
Help us understand the problem. What is going on with this article?

ESLintのAPIの素晴らしさ

More than 5 years have passed since last update.

ESLintは最近勢いがある、JavaScriptのLinterです。

要するに

JSHintのAPIへの悲しみ、それらが一通り解決されているESLintへの感謝です。

JSHint APIの謎

JSHintをNode.jsプログラム中から使うためのAPIの話です。

サンプルコード

var source = [
  'function goo() {}',
  'foo = 3;'
];
var options = {
  undef: true
};
var predef = {
  foo: false
};

JSHINT(source, options, predef);

console.log(JSHINT.data());

戻り値がない

JSHINT関数の結果は戻り値で取得できません。
なぜか結果を状態で持ちます。
つまり並列実行可能かどうかは実装を見て確認しないといけません。

複数回実行した結果を積算しない

結果を戻り値で返さないなら複数回JSHINT関数を実行した場合に、結果を積み上げていくのでしょうか?
必要なシチュエーションは思いつきませんが、APIとしては妥当そうです。

実際はそんなことはありません。
サンプルコード

エラー結果から対応するルールがわからない

codeという人間に優しくない参考情報は出ますが、ルールそのものの名前は出ません。

エラーが大量に出るルールを無効にして、緩めのルールからLintを使い始めたい気持ちがあります。
その需要に直接的な参考情報を返すことができません。

[
    {
      id: '(error)',
      raw: 'Read only.',
      code: 'W020',
      evidence: 'foo = 3;',
      line: 2,
      character: 1,
      scope: '(main)',
      a: undefined,
      b: undefined,
      c: undefined,
      d: undefined,
      reason: 'Read only.'
    }
  ]

外部ドキュメントがあれば、まだいいのですが・・・なさそうです。
ソースコード上にcodeに対応するメッセージ一覧はあります。

定義済み変数の指定がオブジェクト

var predef = {
  foo: false
};

値にfalse以外を指定することがあるのでしょうか?
複数指定する場合に配列にしたくあります。

predef = ['_', 'alert', 'toastr', 'self', 'jsPlumb', 'Promise']
  .reduce((a, b) => {
    a[b] = true
    return a
  }, {})

ESLintの素晴らしさ

以上の背景を踏まえた上でESLintのAPIドキュメントを読みます。

結果が戻り値で帰ってきます

var linter = require("eslint").linter;

var messages = linter.verify("var foo;", {
    rules: {
        semi: 2
    }
}, "foo.js");

:thumbsup:

結果にruleIdが含まれています

{
    fatal: false,
    severity: 2,
    ruleId: "semi",
    severity: 2,
    line: 1,
    column: 23,
    message: "Expected a semicolon.",
    fix: {
        range: [1, 15],
        text: ";"
    }
}

:thumbsup:

定義済み変数は配列で指定します

An array of global variables to declare (default: empty array). 

:thumbsup:

感想

早くJSHintからESLintに移行したくあります。
ただ、安易な気持ちでESLintをコマンドライン実行したら

✖ 1352 problems (1352 errors, 0 warnings)

と出てきて心が折れそうです!

ledsun
編集リクエスト、コメント大歓迎です。
luxiar
Ruby on Rails専門のWebアプリケーション開発に特化した町田の受託開発企業です
http://www.luxiar.com/index.html
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away