Xây dựng bài kiểm thử đơn vị

Cloud Firestore

Cloud Firestore

RulesTestEnvironment.clearFirestore() => Promise<void>

Phương thức này xoá dữ liệu trong cơ sở dữ liệu Firestore thuộc về projectId được định cấu hình cho trình mô phỏng Firestore.

RulesTestContext.firestore(settings?: Firestore.FirestoreSettings) => Firestore;

Phương thức này lấy một thực thể Firestore cho ngữ cảnh kiểm thử này. Bạn có thể sử dụng thực thể SDK ứng dụng JS Firebase được trả về với các API SDK ứng dụng (mô-đun v9 hoặc tương thích v9).

Realtime Database

Realtime Database

RulesTestEnvironment.clearDatabase() => Promise<void>

Phương thức này xoá dữ liệu trong Realtime Database thuộc về projectId được định cấu hình cho trình mô phỏng Realtime Database.

RulesTestContext.database(databaseURL?: Firestore.FirestoreSettings) => Firestore;

Lấy một thực thể Realtime Database cho ngữ cảnh kiểm thử này. Bạn có thể sử dụng thực thể SDK ứng dụng JS Firebase được trả về với các API SDK ứng dụng (mô-đun hoặc được phân không gian tên, phiên bản 9 trở lên). Phương thức này chấp nhận URL của thực thể Cơ sở dữ liệu theo thời gian thực. Nếu được chỉ định, sẽ trả về một thực thể cho phiên bản được mô phỏng của không gian tên với các tham số được trích xuất từ URL.

Cloud Storage

Cloud Storage

RulesTestEnvironment.clearStorage() => Promise<void>

Phương thức này xoá các đối tượng và siêu dữ liệu trong các bộ chứa bộ nhớ thuộc về projectId được định cấu hình cho trình mô phỏng Cloud Storage.

RulesTestContext.storage(bucketUrl?: string) => Firebase Storage;

Phương thức này trả về một thực thể Bộ nhớ được định cấu hình để kết nối với trình mô phỏng. Phương thức này chấp nhận URL gs:// đến Bộ chứa Firebase Storage để kiểm thử. Nếu được chỉ định, sẽ trả về một thực thể Storage cho phiên bản mô phỏng của tên bộ chứa.

Cloud Firestore

initializeTestApp({ projectId: string, auth: Object }) => FirebaseApp

Phương thức này trả về một ứng dụng Firebase đã khởi chạy tương ứng với mã dự án và biến xác thực được chỉ định trong các tuỳ chọn. Sử dụng phương thức này để tạo một ứng dụng được xác thực là một người dùng cụ thể để sử dụng trong kiểm thử.

firebase.initializeTestApp({
  projectId: "my-test-project",
  auth: { uid: "alice", email: "alice@example.com" }
});

initializeAdminApp({ projectId: string }) => FirebaseApp

Phương thức này trả về một ứng dụng Firebase quản trị đã khởi chạy. Ứng dụng này bỏ qua các quy tắc bảo mật khi thực hiện các thao tác đọc và ghi. Sử dụng thông tin này để tạo một ứng dụng được xác thực là quản trị viên nhằm đặt trạng thái cho các bài kiểm thử.

firebase.initializeAdminApp({ projectId: "my-test-project" });
    

apps() => [FirebaseApp] Phương thức này trả về tất cả các ứng dụng quản trị và kiểm thử hiện đã được khởi chạy. Sử dụng phương thức này để dọn dẹp ứng dụng giữa hoặc sau khi kiểm thử.

Promise.all(firebase.apps().map(app => app.delete()))

loadFirestoreRules({ projectId: string, rules: Object }) => Promise

Phương thức này gửi các quy tắc đến cơ sở dữ liệu đang chạy cục bộ. Phương thức này lấy một đối tượng chỉ định các quy tắc dưới dạng chuỗi. Sử dụng phương thức này để đặt quy tắc của cơ sở dữ liệu.

