API Testing bằng Postman - Collection runner
This post hasn't been updated for 5 years
Trở lại với loạt bài "API Testing bằng Postman", chúng ta đã biết được cách làm thế nào để có thể tạo được một request trên Postman, viết các test script cho test case và cuối cùng là thêm chúng collection để tạo thành các test suite Hôm nay chúng ta sẽ lại tiếp tục với việc làm thế nào để chạy Postman như một tool automation test với công cụ Collection Runner và Newman
1. Làm thế nào để tạo được Collection Runner
Có hai cách để chạy một Postman collection là Collection Runner và Newman, hãy bắt đầu chạy một collection bằng Collection Runner
Bước 1) Click vào button Runner trên góc trên cùng bên trái bên cạnh nút Import
Bước 2) Trang Collection Runner sẽ xuất hiện như bên dưới
Mô tả các trường:
- Chọn các collection ở đây. Nếu có sub-folders bạn sẽ cần phải chọn subfolder đó
- Đừng quên chọn environment nếu bạn có một environment đặt biệt
- Chọn số lần bạn muốn lặp lại
- Chọn khoản thời gian chờ để tránh lỗi xảy ra
- Trạng thái log các response
- Nếu bạn sử dụng data file, hãy chọn ở đây
Bước 3) Chạy User Test Collection bằng cách setup như sau
- Chọn User Test Collection - Chọn lặp lại 3 lần
- Chọn thời gian chờ là 2500ms
- Click Run User Test Collection
Bước 4) Chạy và Results page sẽ hiển thị sau khi bạn click Run button. Lệ thuộc vào thời gian chờ, bạn sẽ thấy các test case chạy
- Mỗi test case hoàn thành, bạn sẽ thấy test status là Passed hay Failed và kết quả của mỗi lần lặp lại
- Bạn thấy Pass status cho Get Requests
- Vì chúng ta chưa viết test case cho Post Request, nên sẽ có messege rằng "This request does not have any tests"
Ở đây, bạn có thể thấy được test trong request của bạn, có thể check xem HTTP request có thành công hay không và data đã được tạo hay trả về chưa.
2. Làm thế để chạy Collection bằng Newman
Có một cách khác để chạy collection là thông qua Newman. Điểm khác biệt giữa Newman và Collection Runner là:
- Newman là một add-on của Postman. Bạn sẽ cần phải cài đặt riêng từ Native App
- Newman sử dụng command line trong khi Collection Runner có GUI
- Newman có thể sử dụng cho continuous integration
Để cài đặt Newman và chạy collection của bạn từ đó, làm theo hướng dẫn sau:
Bước 1) Cài đặt nodejs với link sau:
Bước 2) Mở command line và nhập
npm install -g newman
Newman sẽ được cài đặt vào máy tính cả bạn như sau
Bước 3) Khi nào Newman đã được cài đặt, hay trở lại Postman workspace. Trong Collections box, click vào dấu "...". Một popup sẽ xuất hiện. Chọn Export
Bước 4) Chọn Export Collection như Collection v2.1 (recommended) tiếp theo click Export
Bước 5) Chọn nơi mà bạn muốn lưu và click Save. Sẽ có một lời khuyên là tạo 1 folder đặt biệt cho Postman test case. Một collection sẽ được export nếu bạn chọn 1 folder
Bước 6) Chúng ta sẽ cần export environment. Click vào biểu tượng mắt bện cạnh environment dropdown trong Global, chọn Download as JSON. Chọn nơi lưu và click Save.
Bước 7) Environment nên được export cùng folder với Collection
Bước 8) Bây giờ trở lại với command line và đổi sang folder nơi mà bạn đã lưu collection và environment
cd Downloads/
Bước 9) Chạy collection của bạn bằng câu lệnh sau
newman run Use\ Test\ Collection.postman_collection.json -e Demo.postman_globals.json
Kết quả sau khi chạy sẽ xuất hiện như bên dưới
Tham chiếu một số câu lệnh cơ bản của Newman
- Chạy một collection Câu lệnh này sử dụng nếu không có environment hay test data lệ thuộc
newman run <collection man>
- Chạy một collection và environment thêm tham số -e
newman run <collection name> -e <environment name>
- Chạy một collection với số lần lặp lại
newman run <collection name> -n <no.of iterations>
- Chạy với file data
newman run <collection name> --data <file name> -n <no.of iterations> -e <environment name>
- Chạy với thời gian chờ. Điều này quan trọng trong test có thể fail nếu chạy không có thời gian chờ giữa các request
newman run <collection name> -d <delay time>
3. Tổng kết
- Postman là một tool phổ biến nhất hiện nay dùng cho API Testing
- Khả năng linh hoạt, sử dụng collection, cộng tác, Continuous Integration, là những tính năng hay nhất khi tìm hiểu về Postman
- Khuyến khích việc vào Postman account và collection của bạn sẽ được đẩy lên cloud
- Bạn có thể tham số hóa request trong Postman
- Bạn có thể tạo testcase để verify request
- Collection có thể chạy bằng Newman hoặc Collection Runner
Tham khảo
All Rights Reserved