การจัดการการทดสอบหน่วย
หมายเหตุ
เนื้อหานี้สามารถใช้ได้กับ Power Query SDK แบบดั้งเดิมใน Visual Studio ปัจจุบัน Power Query SDK ใหม่ใน Visual Studio Code มีเฟรมเวิร์กการทดสอบที่โดดเด่นซึ่งเราแนะนําให้คุณทดสอบและเรียนรู้เพิ่มเติม
สําหรับตัวเชื่อมต่อทั้งแบบง่ายและแบบซับซ้อน การเพิ่มการทดสอบหน่วยเป็นแนวทางปฏิบัติที่ดีที่สุดและแนะนําเป็นอย่างยิ่ง
การทดสอบหน่วยสามารถทําได้ในบริบทของ Power Query SDK ของ Visual Studio การทดสอบแต่ละรายการจะกําหนดเป็น Fact
ที่มีชื่อ ค่าที่คาดไว้ และค่าจริง ในกรณีส่วนใหญ่ "ค่าจริง" จะเป็นนิพจน์ M ที่ทดสอบส่วนของนิพจน์ของคุณ
พิจารณาส่วนขยายแบบง่ายที่ส่งออกสามฟังก์ชัน:
section Unittesting;
shared UnitTesting.ReturnsABC = () => "ABC";
shared UnitTesting.Returns123 = () => "123";
shared UnitTesting.ReturnTableWithFiveRows = () => Table.Repeat(#table({"a"},{{1}}),5);
รหัสการทดสอบหน่วยนี้ประกอบด้วยข้อเท็จจริงจํานวนมาก และรหัสทั่วไปจํานวนหนึ่งสําหรับเฟรมเวิร์กการทดสอบหน่วย (ValueToText
, Fact
, Facts
, Facts.Summarize
) โค้ดต่อไปนี้มีชุดตัวอย่างของข้อเท็จจริง (ไปที่ UnitTesting.query.pq สําหรับรหัสทั่วไป):
section UnitTestingTests;
shared MyExtension.UnitTest =
[
// Put any common variables here if you only want them to be evaluated once
// Fact(<Name of the Test>, <Expected Value>, <Actual Value>)
facts =
{
Fact("Check that this function returns 'ABC'", // name of the test
"ABC", // expected value
UnitTesting.ReturnsABC() // expression to evaluate (let or single statement)
),
Fact("Check that this function returns '123'",
"123",
UnitTesting.Returns123()
),
Fact("Result should contain 5 rows",
5,
Table.RowCount(UnitTesting.ReturnTableWithFiveRows())
),
Fact("Values should be equal (using a let statement)",
"Hello World",
let
a = "Hello World"
in
a
)
},
report = Facts.Summarize(facts)
][report];
การเรียกใช้ตัวอย่างใน Visual Studio จะประเมินข้อเท็จจริงทั้งหมดและให้ข้อมูลสรุปการแสดงผลด้วยภาพเกี่ยวกับอัตราการส่งผ่าน:
การนําการทดสอบหน่วยไปใช้ในช่วงต้นของกระบวนการพัฒนาตัวเชื่อมต่อช่วยให้คุณสามารถทําตามหลักการของการพัฒนาที่ขับเคลื่อนด้วยการทดสอบได้ สมมติว่าคุณจําเป็นต้องเขียนฟังก์ชันที่เรียกว่า Uri.GetHost
ซึ่งส่งกลับเฉพาะข้อมูลโฮสต์จาก URI คุณอาจเริ่มต้นโดยการเขียนกรณีทดสอบเพื่อตรวจสอบว่าฟังก์ชันดําเนินการฟังก์ชันที่คาดไว้อย่างเหมาะสมหรือไม่:
Fact("Returns host from URI",
"https://bing.com",
Uri.GetHost("https://bing.com/subpath/query?param=1¶m2=hello")
),
Fact("Handles port number appropriately",
"https://bing.com:8080",
Uri.GetHost("https://bing.com:8080/subpath/query?param=1¶m2=hello")
)
สามารถเขียนการทดสอบเพิ่มเติมเพื่อให้แน่ใจว่าฟังก์ชันจัดการกับกรณีของขอบอย่างเหมาะสม
เวอร์ชันแรกของฟังก์ชันอาจผ่านการทดสอบบางอย่างแต่ไม่ใช่ทั้งหมด:
Uri.GetHost = (url) =>
let
parts = Uri.Parts(url)
in
parts[Scheme] & "://" & parts[Host]
เวอร์ชันสุดท้ายของฟังก์ชันควรผ่านการทดสอบหน่วยทั้งหมด ซึ่งทําให้ง่ายต่อการตรวจสอบให้แน่ใจว่าการอัปเดตในอนาคตไปยังฟังก์ชันจะไม่ลบฟังก์ชันพื้นฐานใด ๆ ออกโดยไม่ได้ตั้งใจ