@firebase/firestore/lite

제공된 앱의 Firestore 인스턴스

getFirestore(app, databaseId)

이 API는 개발자를 위한 미리보기로 제공되며 Google에 접수된 의견에 따라 변경될 수 있습니다. 프로덕션 환경에서는 이 API를 사용하지 마세요.

제공된 FirebaseApp과 연결된 기존 Firestore 인스턴스를 반환합니다. 인스턴스가 없으면 기본 설정으로 새 인스턴스를 초기화합니다.

서명:

export declare function getFirestore(app: FirebaseApp, databaseId: string): Firestore;

매개변수

매개변수	유형	설명
앱	Firebase 앱	반환된 Firestore 인스턴스와 연결된 FirebaseApp 인스턴스입니다.
데이터베이스 ID	문자열	데이터베이스의 이름입니다.

반환:

제공된 앱의 Firestore 인스턴스

Firestore(앱, 설정)

제공된 설정으로 Cloud Firestore의 새 인스턴스를 초기화합니다. getFirestore()를 포함한 다른 함수보다 먼저 호출할 수 있습니다. 커스텀 설정이 비어 있으면 이 함수는 getFirestore()를 호출하는 것과 같습니다.

서명:

export declare function initializeFirestore(app: FirebaseApp, settings: Settings): Firestore;

매개변수

매개변수	유형	설명
앱	Firebase 앱	`Firestore` 인스턴스가 연결될 FirebaseApp입니다.
설정	설정	`Firestore` 인스턴스를 구성하기 위한 설정 객체.

반환:

새로 초기화된 Firestore 인스턴스

Firestore(앱, 설정, 데이터베이스 ID)

이 API는 개발자를 위한 미리보기로 제공되며 Google에 접수된 의견에 따라 변경될 수 있습니다. 프로덕션 환경에서는 이 API를 사용하지 마세요.

서명:

export declare function initializeFirestore(app: FirebaseApp, settings: Settings, databaseId?: string): Firestore;

매개변수

매개변수	유형	설명
앱	Firebase 앱	`Firestore` 인스턴스가 연결될 FirebaseApp입니다.
설정	설정	`Firestore` 인스턴스를 구성하기 위한 설정 객체.
데이터베이스 ID	문자열	데이터베이스의 이름입니다.

반환:

CollectionReference<DocumentData, DocumentData>

새로 초기화된 Firestore 인스턴스

function(firestore, ...)

컬렉션(firestore, path, pathSegments)

지정된 절대 경로에 있는 컬렉션을 참조하는 CollectionReference 인스턴스를 가져옵니다.

서명:

export declare function collection(firestore: Firestore, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

매개변수

매개변수	유형	설명
firestore	Firestore	루트 `Firestore` 인스턴스에 대한 참조입니다.
경로	문자열	슬래시로 구분된 컬렉션 경로입니다.
pathSegments	문자열[]	첫 번째 인수를 기준으로 적용할 추가 경로 세그먼트입니다.

반환:

CollectionReference 인스턴스

예외

최종 경로의 세그먼트가 짝수이고 컬렉션을 가리키지 않는 경우

collectionGroup(firestore, collectionId)

지정된 collectionId를 사용하여 컬렉션 또는 하위 컬렉션에 포함된 데이터베이스의 모든 문서를 포함하는 새 Query 인스턴스를 만들고 반환합니다.

서명:

export declare function collectionGroup(firestore: Firestore, collectionId: string): Query<DocumentData, DocumentData>;

매개변수

매개변수	유형	설명
firestore	Firestore	루트 `Firestore` 인스턴스에 대한 참조입니다.
컬렉션 ID	문자열	쿼리할 컬렉션을 식별합니다. 이 ID가 경로의 마지막 세그먼트인 모든 컬렉션 또는 하위 컬렉션이 포함됩니다. 슬래시를 포함할 수 없습니다.

반환:

쿼리<DocumentData, DocumentData>

생성된 Query.

connectFirestoreEmulator(firestore, host, port, options)

Cloud Firestore 에뮬레이터와 통신하도록 이 인스턴스를 수정합니다.

서명:

export declare function connectFirestoreEmulator(firestore: Firestore, host: string, port: number, options?: {
    mockUserToken?: EmulatorMockTokenOptions | string;
}): void;

매개변수

매개변수	유형	설명
firestore	Firestore	에뮬레이터에 연결하도록 구성할 `Firestore` 인스턴스
호스트	문자열	에뮬레이터 호스트 (예: localhost)
포트	숫자	에뮬레이터 포트 (예: 9000)입니다.
옵션	{ fakeUserToken?: EmulatorMockTokenOptions \| string; }

반환:

void

doc(firestore, path, pathSegments)

지정된 절대 경로에 있는 문서를 참조하는 DocumentReference 인스턴스를 가져옵니다.

서명:

export declare function doc(firestore: Firestore, path: string, ...pathSegments: string[]): DocumentReference<DocumentData, DocumentData>;

매개변수

매개변수	유형	설명
firestore	Firestore	루트 `Firestore` 인스턴스에 대한 참조입니다.
경로	문자열	슬래시로 구분된 문서 경로입니다.
pathSegments	문자열[]	첫 번째 인수를 기준으로 적용될 추가 경로 세그먼트입니다.

반환:

DocumentReference<DocumentData, DocumentData>

DocumentReference 인스턴스

예외

최종 경로의 세그먼트가 홀수이고 문서를 가리키지 않는 경우

runTransaction(firestore, updateFunction, options)

지정된 updateFunction를 실행한 다음 트랜잭션 내에 적용된 변경사항을 커밋하려고 시도합니다. 트랜잭션 내에서 읽은 문서가 변경되면 Cloud Firestore에서 updateFunction를 다시 시도합니다. 5번의 시도 후에도 커밋에 실패하면 트랜잭션은 실패합니다.

단일 트랜잭션에 허용되는 최대 쓰기 수는 500개입니다.

서명:

export declare function runTransaction<T>(firestore: Firestore, updateFunction: (transaction: Transaction) => Promise<T>, options?: TransactionOptions): Promise<T>;

매개변수

매개변수	유형	설명
firestore	Firestore	이 트랜잭션을 실행할 Firestore 데이터베이스에 대한 참조입니다.
updateFunction	(거래: 거래) => 프로미스<T>	트랜잭션 컨텍스트 내에서 실행할 함수입니다.
옵션	TransactionOptions	커밋할 최대 시도 횟수를 구성하는 옵션 객체입니다.

반환:

프로미스<T>

트랜잭션이 성공적으로 완료되었거나 명시적으로 취소되면 (updateFunction가 실패한 프로미스를 반환한 경우) updateFunction에서 반환된 프로미스가 여기에 반환됩니다. 그렇지 않고 트랜잭션이 실패하면 거부된 프로미스와 해당 실패 오류가 반환됩니다.

종료(firestore)

제공된 Firestore 인스턴스를 종료합니다.

terminate()를 호출한 후에는 clearIndexedDbPersistence() 함수만 사용할 수 있습니다. 다른 모든 함수는 FirestoreError을 발생시킵니다. 종료해도 대기 중인 쓰기가 취소되지 않으며 서버의 응답을 대기 중인 프로미스는 확인되지 않습니다.

종료 후 다시 시작하려면 getFirestore()를 사용하여 Firestore의 새 인스턴스를 만듭니다.

서명:

export declare function terminate(firestore: Firestore): Promise<void>;

매개변수

매개변수	유형	설명
firestore	Firestore	종료할 `Firestore` 인스턴스입니다.

반환:

Promise<void>

인스턴스가 성공적으로 종료되었을 때 결정되는 Promise입니다.

writeBatch(firestore)

단일 원자적 작업으로 여러 쓰기를 수행하는 데 사용되는 쓰기 배치를 만듭니다. 단일 WriteBatch에 허용되는 최대 쓰기 수는 500개입니다.

이러한 쓰기 결과는 반환된 프로미스가 확인된 후에 발생하는 문서 읽기에만 반영됩니다. 클라이언트가 오프라인 상태인 경우 쓰기가 실패합니다. 클라이언트가 온라인 상태가 될 때까지 로컬 수정 또는 버퍼 쓰기를 확인하려면 전체 Firestore SDK를 사용하세요.

서명:

export declare function writeBatch(firestore: Firestore): WriteBatch;

매개변수

매개변수	유형	설명
firestore	Firestore

반환:

WriteBatch

여러 쓰기를 원자적으로 실행하는 데 사용할 수 있는 WriteBatch입니다.

함수()

카운트()

쿼리의 결과 집합에서 문서 수를 계산하는 데 사용할 수 있는 AggregateField 객체를 만듭니다.

서명:

export declare function count(): AggregateField<number>;

반환:

AggregateField<숫자>

deleteField()

{merge: true}와 함께 updateDoc() 또는 setDoc()와 함께 사용할 센티널을 반환하여 필드를 삭제하도록 표시합니다.

서명:

export declare function deleteField(): FieldValue;

반환:

문서 ID()

문서의 ID를 참조하는 특수 센티널 FieldPath를 반환합니다. 쿼리에서 문서 ID를 기준으로 정렬하거나 필터링하는 데 사용할 수 있습니다.

서명:

export declare function documentId(): FieldPath;

반환:

FieldPath

Firestore getFirestore()

기본 FirebaseApp에 연결된 기존의 기본 Firestore 인스턴스를 반환합니다. 인스턴스가 없으면 기본 설정으로 새 인스턴스를 초기화합니다.

서명:

export declare function getFirestore(): Firestore;

반환:

제공된 앱의 Firestore 인스턴스

serverTimestamp()

작성된 데이터에 서버 생성 타임스탬프를 포함하기 위해 setDoc() 또는 updateDoc()와 함께 사용되는 센티널을 반환합니다.

서명:

export declare function serverTimestamp(): FieldValue;

반환:

함수(데이터베이스 ID, ...)

getFirestore(databaseId)

이 API는 개발자를 위한 미리보기로 제공되며 Google에 접수된 의견에 따라 변경될 수 있습니다. 프로덕션 환경에서는 이 API를 사용하지 마세요.

기본 FirebaseApp에 연결된 기존 Firestore 인스턴스를 반환합니다. 인스턴스가 없으면 기본 설정으로 새 인스턴스를 초기화합니다.

서명:

export declare function getFirestore(databaseId: string): Firestore;

매개변수

매개변수	유형	설명
데이터베이스 ID	문자열	데이터베이스의 이름입니다.

반환:

제공된 앱의 Firestore 인스턴스

function(elements, ...)

배열 제거(요소)

setDoc()와 함께 사용할 수 있거나 서버에 이미 존재하는 배열 값에서 지정된 요소를 삭제하도록 서버에 지시하는 특수한 값을 반환합니다. 지정된 각 요소의 모든 인스턴스가 배열에서 삭제됩니다. 수정 중인 필드가 아직 배열이 아닌 경우 빈 배열로 덮어쓰기됩니다.

서명:

export declare function arrayRemove(...elements: unknown[]): FieldValue;

매개변수

매개변수	유형	설명
elements	알 수 없음[]	배열에서 제거할 요소입니다.

반환:

setDoc() 또는 updateDoc() 호출에 사용할 FieldValue 센티널

배열Union(요소)

지정된 요소를 서버에 이미 있는 배열 값과 통합하도록 서버에 지시하는 setDoc() 또는 updateDoc()와 함께 사용할 수 있는 특수한 값을 반환합니다. 지정된 배열에 없는 지정된 각 요소는 끝에 추가됩니다. 수정 중인 필드가 배열이 아닌 경우, 지정된 요소를 정확히 포함하는 배열로 필드를 덮어씁니다.

서명:

export declare function arrayUnion(...elements: unknown[]): FieldValue;

매개변수

매개변수	유형	설명
elements	알 수 없음[]	배열에 통합할 요소입니다.

반환:

QueryFieldFilterConstraint

setDoc() 또는 updateDoc() 호출에 사용할 FieldValue 센티널입니다.

function(field, ...)

평균(필드)

쿼리의 결과 집합에서 문서 범위에 대한 지정된 필드의 평균을 계산하는 데 사용할 수 있는 AggregateField 객체를 만듭니다.

서명:

export declare function average(field: string | FieldPath): AggregateField<number | null>;

매개변수

매개변수	유형	설명
필드	문자열 \| FieldPath	결과 집합 전체에서 평균을 계산할 필드를 지정합니다.

반환:

AggregateField<숫자 | null>

sum(필드)

쿼리 결과 집합에서 문서 범위에 대한 지정된 필드의 합계를 계산하는 데 사용할 수 있는 AggregateField 객체를 만듭니다.

서명:

export declare function sum(field: string | FieldPath): AggregateField<number>;

매개변수

매개변수	유형	설명
필드	문자열 \| FieldPath	결과 집합에서 합산할 필드를 지정합니다.

반환:

AggregateField<숫자>

function(fieldPath, ...)

orderBy(fieldPath, directionsStr)

지정된 필드를 기준으로 쿼리 결과를 정렬하는 QueryOrderByConstraint를 만듭니다. 원하는 경우 오름차순 대신 내림차순으로 정렬합니다.

서명:

export declare function orderBy(fieldPath: string | FieldPath, directionStr?: OrderByDirection): QueryOrderByConstraint;

매개변수

매개변수	유형	설명
fieldPath	문자열 \| FieldPath	정렬 기준이 되는 필드입니다.
방향스트	OrderByDirection	('asc' 또는 'desc') 정렬 기준으로 사용할 방향입니다(선택사항). 지정하지 않으면 오름차순으로 정렬됩니다.

반환:

QueryOrderByConstraint

생성된 QueryOrderByConstraint입니다.

where(fieldPath, opStr, value)

문서에 지정된 필드가 포함되어야 하고 값이 제공된 관계 제약 조건을 충족해야 하도록 적용하는 QueryFieldFilterConstraint를 만듭니다.

서명:

export declare function where(fieldPath: string | FieldPath, opStr: WhereFilterOp, value: unknown): QueryFieldFilterConstraint;

매개변수

매개변수	유형	설명
fieldPath	문자열 \| FieldPath	비교할 경로
opStr	WHEREFilterOp	연산 문자열입니다 (예: "<", "<=", "==", "<", "<=", "!=").
값	알 수 없음	비교 값

반환:

생성된 QueryFieldFilterConstraint입니다.

function(fieldValues, ...)

endAt(fieldValues)

쿼리 순서에 따라 제공된 필드에서 끝나도록 결과 집합을 수정하는 QueryEndAtConstraint를 만듭니다. 필드 값의 순서는 쿼리의 절 기준 순서와 일치해야 합니다.

서명:

export declare function endAt(...fieldValues: unknown[]): QueryEndAtConstraint;

매개변수

매개변수	유형	설명
필드 값	알 수 없음[]	쿼리의 정렬 기준에 따라 이 쿼리를 종료할 필드 값입니다.

반환:

QueryEndAtConstraint를 사용해야 합니다.

query()에 전달할 QueryEndAtConstraint

endBefore(fieldValues)

쿼리 순서를 기준으로 제공된 필드보다 먼저 종료되도록 결과 집합을 수정하는 QueryEndAtConstraint를 만듭니다. 필드 값의 순서는 쿼리의 절 기준 순서와 일치해야 합니다.

서명:

export declare function endBefore(...fieldValues: unknown[]): QueryEndAtConstraint;

매개변수

매개변수	유형	설명
필드 값	알 수 없음[]	쿼리의 정렬 기준에 따라 이전에 이 쿼리를 종료할 필드 값입니다.

반환:

QueryEndAtConstraint를 사용해야 합니다.

query()에 전달할 QueryEndAtConstraint

startAfter(fieldValues)

쿼리 순서를 기준으로 제공된 필드 다음에 시작되도록 결과 집합을 수정하는 QueryStartAtConstraint를 만듭니다. 필드 값의 순서는 쿼리의 절 기준 순서와 일치해야 합니다.

서명:

export declare function startAfter(...fieldValues: unknown[]): QueryStartAtConstraint;

매개변수

매개변수	유형	설명
필드 값	알 수 없음[]	이 쿼리를 시작할 필드 값이며, 쿼리 정렬 기준입니다.

반환:

query()에 전달할 QueryStartAtConstraint

startAt(fieldValues)

쿼리 순서에 따라 제공된 필드에서 시작되도록 결과 집합을 수정하는 QueryStartAtConstraint를 만듭니다. 필드 값의 순서는 쿼리의 절 기준 순서와 일치해야 합니다.

서명:

export declare function startAt(...fieldValues: unknown[]): QueryStartAtConstraint;

매개변수

매개변수	유형	설명
필드 값	알 수 없음[]	쿼리의 정렬 기준으로 이 쿼리를 시작할 필드 값입니다.

반환:

query()에 전달할 QueryStartAtConstraint입니다.

함수(왼쪽, ...)

aggregateFieldEqual(왼쪽, 오른쪽)

두 'AggregateField' 인스턴스가 같은지 비교합니다.

서명:

export declare function aggregateFieldEqual(left: AggregateField<unknown>, right: AggregateField<unknown>): boolean;

매개변수

매개변수	유형	설명
왼쪽	AggregateField<알 수 없음>	이 AggregateField를 `right`와 비교하세요.
오른쪽	AggregateField<알 수 없음>	이 AggregateField를 `left`와 비교하세요.

반환:

부울

aggregateQuerySnapshotEqual(왼쪽, 오른쪽)

두 AggregateQuerySnapshot 인스턴스가 같은지 비교합니다.

두 AggregateQuerySnapshot 인스턴스는 '동일'한 것으로 간주됩니다. 는 동일한 데이터를 비교하는 기본 쿼리가 있는 경우에 한합니다.

서명:

export declare function aggregateQuerySnapshotEqual<AggregateSpecType extends AggregateSpec, AppModelType, DbModelType extends DocumentData>(left: AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>, right: AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>): boolean;

매개변수

매개변수	유형	설명
왼쪽	AggregateQuerySnapshot<AggregateSpecType, AppModelType, DBMModelType>	비교할 첫 번째 `AggregateQuerySnapshot`입니다.
오른쪽	AggregateQuerySnapshot<AggregateSpecType, AppModelType, DBMModelType>	비교할 두 번째 `AggregateQuerySnapshot`입니다.

반환:

부울

객체가 '동일'한 경우(위에 정의된 것처럼) true, 그렇지 않으면 false입니다.

queryEqual(왼쪽, 오른쪽)

제공된 쿼리가 동일한 컬렉션을 가리키고 동일한 제약조건을 적용하면 true를 반환합니다.

서명:

export declare function queryEqual<AppModelType, DbModelType extends DocumentData>(left: Query<AppModelType, DbModelType>, right: Query<AppModelType, DbModelType>): boolean;

매개변수

매개변수	유형	설명
왼쪽	쿼리<AppModelType, DBMModelType>	비교할 `Query`.
오른쪽	쿼리<AppModelType, DBMModelType>	비교할 `Query`.

반환:

부울

참조가 동일한 Firestore 데이터베이스에서 동일한 위치를 가리키면 true가 됩니다.

refEqual(왼쪽, 오른쪽)

제공된 참조가 같으면 true를 반환합니다.

서명:

export declare function refEqual<AppModelType, DbModelType extends DocumentData>(left: DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>, right: DocumentReference<AppModelType, DbModelType> | CollectionReference<AppModelType, DbModelType>): boolean;

매개변수

매개변수	유형	설명
왼쪽	DocumentReference<AppModelType, DBMModelType> \| CollectionReference<AppModelType, DBMModelType>	비교할 참조입니다.
오른쪽	DocumentReference<AppModelType, DBMModelType> \| CollectionReference<AppModelType, DBMModelType>	비교할 참조입니다.

반환:

부울

참조가 동일한 Firestore 데이터베이스에서 동일한 위치를 가리키면 true가 됩니다.

스냅샷Equal(왼쪽, 오른쪽)

제공된 스냅샷이 같으면 true를 반환합니다.

서명:

export declare function snapshotEqual<AppModelType, DbModelType extends DocumentData>(left: DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>, right: DocumentSnapshot<AppModelType, DbModelType> | QuerySnapshot<AppModelType, DbModelType>): boolean;

매개변수

매개변수	유형	설명
왼쪽	DocumentSnapshot<AppModelType, DBMModelType> \| QuerySnapshot<AppModelType, DBMModelType>	비교할 스냅샷입니다.
오른쪽	DocumentSnapshot<AppModelType, DBMModelType> \| QuerySnapshot<AppModelType, DBMModelType>	비교할 스냅샷입니다.

반환:

부울

스냅샷이 같으면 true를 반환합니다.

function(limit, ...)

한도(한도)

일치하는 첫 번째 문서만 반환하는 QueryLimitConstraint를 만듭니다.

서명:

export declare function limit(limit: number): QueryLimitConstraint;

매개변수

매개변수	유형	설명
제한	숫자	반환할 최대 항목 수입니다.

반환:

QueryLimitConstraint

생성된 QueryLimitConstraint입니다.

limitToLast(limit)

마지막으로 일치하는 문서만 반환하는 QueryLimitConstraint를 만듭니다.

limitToLast 쿼리에 orderBy 절을 하나 이상 지정해야 합니다. 그러지 않으면 실행 중에 예외가 발생합니다.

서명:

export declare function limitToLast(limit: number): QueryLimitConstraint;

매개변수

매개변수	유형	설명
제한	숫자	반환할 최대 항목 수입니다.

반환:

QueryLimitConstraint

생성된 QueryLimitConstraint입니다.

function(logLevel, ...)

setLogLevel(logLevel)

Cloud Firestore 로그의 세부정보 수준 (디버그, 오류, 자동)을 설정합니다.

서명:

export declare function setLogLevel(logLevel: LogLevel): void;

매개변수

매개변수	유형	설명
logLevel	LogLevel	활동 및 오류 로깅에 설정한 세부정보 수준입니다. 다음 값 중 하나일 수 있습니다. `debug`: 가장 상세한 로깅 수준(주로 디버깅용) `error`: 오류만 로깅합니다. `silent to turn off logging.`

반환:

void

함수(n, ...)

증분(n)

필드의 현재 값을 지정된 값만큼 증가시키도록 서버에 지시하는 setDoc() 또는 updateDoc()와 함께 사용할 수 있는 특수한 값을 반환합니다.

피연산자 또는 현재 필드 값에서 부동 소수점 정밀도가 사용되는 경우 모든 산술은 IEEE 754 의미 체계를 따릅니다. 두 값이 모두 정수인 경우 JavaScript의 안전한 숫자 범위 (Number.MIN_SAFE_INTEGER~Number.MAX_SAFE_INTEGER)를 벗어나는 값도 정밀도가 손실될 수 있습니다. 또한 Firestore 백엔드에서 처리되면 모든 정수 작업은 -2^63~2^63-1로 제한됩니다.

현재 필드 값이 number 유형이 아니거나 필드가 아직 존재하지 않는 경우 변환은 필드를 지정된 값으로 설정합니다.

서명:

export declare function increment(n: number): FieldValue;

매개변수

매개변수	유형	설명
n	숫자	증분할 값입니다.

반환:

QueryCompositeFilterConstraint

setDoc() 또는 updateDoc() 호출에 사용할 FieldValue 센티널

function(query, ...)

getAggregate(query, aggregateSpec)

문서를 실제로 다운로드하지 않고 지정된 쿼리의 결과 집합에서 문서에 대해 지정된 집계를 계산합니다.

이 함수를 사용하여 집계를 수행하는 것이 효율적입니다. 문서의 다운로드되기 때문입니다. 이 함수는 결과 집합이 너무 커서 전부 다운로드할 수 없는 경우 (수천 개의 문서) 문서의 집계를 수행할 수 있습니다.

서명:

export declare function getAggregate<AggregateSpecType extends AggregateSpec, AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, aggregateSpec: AggregateSpecType): Promise<AggregateQuerySnapshot<AggregateSpecType, AppModelType, DbModelType>>;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	결과 집합이 집계되는 쿼리입니다.
누계 스펙	AggregateSpecType	결과 집합에 대해 수행할 집계를 지정하는 `AggregateSpec` 객체입니다. AggregateSpec은 집계 결과를 검색하는 데 사용할 수 있는 각 집계에 대한 별칭을 지정합니다.

