Jasmine.jsで配列を比較する方法：toBeとtoEqualの使い分け

JavaScriptでテストコードを書く際、配列同士を比較する場面はよくあります。Jasmineでは、配列の比較は大きく次の2つのパターンに分けられます。

• 両者がメモリ上の同一の配列オブジェクトを参照している
• 参照先は異なるオブジェクトだが、中身（要素）がすべて等しい

ケース1：参照の一致を確認する「toBe」

ケース1のように、同じオブジェクトへの参照かどうかを確認したい場合は、toBeマッチャーを使用します。toBeは厳密等価演算子（===）と同様に、参照の一致をチェックします。

例を見てみましょう。

サンプルコード

describe("Array Equality", () => {
    it("should check for array reference equality", () => {
        let arr = [1, 2, 3];
        let arr2 = arr;
        // arr2はarrと同じオブジェクトを参照しているため成功する
        expect(arr).toBe(arr2);
        // 参照が異なるため失敗する
        expect(arr).toBe([1, 2, 3]);
    });
});

実行結果

Array Equality should check for array equality
Message:
    Expected [ 1, 2, 3 ] to be [ 1, 2, 3 ]. Tip: To check for deep equality, use .toEqual() instead of .toBe().

このように、[1, 2, 3]という要素を持つ新しい配列を作成して比較すると、見た目は同じでも参照が異なるためテストは失敗します。エラーメッセージにも「深い等価性を確認したい場合は.toEqual()を使う」というヒントが表示されます。

ケース2：内容の一致を確認する「toEqual」

ケース2のように、参照先が異なっていても配列の中身が同じであれば合格させたい場合は、toEqualマッチャーを使用します。toEqualは配列やオブジェクトの構造を再帰的にたどって比較する、いわゆるディープ比較（deep equality）を行います。

サンプルコード

describe("Array Equality", () => {
    it("should check for array content equality", () => {
        let arr = [1, 2, 3];
        let arr2 = arr;
        // 同じ参照なので成功する
        expect(arr).toEqual(arr2);
        // 中身が同じなら別のオブジェクトでも成功する
        expect(arr).toEqual([1, 2, 3]);
    });
});

実行結果

1 spec, 0 failures

今度はどちらのexpectも成功し、「0 failures」と表示されます。

まとめ

配列やオブジェクトのテストでは、意図に応じてtoBeとtoEqualを正しく使い分けることが重要です。基本的に「値が同じかどうか」を確認したい場面が多いため、迷ったらtoEqualを選ぶのが安全です。