Tạo báo cáo kiểm thử

Cloud Firestore và Realtime Database đều dựa vào các ngôn ngữ quy tắc mạnh mẽ, súc tích được tạo riêng để quản lý bảo mật thông tin và kiểm soát quyền truy cập. Tuy nhiên, khi các quy tắc trở nên dài hơn và phức tạp hơn, bạn có thể cần một số trợ giúp để gỡ lỗi trong hành vi của chúng.

Trình mô phỏng Firebase có khả năng tạo báo cáo về phạm vi quy tắc, vì vậy, bạn có thể xem chính xác giá trị mà mỗi biểu thức con được đánh giá khi bạn tái tạo lỗi. Báo cáo cũng cung cấp thông tin về tần suất mỗi trường hợp kiểm thử sử dụng một quy tắc, giống như các kỹ thuật "phạm vi dòng" truyền thống.

Tạo báo cáo

Sau khi chạy một bộ kiểm thử, bạn có thể truy cập vào các báo cáo về phạm vi kiểm thử cho biết cách đánh giá từng quy tắc bảo mật.

Để nhận báo cáo, hãy truy vấn một điểm cuối được hiển thị trên trình mô phỏng trong khi trình mô phỏng đang chạy. Để có phiên bản thân thiện với trình duyệt, hãy sử dụng URL sau:

Cloud Firestore 

http://localhost:8080/emulator/v1/projects/<database_name>:ruleCoverage.html

Realtime Database 

http://localhost:9000/.inspect/coverage?ns=<database_name>

Thao tác này sẽ chia các quy tắc của bạn thành các biểu thức và biểu thức con mà bạn có thể di chuột qua để biết thêm thông tin, bao gồm cả số lần đánh giá và các giá trị được trả về. Để có phiên bản JSON thô của dữ liệu này, hãy đưa URL sau vào truy vấn của bạn:

Cloud Firestore 

http://localhost:8080/emulator/v1/projects/<database_name>:ruleCoverage

Realtime Database 

http://localhost:9000/.inspect/coverage.json?ns=<database_name>

Gỡ lỗi các quy tắc mẫu

Để dễ dàng tạo báo cáo kiểm thử, hãy sử dụng hướng dẫn bắt đầu nhanh về trình mô phỏng có trên GitHub cho Cloud Firestore và Realtime Database. Các hướng dẫn bắt đầu nhanh này sẽ hướng dẫn bạn cách cài đặt và khởi chạy trình mô phỏng đúng cách, sau đó tạo các bài kiểm thử mẫu từ một tập hợp quy tắc mẫu.

Hãy xem xét một ứng dụng mẫu sử dụng Cloud Firestore để đếm số lần người dùng nhấp vào một nút. Ứng dụng này sử dụng các quy tắc sau:

Cloud Firestore 

 service cloud.firestore {
   match /databases/{database}/documents {
     match /counters/{counter} {
       allow read;
       allow write: if request.resource.data.value == resource.data.value +1;
     }
   }
 }

Để gỡ lỗi các lỗi trong các quy tắc được hiển thị ở trên, hãy sử dụng bài kiểm thử JavaScript mẫu sau:

const counter0 = db.collection("counters").doc("0");
await firebase.assertSucceeds(counter0.set({value: 0}));

Trình mô phỏng tạo một báo cáo có tại URL được lưu ý ở trên:

http://localhost:8080/emulator/v1/projects/<database_name>:ruleCoverage.html

Báo cáo cho thấy các lỗi giá trị rỗng và không xác định sau:

Vấn đề với ví dụ cụ thể này là các quy tắc không phân biệt giữa việc tạo tài liệu và cập nhật tài liệu. Do đó, thao tác ghi sẽ không được phép nếu tài liệu không tồn tại và không thể tạo tài liệu vì tài liệu không tồn tại. Việc phân biệt "ghi" thành hai thao tác cụ thể hơn – "tạo" và "cập nhật" – sẽ giải quyết vấn đề.

Cloud Firestore 

 service cloud.firestore {
   match /databases/{database}/documents {
     match /counters/{counter} {
       allow read;
       allow create: if request.resource.data.value == 0;
       allow update: if request.resource.data.value == resource.data.value +1;
     }
   }
 }

Báo cáo được tạo cho biết tần suất sử dụng từng quy tắc và giá trị được trả về.