반환:

프로미스<AggregateQuerySnapshot<AggregateSpecType, AppModelType, DBMModelType>>

예

const aggregateSnapshot = await getAggregate(query, {
  countOfDocs: count(),
  totalHours: sum('hours'),
  averageScore: average('score')
});

const countOfDocs: number = aggregateSnapshot.data().countOfDocs;
const totalHours: number = aggregateSnapshot.data().totalHours;
const averageScore: number | null = aggregateSnapshot.data().averageScore;

getCount(쿼리)

문서를 실제로 다운로드하지 않고 지정된 쿼리의 결과 집합에 있는 문서 수를 계산합니다.

이 함수를 사용하여 문서를 계산하는 것은 문서의 최종 개수만 계산하고 데이터가 다운로드됩니다. 이 함수는 결과 집합이 너무 커서 완전히 다운로드할 수 없는 경우 (수천 개의 문서) 문서 수를 계산할 수 있습니다.

서명:

export declare function getCount<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>): Promise<AggregateQuerySnapshot<{
    count: AggregateField<number>;
}, AppModelType, DbModelType>>;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	결과 집합 크기가 계산되는 쿼리입니다.

반환:

프로미스<AggregateQuerySnapshot<{ count: AggregateField<number>; }, AppModelType, DBMModelType>>

