단위 테스트 빌드

Cloud Firestore

Cloud Firestore

RulesTestEnvironment.clearFirestore() => Promise<void>

이 메서드는 Firestore 에뮬레이터용으로 구성된 projectId에 속한 Firestore 데이터베이스의 데이터를 지웁니다.

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

이 메서드는 이 테스트 컨텍스트의 Firestore 인스턴스를 가져옵니다. 반환된 Firebase JS 클라이언트 SDK 인스턴스는 클라이언트 SDK API(v9 모듈식 또는 v9 compat)와 함께 사용할 수 있습니다.

실시간 데이터베이스

실시간 데이터베이스

RulesTestEnvironment.clearDatabase() => Promise<void>

이 메서드는 실시간 데이터베이스 에뮬레이터용으로 구성된 projectId에 속하는 실시간 데이터베이스에서 데이터를 지웁니다.

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

이 테스트 컨텍스트의 실시간 데이터베이스 인스턴스를 가져옵니다. 반환된 Firebase JS 클라이언트 SDK 인스턴스는 클라이언트 SDK API(모듈식 또는 네임스페이스화, 버전 9 이상)와 함께 사용할 수 있습니다. 이 메서드는 실시간 데이터베이스 인스턴스의 URL을 허용합니다. 지정하면 URL에서 추출된 매개변수를 사용해 에뮬레이션된 버전의 네임스페이스의 인스턴스를 반환합니다.

Cloud Storage

Cloud Storage

RulesTestEnvironment.clearStorage() => Promise<void>

이 메서드는 Cloud Storage 에뮬레이터용으로 구성된 projectId에 속한 스토리지 버킷의 객체와 메타데이터를 지웁니다.

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

이 메서드는 에뮬레이터에 연결하도록 구성된 Storage 인스턴스를 반환합니다. 이 메서드는 테스트를 위해 Firebase Storage 버킷에 대한 gs:// URL을 허용합니다. 지정하면 에뮬레이션된 버전의 버킷 이름에 대한 Storage 인스턴스가 반환됩니다.

Cloud Firestore

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

이 메서드는 옵션에 지정된 프로젝트 ID와 인증 변수에 따라 초기화된 Firebase 앱을 반환합니다. 테스트에 사용할 특정 사용자로 인증된 앱을 만들려면 이 메서드를 사용하세요.

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

initializeAdminApp({ projectId: string }) => FirebaseApp

이 메서드는 초기화된 관리자 Firebase 앱을 반환합니다. 이 앱은 읽기와 쓰기를 수행할 때 보안 규칙을 우회합니다. 테스트 상태를 설정하기 위해 관리자로 인증된 앱을 만들려면 이 메서드를 사용하세요.

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

apps() => [FirebaseApp] 이 메서드는 현재 초기화된 테스트와 관리자 앱을 모두 반환합니다. 테스트 중에 또는 테스트 후에 앱을 정리하려면 이 메서드를 사용하세요.

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

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

이 메서드는 로컬에서 실행 중인 데이터베이스에 규칙을 전송합니다. 이때 규칙을 문자열로 지정하는 객체를 선택해야 합니다. 데이터베이스 규칙을 설정하려면 이 메서드를 사용하세요.

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

assertFails(pr: Promise) => Promise

이 메서드는 입력이 성공하면 거부된 프로미스를 반환하고, 입력이 거부되면 성공한 프로미스를 반환합니다. 데이터베이스 읽기 또는 쓰기 실패를 알리는 어설션을 만들려면 다음 메서드를 사용하세요.

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

assertSucceeds(pr: Promise) => Promise

이 메서드는 입력이 성공하면 성공한 프로미스를 반환하고, 입력이 거부되면 거부된 프로미스를 반환합니다. 데이터베이스 읽기 또는 쓰기 성공을 알리는 어설션을 만들려면 다음 메서드를 사용하세요.

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

clearFirestoreData({ projectId: string }) => Promise

다음 메서드는 로컬에서 실행되는 Firestore 인스턴스의 특정 프로젝트와 연결된 모든 데이터를 지웁니다. 테스트 후 삭제하려면 이 메서드를 사용하세요.

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

실시간 데이터베이스

실시간 데이터베이스

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

테스트에 사용할 특정 사용자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 데이터베이스 이름 및 인증 변수 재정의에 따라 초기화된 Firebase 앱이 반환됩니다.

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

initializeAdminApp({ databaseName: string }) => FirebaseApp