firebase.loadFirestoreRules({
  projectId: "my-test-project",
  rules: fs.readFileSync("/path/to/firestore.rules", "utf8")
});
    

assertFails(pr: Promise) => Promise

Phương thức này trả về một lời hứa bị từ chối nếu dữ liệu đầu vào thành công hoặc lời hứa thành công nếu dữ liệu đầu vào bị từ chối. Sử dụng phương thức này để xác nhận xem một hoạt động đọc hoặc ghi cơ sở dữ liệu có thành công hay không.

firebase.assertFails(app.firestore().collection("private").doc("super-secret-document").get());
    

assertSucceeds(pr: Promise) => Promise

Phương thức này trả về một lời hứa thành công nếu dữ liệu đầu vào thành công và bị từ chối nếu dữ liệu đầu vào bị từ chối. Sử dụng phương thức này để xác nhận xem một cơ sở dữ liệu có đọc hoặc ghi thành công hay không.

firebase.assertSucceeds(app.firestore().collection("public").doc("test-document").get());
    

clearFirestoreData({ projectId: string }) => Promise

Phương thức này xoá tất cả dữ liệu liên kết với một dự án cụ thể trong bản sao Firestore chạy cục bộ. Sử dụng phương thức này để dọn dẹp sau khi kiểm thử.

firebase.clearFirestoreData({
  projectId: "my-test-project"
});
   

Realtime Database

Realtime Database

initializeTestApp({ databaseName: string, auth: Object }) => FirebaseApp

Sử dụng phương thức này để tạo một ứng dụng được xác thực là một người dùng cụ thể để sử dụng trong kiểm thử.

Trả về một ứng dụng firebase đã khởi chạy tương ứng với tên cơ sở dữ liệu và ghi đè biến xác thực được chỉ định trong các tuỳ chọn.

firebase.initializeTestApp({
  databaseName: "my-database",
  auth: { uid: "alice" }
});

initializeAdminApp({ databaseName: string }) => FirebaseApp

Sử dụng thông tin này để tạo một ứng dụng được xác thực là quản trị viên nhằm thiết lập trạng thái cho các bài kiểm thử.

Trả về một ứng dụng firebase quản trị được khởi tạo tương ứng với tên cơ sở dữ liệu được chỉ định trong các tuỳ chọn. Ứng dụng này bỏ qua các quy tắc bảo mật khi đọc và ghi vào cơ sở dữ liệu.

firebase.initializeAdminApp({ databaseName: "my-database" });

loadDatabaseRules({ databaseName: string, rules: Object }) => Promise

Sử dụng lớp này để đặt quy tắc của cơ sở dữ liệu.

Gửi các quy tắc đến cơ sở dữ liệu đang chạy cục bộ. Lấy một đối tượng tuỳ chọn chỉ định "databaseName" và "rules" dưới dạng chuỗi.

firebase
      .loadDatabaseRules({
        databaseName: "my-database",
        rules: "{'rules': {'.read': false, '.write': false}}"
      });

apps() => [FirebaseApp]

Trả về tất cả ứng dụng kiểm thử và quản trị hiện đã khởi chạy.

Sử dụng mã này để dọn dẹp ứng dụng giữa hoặc sau khi kiểm thử (lưu ý rằng các ứng dụng đã khởi chạy với trình nghe đang hoạt động sẽ ngăn JavaScript thoát):

 Promise.all(firebase.apps().map(app => app.delete()))

assertFails(pr: Promise) => Promise

Trả về một lời hứa bị từ chối nếu dữ liệu đầu vào thành công và thành công nếu dữ liệu đầu vào bị từ chối.

Sử dụng câu lệnh này để xác nhận rằng một cơ sở dữ liệu không đọc hoặc ghi được:

firebase.assertFails(app.database().ref("secret").once("value"));

assertSucceeds(pr: Promise) => Promise

Trả về một lời hứa thành công nếu dữ liệu đầu vào thành công và bị từ chối nếu dữ liệu đầu vào bị từ chối.