개수로 처리될 프라미스입니다. 개수는 snapshot.data().count에서 가져올 수 있습니다. 여기서 snapshot는 반환된 프로미스가 확인하는 AggregateQuerySnapshot입니다.

getDocs(쿼리)

쿼리를 실행하고 결과를 QuerySnapshot으로 반환합니다.

모든 쿼리는 이전에 쿼리를 실행했더라도 서버에 의해 직접 실행됩니다. 최근 수정사항은 백엔드에서 이미 적용한 경우에만 검색된 결과에 반영됩니다. 클라이언트가 오프라인인 경우 작업이 실패합니다. 이전에 캐시된 결과 및 로컬 수정사항을 보려면 전체 Firestore SDK를 사용하세요.

서명:

export declare function getDocs<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>): Promise<QuerySnapshot<AppModelType, DbModelType>>;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	실행할 `Query`입니다.

반환:

프로미스<QuerySnapshot<AppModelType, DBMModelType>>

쿼리 결과로 해결될 프라미스입니다.

query(query, compositeFilter, queryConstraints)

추가 쿼리 제약조건도 포함하도록 확장된 Query의 변경 불가능한 새 인스턴스를 만듭니다.

서명:

export declare function query<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, compositeFilter: QueryCompositeFilterConstraint, ...queryConstraints: QueryNonFilterConstraint[]): Query<AppModelType, DbModelType>;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	새 제약조건의 기반으로 사용할 Query 인스턴스입니다.
복합필터	QueryCompositeFilterConstraint	적용할 QueryCompositeFilterConstraint입니다. and() 또는 or()를 사용하여 QueryCompositeFilterConstraint를 만듭니다.
queryConstraints	QueryNonFilterConstraint[]	적용할 추가 QueryNonFilterConstraint입니다 (예: orderBy(), limit()).