테스트 상태를 설정하기 위해 관리자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 데이터베이스 이름에 따라 초기화된 관리자 Firebase 앱이 반환됩니다. 이 앱은 데이터베이스에 읽기와 쓰기를 수행할 때 보안 규칙을 우회합니다.

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

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

데이터베이스 규칙을 설정하려면 다음 메서드를 사용하세요.

로컬에서 실행 중인 데이터베이스에 규칙이 전송됩니다. 'databaseName'과 'rules'를 문자열로 지정하는 옵션 객체를 선택하세요.

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

apps() => [FirebaseApp]

현재 초기화된 테스트와 관리자 앱을 모두 반환합니다.

테스트 간에 또는 테스트 후에 앱을 정리하려면 다음 메서드를 사용합니다. 활성 리스너가 포함된 초기화된 앱이 있으면 자바스크립트가 종료되지 않습니다.

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

assertFails(pr: Promise) => Promise

입력이 성공하면 거부된 프라미스가 반환되고, 입력이 거부되면 성공한 프라미스가 반환됩니다.

데이터베이스 읽기 또는 쓰기 실패를 알리는 어설션을 만들려면 다음 메서드를 사용하세요.

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

assertSucceeds(pr: Promise) => Promise

입력이 성공하면 성공한 프라미스가 반환되고, 입력이 거부되면 거부된 프라미스가 반환됩니다.

데이터베이스 읽기 또는 쓰기 성공을 알리는 어설션을 만들려면 이 메서드를 사용하세요.

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

Cloud Storage

Cloud Storage

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

테스트에 사용할 특정 사용자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 스토리지 버킷 이름 및 인증 변수 재정의에 따라 초기화된 Firebase 앱이 반환됩니다.

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

initializeAdminApp({ storageBucket: string }) => FirebaseApp

테스트 상태를 설정하기 위해 관리자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 스토리지 버킷 이름에 따라 초기화된 관리자 Firebase 앱이 반환됩니다. 이 앱은 버킷에 읽기와 쓰기를 수행할 때 보안 규칙을 우회합니다.

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

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

스토리지 버킷의 규칙을 설정하려면 이 메서드를 사용하세요.

로컬에서 관리되는 스토리지 버킷에 규칙을 전송합니다. 'storageBucket'과 'rules'를 문자열로 지정하는 옵션 객체를 선택하세요.

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

apps() => [FirebaseApp]

현재 초기화된 테스트와 관리자 앱을 모두 반환합니다.

테스트 간에 또는 테스트 후에 앱을 정리하려면 다음 메서드를 사용합니다. 활성 리스너가 포함된 초기화된 앱이 있으면 자바스크립트가 종료되지 않습니다.

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

assertFails(pr: Promise) => Promise

입력이 성공하면 거부된 프라미스가 반환되고, 입력이 거부되면 성공한 프라미스가 반환됩니다.

스토리지 버킷 읽기 또는 쓰기 실패를 알리는 어설션을 만들려면 다음 메서드를 사용합니다.

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

assertSucceeds(pr: Promise) => Promise

입력이 성공하면 성공한 프라미스가 반환되고, 입력이 거부되면 거부된 프라미스가 반환됩니다.

스토리지 버킷 읽기 또는 쓰기 성공을 알리는 어설션을 만들려면 다음 메서드를 사용합니다.

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

Cloud Firestore

Cloud Firestore

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

이 메서드는 옵션에 지정된 프로젝트 ID와 인증 변수에 따라 초기화된 Firebase 앱을 반환합니다. 테스트에 사용할 특정 사용자로 인증된 앱을 만들려면 이 메서드를 사용하세요.

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

initializeAdminApp({ projectId: string }) => FirebaseApp

이 메서드는 초기화된 관리자 Firebase 앱을 반환합니다. 이 앱은 읽기와 쓰기를 수행할 때 보안 규칙을 우회합니다. 테스트 상태를 설정하기 위해 관리자로 인증된 앱을 만들려면 이 메서드를 사용하세요.

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

apps() => [FirebaseApp] 이 메서드는 현재 초기화된 테스트와 관리자 앱을 모두 반환합니다. 테스트 중에 또는 테스트 후에 앱을 정리하려면 이 메서드를 사용하세요.

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

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

이 메서드는 로컬에서 실행 중인 데이터베이스에 규칙을 전송합니다. 이때 규칙을 문자열로 지정하는 객체를 선택해야 합니다. 데이터베이스 규칙을 설정하려면 이 메서드를 사용하세요.

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

assertFails(pr: Promise) => Promise

