mocha + nycのころ

プロジェクト構成など

package.jsonはこんな感じ。

{
  "test": "NODE_ENV=test mocha test/",
  "coverage": "nyc -c npm test"
}

• /srcにソースディレクトリ
• /testにテストディレクトリ
• MISC
  • jsdom-global使って色々小細工していた。

mocha -> jestにするモチベーション

• 興味本位
• Jestがv15.0.0でAutomockingを捨てて本気を出してきたのでちょっと使ってみたかった気持ち
• Railsプロジェクトにjavascriptプロジェクトを混ぜようとしたとき、mochaのテストディレクトリに悩んでしまうぐらいなら、Jestのテストフでやってみようかと思った
  • jestでは、/srcなどのコードに対して、/src/__tests__というディレクトリを作るか、some.test.jsという名前をつけるのがデフォルト設定になっている。
  • mochaでも設定によっては可能
• coverage周りに感じた魅力

jestへのmigrate

package.jsonまわり

とりあえずmochaからの移動をまず考えるので、test/**/*.jsのような感じでテストディレクトリの指定を行う。
coverage入りなので、coverageコマンドも変える

{
  "scripts":{
    "test": "NODE_PATH=${npm_package_config_resolve} jest ",
    "coverage": "npm test -- --coverage",
  },
  "jest": {
    "testRegex": "test/.*.js"
  }
   :
}

test/mockみたいなところに非テストデータ入れてるならignorePatternを設定

  jest": {
    "testPathIgnorePatterns": ["node_modules", "test/mock"],
  }

テストのskip

2016/10/14追記：いつのまにか.skipが実装されていたようです。
https://facebook.github.io/jest/docs/api.html#basic-testing
https://github.com/facebook/jest/pull/1632

mochaだと.skipだった

describe('some test', () => {
  it.skip('skip')
})

jestだとxitやxdescribeになる。

xdescribe('some test', () => {
  xit('skip')
})

空ファイルはエラーになる

Your test suite must contain at least one test.

xdescribe("todo", () => {
  xit("todo")
})

it("todo", () => {}

jsdomは消せる

jestにして嬉しいポイント

mochaだと色々頑張っていたが、既に入っているので気にしなくて良くなる
http://facebook.github.io/jest/docs/api.html#testenvironment-string

assertとexpect

標準ではexpectというmatcherが用意されており、そちらに重点が置かれている。
個人的にはassertを使っていきたいので、ちょっと不満ポイント。

assertも使えないわけではない。普通にthrowされればエラーとなる。

ただし、expect(foo) で書くとエラー時の表示がきれいになる。

このぐらい違う。
無理に全部置き換えるまででもないかなと思ったが、郷に入れば郷に従えで今後はexpectに置き換えていくだろうなと思う。

addMatchersなどあるのでもしかするとなんとかならないかなと思っているが未調査。

watchモード

jestにちょっと不満ポイント２。

mochaだと-wで良かった

$ mocha -w

jestは--watch。
ちなみに-wは--maxWorkersという値の省略になってしまっている。

$ jest --watch

しかしwatchモードの挙動自体は結構イケてる

感想

• 移植自体は簡単
• やはりReactとは相性がとても良い。
• シンプルさというよりはフルスタックさに振っている感じがある
• 並列でテストを走らせてくれているっぽい。
• React以外のプロジェクトで普段使いするかというと、うーんという感じ。
• 無理して移植するほどのメリットがあるかというと、そんな強くもない
  • とはいえ、そもそも移植コスト掛かってないので、興味があったらやってみてもいいと思う
• Snapshotテストとか手出し始めたらまた感想変わるかも
• なぜかCircle-CIでテストが遅くなっているので調査中
• そこそこ大規模なReactプロジェクトで「テスト入れるぞ！」となったときの選択肢としては全然アリ
  • mochaでちょっとしんどかったjsdomまわり気にしなくていいのも大きい