반환:

쿼리<AppModelType, DBMModelType>

예외

제공된 쿼리 제약조건 중 하나라도 기존 제약조건 또는 새 제약조건과 결합할 수 없는 경우

query(query, queryConstraints)

추가 쿼리 제약조건도 포함하도록 확장된 Query의 변경 불가능한 새 인스턴스를 만듭니다.

서명:

export declare function query<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, ...queryConstraints: QueryConstraint[]): Query<AppModelType, DbModelType>;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	새 제약조건의 기반으로 사용할 Query 인스턴스입니다.
queryConstraints	쿼리 제약 조건[]	적용할 QueryConstraint의 목록입니다.

반환:

쿼리<AppModelType, DBMModelType>

예외

제공된 쿼리 제약조건 중 하나라도 기존 제약조건 또는 새 제약조건과 결합할 수 없는 경우

function(queryConstraints, ...)

and(queryConstraints)

지정된 필터 제약조건과 결합된 새 QueryCompositeFilterConstraint를 만듭니다. 접속사 필터는 지정된 필터를 모두 만족하는 문서를 포함합니다.

서명:

export declare function and(...queryConstraints: QueryFilterConstraint[]): QueryCompositeFilterConstraint;

매개변수

매개변수	유형	설명
queryConstraints	QueryFilterConstraint[]	선택사항입니다. 결합을 수행할 QueryFilterConstraint의 목록입니다. where(), or() 또는 and()를 호출하여 만들어야 합니다.