Sử dụng câu lệnh này để xác nhận rằng một cơ sở dữ liệu đã đọc hoặc ghi thành công:

firebase.assertSucceeds(app.database().ref("public").once("value"));

Cloud Storage

Cloud Storage

initializeTestApp({ storageBucket: string, auth: Object }) => FirebaseApp

Sử dụng thông tin này để tạo một ứng dụng được xác thực là một người dùng cụ thể để sử dụng trong kiểm thử.

Trả về một ứng dụng firebase đã khởi chạy tương ứng với tên bộ chứa bộ nhớ và ghi đè biến xác thực được chỉ định trong các tuỳ chọn.

firebase.initializeTestApp({
  storageBucket: "my-bucket",
  auth: { uid: "alice" }
});

initializeAdminApp({ storageBucket: string }) => FirebaseApp

Sử dụng thông tin này để tạo một ứng dụng được xác thực là quản trị viên nhằm thiết lập trạng thái cho các bài kiểm thử.

Trả về một ứng dụng firebase quản trị đã khởi chạy tương ứng với tên bộ chứa bộ nhớ được chỉ định trong các tuỳ chọn. Ứng dụng này bỏ qua các quy tắc bảo mật khi đọc và ghi vào bộ chứa.

firebase.initializeAdminApp({ storageBucket: "my-bucket" });

loadStorageRules({ storageBucket: string, rules: Object }) => Promise

Sử dụng tính năng này để đặt quy tắc cho bộ nhớ của bạn.

Gửi các quy tắc đến bộ chứa bộ nhớ được quản lý cục bộ. Lấy một đối tượng tuỳ chọn chỉ định "storageBucket" và "rules" dưới dạng chuỗi.

firebase
      .loadStorageRules({
        storageBucket: "my-bucket",
        rules: fs.readFileSync("/path/to/storage.rules", "utf8")
      });

apps() => [FirebaseApp]

Trả về tất cả ứng dụng kiểm thử và quản trị hiện đã khởi chạy.

Sử dụng mã này để dọn dẹp ứng dụng giữa hoặc sau khi kiểm thử (lưu ý rằng các ứng dụng đã khởi chạy với trình nghe đang hoạt động sẽ ngăn JavaScript thoát):

 Promise.all(firebase.apps().map(app => app.delete()))

assertFails(pr: Promise) => Promise

Trả về một lời hứa bị từ chối nếu dữ liệu đầu vào thành công và thành công nếu dữ liệu đầu vào bị từ chối.

Sử dụng mã này để xác nhận rằng một bộ chứa bộ nhớ không đọc hoặc ghi được:

firebase.assertFails(app.storage().ref("letters/private.doc").getMetadata());

assertSucceeds(pr: Promise) => Promise

Trả về một lời hứa thành công nếu dữ liệu đầu vào thành công và bị từ chối nếu dữ liệu đầu vào bị từ chối.

Sử dụng phương thức này để xác nhận rằng một bộ chứa bộ nhớ đã đọc hoặc ghi thành công:

firebase.assertFails(app.storage().ref("images/cat.png").getMetadata());

Cloud Firestore

Cloud Firestore

initializeTestApp({ projectId: string, auth: Object }) => FirebaseApp

Phương thức này trả về một ứng dụng Firebase đã khởi chạy tương ứng với mã dự án và biến xác thực được chỉ định trong các tuỳ chọn. Sử dụng phương thức này để tạo một ứng dụng được xác thực là một người dùng cụ thể để sử dụng trong kiểm thử.

firebase.initializeTestApp({
  projectId: "my-test-project",
  auth: { uid: "alice", email: "alice@example.com" }
});

initializeAdminApp({ projectId: string }) => FirebaseApp

Phương thức này trả về một ứng dụng Firebase quản trị đã khởi chạy. Ứng dụng này bỏ qua các quy tắc bảo mật khi thực hiện các thao tác đọc và ghi. Sử dụng thông tin này để tạo một ứng dụng được xác thực là quản trị viên nhằm đặt trạng thái cho các bài kiểm thử.

