介紹 Matcher 的上集

目錄

今天進入介紹 Matcher 的第一天！

會介紹一些常用，也有可能不常用的東西～

首先我想先介紹一個超基本的用法 not_to，基本上就是把我們常用的 to 替代掉而已，至於功能是什麼，我想字面上應該是非常的清楚！

但我們還是用一個小小的範例來補充一下：

Example
  • ruby
1
2
3
4
5
 
RSpec.describe "not_to" do
  it "will be pass" do
    expect(1+1).not_to eq(3)
  end
end

就非常簡單的反義，實用點數五顆星！

Comparison matchers

比較用的 Mathcer 這也是使用度非常高的一個，使用的方法也非常簡單。

就是大於、小於、這類很直覺的東西！

我們用可以用很多的範例來讓看看，順便練習我們之前提過 subject 的 一行流寫法！

One Line Syntax
  • ruby
1
2
3
4
5
6
7
8
9
 
RSpec.describe "Comparison matchers" do
  describe 50 do
    it { is_expected.to be > 40 }
    it { is_expected.to be >= 50 }
    it { is_expected.to be < 500 }
    it { is_expected.to be <= 50 }
    it { is_expected.not_to be > 55 }
  end
end

他可以接受所有 Ruby 的比較符號，那這個範例中，也有用到 subject 的概念，因為我們 describe 後面接的不是字串，是整數！

所以他會在 block 裡面生成：

let(:subject) { 50 }

而下面的 一行流 寫法也是 RSpec 提供給我們的語法！

Predicate matchers

predicate method 在 Ruby 的世界中，都泛指回傳 boolean 的方法！

而在 Ruby 的慣例中，predicate method 通常都會用 ? 做結尾。

我覺得這點真的很貼心，也很好識別！

用一些範例來讓大家看看！

predicate method
  • ruby
1
2
3
4
5
6
 
> p 0.zero?
> true
> p 15.odd?
> true
> p [].empty?
> true

我的破英文都看得很有感了，相信一般人看到也會覺得好貼心啊！！！

所以接下來要介紹的是在 RSpec 中的 predicate matcher，其實大同小異，但還是做點範例～

有些人會把 predicate method 寫在 expect 裡面，像這樣：

RSpec predicate
  • ruby
1
2
3
4
5
 
RSpec.describe "predicate method" do
  it "use ruby method" do
    expect(16.even?).to eq(true)
  end
end

這樣也沒有什麼問題，但就是少了 RSpec 的浪漫，所以我們要用他幫我們準備好的方法來改寫看看

RSpec predicate
  • ruby
1
2
3
4
5
 
RSpec.describe "predicate matchers" do
  it "use rspec matcher" do
    expect(16).to be_even
  end
end

這樣要測試的效果其實和上面一樣！

所有 Ruby 的 predicate method 都可以直接無痛的轉移成 Rspec 的 matcher！

Ruby to RSpec
  • ruby
1
2
3
 
> odd? -> be_odd
> empty? -> be_empty
> zero? -> be_zero

就是把問號拔掉，前面用 be_ 串接上去，就能做到一樣的效果！而且閱讀起來又更 RSpec 一點～

甚至你也可以用更像英文的寫法來寫， be_a_ & be_an_ 都是可以的用法喔！看看範例：

start_with_be
  • ruby
1
2
3
4
5
 
RSpec.describe "read more naturally" do
  it "test a string" do
    expect("string").to be_an_instance_of(String)
  end
end

效果等同於：

"string".instance_of?(String)
# true

但要記得，寫 Rails 時，若是自己定義的 predicate method 是 private 的話，就沒辦法使用喔！會造成 error ～

小結

今天先介紹了兩種非常實用的 matcher，明天也會接著繼續介紹！