반환:

새로 만든 QueryCompositeFilterConstraint입니다.

또는(queryConstraints)

지정된 필터 제약 조건을 분리한 새 QueryCompositeFilterConstraint를 생성합니다. 분리 필터에는 지정된 필터 중 하나를 충족하는 문서가 포함됩니다.

서명:

export declare function or(...queryConstraints: QueryFilterConstraint[]): QueryCompositeFilterConstraint;

매개변수

매개변수	유형	설명
queryConstraints	QueryFilterConstraint[]	선택사항입니다. 분리를 수행할 QueryFilterConstraint의 목록입니다. where(), or() 또는 and()를 호출하여 만들어야 합니다.

반환:

QueryCompositeFilterConstraint

새로 만든 QueryCompositeFilterConstraint입니다.

function(reference, ...)

addDoc(참조, 데이터)

주어진 데이터로 지정된 CollectionReference에 새 문서를 추가하여 문서 ID를 자동으로 할당합니다.

이 쓰기 결과는 반환된 프로미스가 확인된 후에 발생하는 문서 읽기에만 반영됩니다. 클라이언트가 오프라인 상태인 경우 쓰기가 실패합니다. 클라이언트가 온라인 상태가 될 때까지 로컬 수정 또는 버퍼 쓰기를 확인하려면 전체 Firestore SDK를 사용하세요.

서명:

export declare function addDoc<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): Promise<DocumentReference<AppModelType, DbModelType>>;

매개변수

매개변수	유형	설명
참조	CollectionReference<AppModelType, DBMType>	이 문서를 추가할 컬렉션에 대한 참조입니다.
데이터	WithFieldValue<AppModelType>	새 문서의 데이터를 포함하는 객체입니다.

반환:

프로미스<DocumentReference<AppModelType, DBMModelType>>

Promise이 백엔드에 작성된 후 새로 만든 문서를 가리키는 DocumentReference로 확인됩니다.

예외

오류 - 제공된 입력이 유효한 Firestore 문서가 아닌 경우

컬렉션(참조, 경로, 경로 세그먼트)

지정된 상대 경로에 있는 reference의 하위 컬렉션을 참조하는 CollectionReference 인스턴스를 가져옵니다.

서명:

export declare function collection<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

매개변수

매개변수	유형	설명
참조	CollectionReference<AppModelType, DBMType>	컬렉션에 대한 참조입니다.
경로	문자열	슬래시로 구분된 컬렉션 경로입니다.
pathSegments	문자열[]	첫 번째 인수를 기준으로 적용할 추가 경로 세그먼트입니다.