firebase.initializeAdminApp({ projectId: "my-test-project" });
    

apps() => [FirebaseApp] Phương thức này trả về tất cả các ứng dụng quản trị và kiểm thử hiện đã được khởi chạy. Sử dụng phương thức này để dọn dẹp ứng dụng giữa hoặc sau khi kiểm thử.

Promise.all(firebase.apps().map(app => app.delete()))

loadFirestoreRules({ projectId: string, rules: Object }) => Promise

Phương thức này gửi các quy tắc đến cơ sở dữ liệu đang chạy cục bộ. Phương thức này lấy một đối tượng chỉ định các quy tắc dưới dạng chuỗi. Sử dụng phương thức này để đặt quy tắc của cơ sở dữ liệu.

firebase.loadFirestoreRules({
  projectId: "my-test-project",
  rules: fs.readFileSync("/path/to/firestore.rules", "utf8")
});
    

assertFails(pr: Promise) => Promise

Phương thức này trả về một lời hứa bị từ chối nếu dữ liệu đầu vào thành công hoặc lời hứa thành công nếu dữ liệu đầu vào bị từ chối. Sử dụng phương thức này để xác nhận xem một hoạt động đọc hoặc ghi cơ sở dữ liệu có thành công hay không.

firebase.assertFails(app.firestore().collection("private").doc("super-secret-document").get());
    

assertSucceeds(pr: Promise) => Promise

Phương thức này trả về một lời hứa thành công nếu dữ liệu đầu vào thành công và bị từ chối nếu dữ liệu đầu vào bị từ chối. Sử dụng phương thức này để xác nhận xem một cơ sở dữ liệu có đọc hoặc ghi thành công hay không.

firebase.assertSucceeds(app.firestore().collection("public").doc("test-document").get());
    

clearFirestoreData({ projectId: string }) => Promise

Phương thức này xoá tất cả dữ liệu liên kết với một dự án cụ thể trong bản sao Firestore chạy cục bộ. Sử dụng phương thức này để dọn dẹp sau khi kiểm thử.

firebase.clearFirestoreData({
  projectId: "my-test-project"
});
   

Realtime Database

Realtime Database

initializeTestApp({ databaseName: string, auth: Object }) => FirebaseApp

Sử dụng phương thức này để tạo một ứng dụng được xác thực là một người dùng cụ thể để sử dụng trong kiểm thử.

Trả về một ứng dụng firebase đã khởi chạy tương ứng với tên cơ sở dữ liệu và ghi đè biến xác thực được chỉ định trong các tuỳ chọn.

firebase.initializeTestApp({
  databaseName: "my-database",
  auth: { uid: "alice" }
});

initializeAdminApp({ databaseName: string }) => FirebaseApp

Sử dụng thông tin này để tạo một ứng dụng được xác thực là quản trị viên nhằm thiết lập trạng thái cho các bài kiểm thử.

Trả về một ứng dụng firebase quản trị được khởi tạo tương ứng với tên cơ sở dữ liệu được chỉ định trong các tuỳ chọn. Ứng dụng này bỏ qua các quy tắc bảo mật khi đọc và ghi vào cơ sở dữ liệu.

firebase.initializeAdminApp({ databaseName: "my-database" });

loadDatabaseRules({ databaseName: string, rules: Object }) => Promise

Sử dụng lớp này để đặt quy tắc của cơ sở dữ liệu.

Gửi các quy tắc đến cơ sở dữ liệu đang chạy cục bộ. Lấy một đối tượng tuỳ chọn chỉ định "databaseName" và "rules" dưới dạng chuỗi.

firebase
      .loadDatabaseRules({
        databaseName: "my-database",
        rules: "{'rules': {'.read': false, '.write': false}}"
      });

apps() => [FirebaseApp]

Trả về tất cả ứng dụng kiểm thử và quản trị hiện đã khởi chạy.