이 메서드는 입력이 성공하면 거부된 프로미스를 반환하고, 입력이 거부되면 성공한 프로미스를 반환합니다. 데이터베이스 읽기 또는 쓰기 실패를 알리는 어설션을 만들려면 다음 메서드를 사용하세요.

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

assertSucceeds(pr: Promise) => Promise

이 메서드는 입력이 성공하면 성공한 프로미스를 반환하고, 입력이 거부되면 거부된 프로미스를 반환합니다. 데이터베이스 읽기 또는 쓰기 성공을 알리는 어설션을 만들려면 다음 메서드를 사용하세요.

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

clearFirestoreData({ projectId: string }) => Promise

다음 메서드는 로컬에서 실행되는 Firestore 인스턴스의 특정 프로젝트와 연결된 모든 데이터를 지웁니다. 테스트 후 삭제하려면 이 메서드를 사용하세요.

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

실시간 데이터베이스

실시간 데이터베이스

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

테스트에 사용할 특정 사용자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 데이터베이스 이름 및 인증 변수 재정의에 따라 초기화된 Firebase 앱이 반환됩니다.

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

initializeAdminApp({ databaseName: string }) => FirebaseApp

테스트 상태를 설정하기 위해 관리자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 데이터베이스 이름에 따라 초기화된 관리자 Firebase 앱이 반환됩니다. 이 앱은 데이터베이스에 읽기와 쓰기를 수행할 때 보안 규칙을 우회합니다.

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

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

데이터베이스 규칙을 설정하려면 다음 메서드를 사용하세요.

로컬에서 실행 중인 데이터베이스에 규칙이 전송됩니다. 'databaseName'과 'rules'를 문자열로 지정하는 옵션 객체를 선택하세요.

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

apps() => [FirebaseApp]

현재 초기화된 테스트와 관리자 앱을 모두 반환합니다.

테스트 간에 또는 테스트 후에 앱을 정리하려면 다음 메서드를 사용합니다. 활성 리스너가 포함된 초기화된 앱이 있으면 자바스크립트가 종료되지 않습니다.

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

assertFails(pr: Promise) => Promise

입력이 성공하면 거부된 프라미스가 반환되고, 입력이 거부되면 성공한 프라미스가 반환됩니다.

데이터베이스 읽기 또는 쓰기 실패를 알리는 어설션을 만들려면 다음 메서드를 사용하세요.

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

assertSucceeds(pr: Promise) => Promise

입력이 성공하면 성공한 프라미스가 반환되고, 입력이 거부되면 거부된 프라미스가 반환됩니다.

데이터베이스 읽기 또는 쓰기 성공을 알리는 어설션을 만들려면 이 메서드를 사용하세요.

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

Cloud Storage

Cloud Storage

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

테스트에 사용할 특정 사용자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 스토리지 버킷 이름 및 인증 변수 재정의에 따라 초기화된 Firebase 앱이 반환됩니다.

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

initializeAdminApp({ storageBucket: string }) => FirebaseApp

테스트 상태를 설정하기 위해 관리자로 인증된 앱을 만들려면 다음 메서드를 사용하세요.

옵션에 지정된 스토리지 버킷 이름에 따라 초기화된 관리자 Firebase 앱이 반환됩니다. 이 앱은 버킷에 읽기와 쓰기를 수행할 때 보안 규칙을 우회합니다.

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

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

스토리지 버킷의 규칙을 설정하려면 이 메서드를 사용하세요.

로컬에서 관리되는 스토리지 버킷에 규칙을 전송합니다. 'storageBucket'과 'rules'를 문자열로 지정하는 옵션 객체를 선택하세요.

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

apps() => [FirebaseApp]

현재 초기화된 테스트와 관리자 앱을 모두 반환합니다.

테스트 간에 또는 테스트 후에 앱을 정리하려면 다음 메서드를 사용합니다. 활성 리스너가 포함된 초기화된 앱이 있으면 자바스크립트가 종료되지 않습니다.

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

assertFails(pr: Promise) => Promise

입력이 성공하면 거부된 프라미스가 반환되고, 입력이 거부되면 성공한 프라미스가 반환됩니다.

스토리지 버킷 읽기 또는 쓰기 실패를 알리는 어설션을 만들려면 다음 메서드를 사용합니다.

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

assertSucceeds(pr: Promise) => Promise

입력이 성공하면 성공한 프라미스가 반환되고, 입력이 거부되면 거부된 프라미스가 반환됩니다.

스토리지 버킷 읽기 또는 쓰기 성공을 알리는 어설션을 만들려면 다음 메서드를 사용합니다.

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