テスト可能なコードにしたい

[tsuda-a]

　time-flies/public/js/script.js の function calc() の処理が現在時刻に強く依存していて、単体テストが難しいので、テストが容易に可能なようにしたい。

[tsuda-a]

一応、テスト可能性を高めるために、以下を行っています。(#10 の pull Requestコード 参照)
・calc() 内で直接計算せず、計算処理は getHoge(now) に移管した。
・getHoge(now) 内部で時刻は取得しないようにし、計算のもととなる現在時刻は引数で渡すようにした。(=副作用の防止)
・計算結果は、Binding する変数に直接設定せず、一旦別の構造体にセットし、return で戻すようにした。
以上により、テストコードから任意の日時を getHoge に渡してやれば、それに対応する結果が戻ってくるので、それによって assertion が行えるようになります。

[tsuda-a]

同様に、calcDecimals は処理結果を Binding する変数に直接設定していたので、フォーマット整形の処理は getFormattedDecimals に分離し、Binding 用の変数への代入は calc() 側に移管しています。

[tsuda-a]

function 名は 適宜見直してください。 # getHoge() とかいい加減な名前ですので…（汗

[tsuda-a]

テスト例

■js のテストフレームワークとか知らないので、Assert関数を自作（汗

// 単純比較用
function AssertAreEqual(actual, expect, description) {
    if (actual === expect) {
        // 正常
    } else {
        console.log(description + " で 期待値 '" + expect.toString() + "' が '" + actual.toString() + "' で戻りました")
    }
}

// 実数比較用
function AssertAreNearlyEqual(actual, expect, delta, description) {
    var actualDelta = Math.abs(actual - expect)

    if (actualDelta <= delta) {
        // 正常
    } else {
        console.log(description + " で 期待値 '" + expect.toString() + "' (範囲±" + delta.toString() + ") が '" + actual.toString() + "' で戻りました")
    }
}

■テストコード例

// getHoge のテスト

now = new Date(2015, 11, 31, 23, 59, 59, 999)
ret = getHoge(now)
AssertAreEqual(ret.human, "西暦 2015 年", "年末最後の表記の確認1")

now = new Date(2015, 11, 31, 23, 57, 24)
ret = getHoge(now)
AssertAreEqual(ret.human, "西暦 2015 年", "年末最後の表記の確認2")

now = new Date(2016, 11, 28, 8, 23, 3)
ret = getHoge(now)
AssertAreEqual(ret.human, "西暦 1 年",  "西暦元年の確認")

now = new Date(2016, 11, 28, 8, 20, 27)
ret = getHoge(now)
AssertAreEqual(ret.human, "紀元前 1 年",  "紀元前1年の確認")

now = new Date(2016, 6, 2, 0, 0, 0, 0)
ret = getHoge(now)
AssertAreEqual(ret.ratio, 0.5,  "50%終了の確認")
AssertAreEqual(ret.oneDay.toLocaleTimeString(), "12:00:00", "50%終了時の一日換算の値の確認")

now = new Date(2016, 1, 29, 0, 0, 0)
ret = getHoge(now)
AssertAreNearlyEqual(ret.ratio, 0.1612021, 0.0000001, "2/29 の終了%の確認")



// getFormattedDecimals のテスト

ret = getFormattedDecimals(12.5, 7)
AssertAreEqual(ret.DecPart, "5000000","小数部が指定桁数以下") 

ret = getFormattedDecimals(Math.PI, 7)
AssertAreEqual(ret.DecPart, "1415926","小数部が指定桁数以上") 

ret = getFormattedDecimals(1/6, 7)
AssertAreEqual(ret.DecPart, "1666666","指定桁数以下は切り捨て") 

ret = getFormattedDecimals(25, 7)
AssertAreEqual(ret.IntPart, "25","整数(整数部)") 
AssertAreEqual(ret.DecPart, "0000000","整数(小数部)") 

[Nyoho]

Jestを導入して、 #64 でだいぶテスト可能なコードに整備しました。これから少しずつテストを書いていきたいと思います!