반환:

CollectionReference<DocumentData, DocumentData>

CollectionReference 인스턴스

예외

최종 경로의 세그먼트가 짝수이고 컬렉션을 가리키지 않는 경우

컬렉션(참조, 경로, 경로 세그먼트)

지정된 상대 경로에 있는 reference의 하위 컬렉션을 참조하는 CollectionReference 인스턴스를 가져옵니다.

서명:

export declare function collection<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): CollectionReference<DocumentData, DocumentData>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	Firestore 문서에 대한 참조입니다.
경로	문자열	슬래시로 구분된 컬렉션 경로입니다.
pathSegments	문자열[]	첫 번째 인수를 기준으로 적용될 추가 경로 세그먼트입니다.

반환:

CollectionReference<DocumentData, DocumentData>

CollectionReference 인스턴스

예외

최종 경로의 세그먼트가 짝수이고 컬렉션을 가리키지 않는 경우

deleteDoc(참조)

지정된 DocumentReference에서 참조한 문서를 삭제합니다.

반환된 프로미스가 확인된 후에 발생하는 문서 읽기에만 삭제가 반영됩니다. 클라이언트가 오프라인 상태인 경우 삭제가 실패합니다. 클라이언트가 온라인 상태가 될 때까지 로컬 수정 또는 버퍼 쓰기를 확인하려면 전체 Firestore SDK를 사용하세요.

서명:

export declare function deleteDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>): Promise<void>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	삭제할 문서에 대한 참조입니다.

반환:

Promise<void>

문서가 백엔드에서 성공적으로 삭제되면 Promise가 확인됩니다.

doc(참조, 경로, 경로 세그먼트)

지정된 상대 경로에 있는 reference 내의 문서를 참조하는 DocumentReference 인스턴스를 가져옵니다. 경로를 지정하지 않으면 자동으로 생성된 고유 ID가 반환된 DocumentReference에 사용됩니다.

서명:

export declare function doc<AppModelType, DbModelType extends DocumentData>(reference: CollectionReference<AppModelType, DbModelType>, path?: string, ...pathSegments: string[]): DocumentReference<AppModelType, DbModelType>;

매개변수

매개변수	유형	설명
참조	CollectionReference<AppModelType, DBMType>	컬렉션에 대한 참조입니다.
경로	문자열	슬래시로 구분된 문서 경로입니다. 자동 생성된 ID를 사용하려면 생략해야 합니다.
pathSegments	문자열[]	첫 번째 인수를 기준으로 적용될 추가 경로 세그먼트입니다.

반환:

DocumentReference<AppModelType, DBMModelType>

DocumentReference 인스턴스

예외

최종 경로의 세그먼트가 홀수이고 문서를 가리키지 않는 경우

doc(참조, 경로, 경로 세그먼트)

지정된 상대 경로에 있는 reference 내의 문서를 참조하는 DocumentReference 인스턴스를 가져옵니다.

서명:

export declare function doc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, path: string, ...pathSegments: string[]): DocumentReference<DocumentData, DocumentData>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	Firestore 문서에 대한 참조입니다.
경로	문자열	슬래시로 구분된 문서 경로입니다.
pathSegments	문자열[]	첫 번째 인수를 기준으로 적용될 추가 경로 세그먼트입니다.

반환:

DocumentReference<DocumentData, DocumentData>

DocumentReference 인스턴스

예외

최종 경로의 세그먼트가 홀수이고 문서를 가리키지 않는 경우

getDoc(참조)

지정된 문서 참조에서 참조하는 문서를 읽습니다.

이전에 문서를 읽거나 수정한 경우에도 모든 문서를 서버에서 직접 가져옵니다. 최근 수정사항은 백엔드에서 이미 적용한 경우에만 검색된 DocumentSnapshot에 반영됩니다. 클라이언트가 오프라인 상태이면 읽기가 실패합니다. 캐싱을 사용하거나 로컬 수정을 보려면 전체 Firestore SDK를 사용하세요.

서명:

export declare function getDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>): Promise<DocumentSnapshot<AppModelType, DbModelType>>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	가져올 문서의 참조입니다.

반환:

프로미스<DocumentSnapshot<AppModelType, DBMModelType>>

프로미스가 현재 문서 콘텐츠가 포함된 DocumentSnapshot로 확인됩니다.

setDoc(참조, 데이터)

지정된 DocumentReference에서 참조하는 문서에 씁니다. 문서가 아직 없으면 새로 만듭니다.

서명:

export declare function setDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: WithFieldValue<AppModelType>): Promise<void>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	작성할 문서에 대한 참조입니다.
데이터	WithFieldValue<AppModelType>	문서의 필드와 값의 맵입니다.

반환:

Promise<void>

데이터가 백엔드에 성공적으로 기록되면 Promise가 확인됩니다.

예외

오류 - 제공된 입력이 유효한 Firestore 문서가 아닌 경우

setDoc(참조, 데이터, 옵션)

지정된 DocumentReference에서 참조하는 문서에 씁니다. 문서가 아직 없으면 새로 만듭니다. merge 또는 mergeFields를 제공하면 제공된 데이터를 기존 문서에 병합할 수 있습니다.