Sử dụng mã này để dọn dẹp ứng dụng giữa hoặc sau khi kiểm thử (lưu ý rằng các ứng dụng đã khởi chạy với trình nghe đang hoạt động sẽ ngăn JavaScript thoát):

 Promise.all(firebase.apps().map(app => app.delete()))

assertFails(pr: Promise) => Promise

Trả về một lời hứa bị từ chối nếu dữ liệu đầu vào thành công và thành công nếu dữ liệu đầu vào bị từ chối.

Sử dụng câu lệnh này để xác nhận rằng một cơ sở dữ liệu không đọc hoặc ghi được:

firebase.assertFails(app.database().ref("secret").once("value"));

assertSucceeds(pr: Promise) => Promise

Trả về một lời hứa thành công nếu dữ liệu đầu vào thành công và bị từ chối nếu dữ liệu đầu vào bị từ chối.

Sử dụng câu lệnh này để xác nhận rằng một cơ sở dữ liệu đã đọc hoặc ghi thành công:

firebase.assertSucceeds(app.database().ref("public").once("value"));

Cloud Storage

Cloud Storage

initializeTestApp({ storageBucket: string, auth: Object }) => FirebaseApp

Sử dụng thông tin này để tạo một ứng dụng được xác thực là một người dùng cụ thể để sử dụng trong kiểm thử.

Trả về một ứng dụng firebase đã khởi chạy tương ứng với tên bộ chứa bộ nhớ và ghi đè biến xác thực được chỉ định trong các tuỳ chọn.

firebase.initializeTestApp({
  storageBucket: "my-bucket",
  auth: { uid: "alice" }
});

initializeAdminApp({ storageBucket: string }) => FirebaseApp

Sử dụng thông tin này để tạo một ứng dụng được xác thực là quản trị viên nhằm thiết lập trạng thái cho các bài kiểm thử.

Trả về một ứng dụng firebase quản trị đã khởi chạy tương ứng với tên bộ chứa bộ nhớ được chỉ định trong các tuỳ chọn. Ứng dụng này bỏ qua các quy tắc bảo mật khi đọc và ghi vào bộ chứa.

firebase.initializeAdminApp({ storageBucket: "my-bucket" });

loadStorageRules({ storageBucket: string, rules: Object }) => Promise

Sử dụng tính năng này để đặt quy tắc cho bộ nhớ của bạn.

Gửi các quy tắc đến bộ chứa bộ nhớ được quản lý cục bộ. Lấy một đối tượng tuỳ chọn chỉ định "storageBucket" và "rules" dưới dạng chuỗi.

firebase
      .loadStorageRules({
        storageBucket: "my-bucket",
        rules: fs.readFileSync("/path/to/storage.rules", "utf8")
      });

apps() => [FirebaseApp]

Trả về tất cả ứng dụng kiểm thử và quản trị hiện đã khởi chạy.

Sử dụng mã này để dọn dẹp ứng dụng giữa hoặc sau khi kiểm thử (lưu ý rằng các ứng dụng đã khởi chạy với trình nghe đang hoạt động sẽ ngăn JavaScript thoát):

 Promise.all(firebase.apps().map(app => app.delete()))

assertFails(pr: Promise) => Promise

Trả về một lời hứa bị từ chối nếu dữ liệu đầu vào thành công và thành công nếu dữ liệu đầu vào bị từ chối.

Sử dụng mã này để xác nhận rằng một bộ chứa bộ nhớ không đọc hoặc ghi được:

firebase.assertFails(app.storage().ref("letters/private.doc").getMetadata());

assertSucceeds(pr: Promise) => Promise

Trả về một lời hứa thành công nếu dữ liệu đầu vào thành công và bị từ chối nếu dữ liệu đầu vào bị từ chối.

Sử dụng phương thức này để xác nhận rằng một bộ chứa bộ nhớ đã đọc hoặc ghi thành công:

firebase.assertFails(app.storage().ref("images/cat.png").getMetadata());