Day 13 懶得想變數嗎？ RSpec 有提供你啦

2021 iThome 鐵人賽

DAY 13

自我挑戰組

寫測試了嗎？ 30 天的 RSpec 基本教學！系列第 13 篇

13th鐵人賽

Robert Chang

2021-09-27 18:51:21

990 瀏覽

分享至

該文章同步發佈於：我的部落格

也歡迎關注我的 Facebook 以及 Instagram 接收軟體相關的資訊！

還記得我們使用 let 方法來實作一個物件來讓我們可以快速使用！

但有沒有什麼好方法可以讓我不要想物件的名字？可能因為我有取名的障礙或是英文真的太爛了！

甚至我連 let 都懶得寫，我實在是太懶惰了...

有！ RSpec 有個有趣的方法叫做 subject，他會自動根據整個 RSpec 最上層的描述來決定 subject 該是什麼！

Subject

剛剛的說法也都比不過一個實際的例子來得實際，看看以下範例！

RSpec.describe Hash do
  it "should be empty" do
    expect(subject.length).to eq(0)
  end
end

這是 OutPut 的結果：

現在一定是一頭霧水，想說這個 subject 到底是在哪裡？我們甚至沒有宣告他啊？

這就是 RSpec 提供你的小方法喔，如果你的最上層 RSpec.describe 後方接的是類別，那 subject 就會依照這個類別的預設值去做 new 的動作。

我們可以把 subject 給印出來看看！

RSpec.describe Hash do
  it "should be empty" do
    p subject
    p subject.class
    expect(subject.length).to eq(0)
  end
end

OutPut 的結果：

所以我們可以想像，他在上方幫我們做了：

let(:subject) { Hash.new }

這是動態產生的，根據我們提供的類別來建立物件！是不是很方便呢？

加上他和 let 一樣，在每一個 example 中都是獨立的，不會有污染物件的情形，可以放心的服用！

加入初始值的 Subject

剛剛示範的是完全乾淨的一個物件，但如果我們想要建立一個有不一樣初始值的 subject 該怎麼做呢？

馬上來示範一下：

RSpec.describe Hash do
  subject do 
    {a: 3, b: 4}
  end
  
  it "should be empty" do
    expect(subject.length).to eq(2)
  end
end

其實很簡當，但如果我們不想要叫做 subject 呢？

只要在後面加入變數的命名就可以了喔！

RSpec.describe Hash do
  subject(:robert) do
    {a: 3, b: 4}
    
  end
  it "should be empty" do
    expect(subject.length).to eq(2)
    expect(robert.length).to eq(2)
  end
end

至於為什麼要這樣用？我使用 let 還不是一樣，何必浪費時間寫三行呢？

你說的沒錯，用 let 的效果也是一樣，但 subject 有其他更魔法的方法可以使用，等等也會一併介紹，會讓寫出來的 Code 優雅到不行！

在介紹黑魔法的寫法之前，我先來介紹另一個也很有趣的語法。

Described_class

剛剛介紹的是 subejct 的好用之處，這次介紹的 described_class 可能不一定會用到，但在改大量程式碼的時候很有效果！

我先用範例來解說一下：

class Burger
  attr_accessor :beef, :cheese
  
  def initialize(beef, cheese)
    @beef = beef
    @cheese = cheese
  end
end

RSpec.describe Burger do
  subject { Burger.new("Beef", "Cheedar") }
  let(:pork_burger) { Burger.new("Pork", "Cheedar") }
  
  it "...." do
    ....
  end
end

這邊我們有個漢堡的類別，假設需求今天下來是要更改這個 Burger 類別的名稱，怎麼辦？

任務是把 Burger 改成 GoodBurger 這個名字，若是只有兩三行，那倒是沒什麼問題，但如果是 100 行呢？我們要怎麼做？

這時候 described_class 就可以派上用場，若是我們都用這樣的寫法：

class GoodBurger
  attr_accessor :beef, :cheese
  
  def initialize(beef, cheese)
    @beef = beef
    @cheese = cheese
  end
end

# 我們只需要更改這邊的類別名稱就可以了！
RSpec.describe GoodBurger do
  subject { described_class.new("Beef", "Cheedar") }
  let(:pork_burger) { described_class.new("Pork", "Cheedar") }
  
  it "...." do
    ....
  end
end

described_class 雖然不是一個很常使用的東西，但他就是可以根據你上面放置的類別來動態產生物件，而且只需要改類別名稱就能夠一次跟上！

說不定在某些時候會幫助到你～

我只要寫一行！

前面有提到使用 subject 的小小好處，就是可以讓你只要寫一行！

直接先看程式碼：

RSpec.describe 5 do
  it "should be 5" do
    expect(subject).to eq(5)
  end

  context "one line syntax" do
    it { is_expected.to eq(5) }
  end
end

這是 OutPut