서명:

export declare function setDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: PartialWithFieldValue<AppModelType>, options: SetOptions): Promise<void>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	작성할 문서에 대한 참조입니다.
데이터	PartialWithFieldValue<AppModelType>	문서의 필드와 값의 맵입니다.
옵션	SetOptions	집합 동작을 구성하는 객체입니다.

반환:

Promise<void>

데이터가 백엔드에 성공적으로 기록되면 Promise가 확인됩니다.

예외

오류 - 제공된 입력이 유효한 Firestore 문서가 아닌 경우

updateDoc(참조, 데이터)

지정된 DocumentReference에서 참조하는 문서의 필드를 업데이트합니다. 존재하지 않는 문서를 적용하면 업데이트가 실패합니다.

이 업데이트의 결과는 반환된 프로미스가 확인된 후에 발생하는 문서 읽기에만 반영됩니다. 클라이언트가 오프라인 상태인 경우 업데이트가 실패합니다. 클라이언트가 온라인 상태가 될 때까지 로컬 수정 또는 버퍼 쓰기를 확인하려면 전체 Firestore SDK를 사용하세요.

서명:

export declare function updateDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, data: UpdateData<DbModelType>): Promise<void>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	업데이트할 문서에 대한 참조입니다.
데이터	UpdateData<DbModelType>	문서를 업데이트할 필드와 값이 포함된 객체입니다. 필드에는 문서 내의 중첩된 필드를 참조하는 점이 포함될 수 있습니다.

반환:

Promise<void>

데이터가 백엔드에 성공적으로 기록되면 Promise가 확인됩니다.

예외

오류 - 제공된 입력이 유효한 Firestore 데이터가 아닌 경우

updateDoc(참조, 필드, 값, moreFieldsAndValues)

지정된 DocumentReference에서 참조하는 문서의 필드를 업데이트합니다. 존재하지 않는 문서에 적용하면 업데이트가 실패합니다.

중첩된 필드는 점으로 구분된 필드 경로 문자열을 제공하거나 FieldPath 객체를 제공하여 업데이트할 수 있습니다.

서명:

export declare function updateDoc<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, field: string | FieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): Promise<void>;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	업데이트할 문서에 대한 참조입니다.
필드	문자열 \| FieldPath	업데이트할 첫 번째 필드입니다.
값	알 수 없음	첫 번째 값입니다.
moreFieldsAndValues	알 수 없음[]	추가 키-값 쌍입니다.

반환:

Promise<void>

데이터가 백엔드에 성공적으로 기록되면 Promise가 확인됩니다.

예외

오류 - 제공된 입력이 유효한 Firestore 데이터가 아닌 경우

함수(스냅샷, ...)

endAt(스냅샷)

결과 집합을 제공된 문서 (포함)에서 끝나도록 수정하는 QueryEndAtConstraint를 만듭니다. 종료 위치는 쿼리의 순서를 기준으로 합니다. 문서의 orderBy에 제공된 모든 필드가 문서에 포함되어야 합니다.

서명:

export declare function endAt<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryEndAtConstraint;

매개변수

매개변수	유형	설명
스냅샷	DocumentSnapshot<AppModelType, DBMModelType>	종료 시점이 되는 문서의 스냅샷입니다.

반환:

QueryEndAtConstraint를 사용해야 합니다.

query()에 전달할 QueryEndAtConstraint

endBefore(스냅샷)

제공된 문서보다 먼저 끝나도록 결과 집합을 수정하는 QueryEndAtConstraint를 만듭니다. 종료 위치는 쿼리의 순서를 기준으로 합니다. 문서의 orderBy에 제공된 모든 필드가 문서에 포함되어야 합니다.

서명:

export declare function endBefore<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryEndAtConstraint;

매개변수

매개변수	유형	설명
스냅샷	DocumentSnapshot<AppModelType, DBMModelType>	전에 종료할 문서의 스냅샷입니다.

반환:

QueryEndAtConstraint를 사용해야 합니다.

query()에 전달할 QueryEndAtConstraint

startAfter(스냅샷)

제공된 문서 (제외) 이후에 시작하도록 결과 집합을 수정하는 QueryStartAtConstraint를 만듭니다. 시작 위치는 쿼리의 순서를 기준으로 합니다. 문서의 orderBy에 제공된 모든 필드가 문서에 포함되어야 합니다.

서명:

export declare function startAfter<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryStartAtConstraint;

매개변수

매개변수	유형	설명
스냅샷	DocumentSnapshot<AppModelType, DBMModelType>	시작할 문서의 스냅샷입니다.

반환:

query()에 전달할 QueryStartAtConstraint

startAt(스냅샷)

결과 집합을 제공된 문서 (포함)에서 시작하도록 수정하는 QueryStartAtConstraint를 만듭니다. 시작 위치는 쿼리의 순서를 기준으로 합니다. 문서는 이 쿼리의 orderBy에 제공된 모든 필드를 포함해야 합니다.

서명:

export declare function startAt<AppModelType, DbModelType extends DocumentData>(snapshot: DocumentSnapshot<AppModelType, DbModelType>): QueryStartAtConstraint;

매개변수

매개변수	유형	설명
스냅샷	DocumentSnapshot<AppModelType, DBMModelType>	시작할 문서의 스냅샷입니다.

반환: