@firebase/firestore

제공된 앱의 기본 Firestore 인스턴스

getFirestore(app, databaseId)

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

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

서명:

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

매개변수

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

반환:

제공된 앱의 이름이 지정된 Firestore 인스턴스

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

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

서명:

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

매개변수

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

반환:

CollectionReference<DocumentData, DocumentData>

새로 초기화된 Firestore 인스턴스

function(firestore, ...)

clearIndexedDbPersistence(firestore)

영구 저장소를 지웁니다. 여기에는 대기 중인 쓰기와 캐시된 문서가 포함됩니다.

Firestore 인스턴스가 시작되지 않은 경우 (앱이 종료된 후 또는 앱이 처음 초기화된 후) 호출해야 합니다. 시작 시 이 함수는 다른 함수보다 먼저 호출해야 합니다 (initialFirestore() 또는 getFirestore() 제외). Firestore 인스턴스가 아직 실행 중인 경우 프로미스가 거부되고 오류 코드는 failed-precondition입니다.

서명:

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

매개변수

매개변수	유형	설명
firestore	Firestore	지속성을 지울 Firestore 인스턴스

반환:

Promise<void>

영구 저장소가 삭제될 때 결정되는 Promise입니다. 그렇지 않으면 프로미스가 오류와 함께 거부됩니다.

컬렉션(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

disableNetwork(firestore)

이 인스턴스의 네트워크 사용량을 사용 중지합니다. enableNetwork()를 통해 다시 사용 설정할 수 있습니다. 네트워크가 사용 중지된 동안에는 모든 스냅샷 리스너, getDoc() 또는 getDocs() 호출이 캐시에서 결과를 반환하고 네트워크가 복원될 때까지 모든 쓰기 작업이 큐에 추가됩니다.

서명:

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

매개변수

매개변수	유형	설명
firestore	Firestore

반환:

Promise<void>

네트워크가 사용 중지되면 결정되는 Promise입니다.

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 인스턴스

예외

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

enableIndexedDbPersistence(firestore, persistentSettings)

경고: 이 API는 이제 더 이상 사용되지 않습니다.

이 함수는 향후 주요 버전에서 삭제될 예정입니다. 대신 FirestoreSettings.localCache를 PersistentLocalCache의 인스턴스로 설정하여 IndexedDb 캐시를 사용 설정하세요. FirestoreSettings.localCache가 이미 지정되었을 때 이 함수를 호출하면 예외가 발생합니다.

가능한 경우 영구 스토리지를 사용 설정합니다.

실패하면 enableIndexedDbPersistence()가 프로미스를 거부하거나 예외를 발생시킵니다. 실패하는 이유는 여러 가지가 있으며 오류의 code에서 확인할 수 있습니다.

* failed-precondition: 앱이 이미 다른 브라우저 탭에서 열려 있습니다. * 구현되지 않음: 브라우저가 오프라인 지속성 구현과 호환되지 않습니다.

장애가 발생한 후에도 Firestore 인스턴스는 사용 가능한 상태로 유지되지만 오프라인 지속성은 사용 중지됩니다.

Node.js 환경에서는 지속성을 사용할 수 없습니다.

서명:

export declare function enableIndexedDbPersistence(firestore: Firestore, persistenceSettings?: PersistenceSettings): Promise<void>;

매개변수

매개변수	유형	설명
firestore	Firestore	지속성을 사용 설정할 Firestore 인스턴스
지속성 설정	지속성 설정	지속성을 구성하는 설정 객체(선택사항)

반환:

Promise<void>

영구 스토리지의 성공적인 사용 설정을 나타내는 Promise입니다.

enableMultiTabIndexedDbPersistence(firestore)

경고: 이 API는 이제 더 이상 사용되지 않습니다.

이 함수는 향후 주요 버전에서 삭제될 예정입니다. 대신 FirestoreSettings.localCache를 PersistentLocalCache의 인스턴스로 설정하여 indexdb 캐시를 사용 설정하세요. FirestoreSettings.localCache가 이미 지정되었을 때 이 함수를 호출하면 예외가 발생합니다.

가능한 경우 멀티탭 영구 저장소를 사용 설정합니다. 모든 탭에서 사용 설정되면 연결된 모든 인스턴스에서 지연 시간을 보상하는 로컬 문서 업데이트 및 쿼리의 공유 실행 등 모든 작업이 로컬 지속성에 대한 액세스를 공유합니다.

실패하면 enableMultiTabIndexedDbPersistence()가 프로미스를 거부하거나 예외를 발생시킵니다. 실패하는 이유는 여러 가지가 있으며 오류의 code에서 확인할 수 있습니다.

* failed-precondition: 앱이 이미 다른 브라우저 탭에서 열려 있고 다중 탭이 사용 설정되어 있지 않습니다. * 구현되지 않음: 브라우저가 오프라인 지속성 구현과 호환되지 않습니다.

장애가 발생한 후에도 Firestore 인스턴스는 사용 가능한 상태로 유지되지만 오프라인 지속성은 사용 중지됩니다.

서명:

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

매개변수

매개변수	유형	설명
firestore	Firestore	지속성을 사용 설정할 Firestore 인스턴스

반환:

Promise<void>

영구 스토리지의 성공적인 사용 설정을 나타내는 Promise입니다.

enableNetwork(firestore)

이전에 disableNetwork()를 호출한 후 이 Firestore 인스턴스의 네트워크 사용을 다시 사용 설정합니다.

서명:

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

매개변수

매개변수	유형	설명
firestore	Firestore

반환:

Promise<void>

네트워크가 사용 설정되면 확인되는 Promise입니다.

getPersistentCacheIndexManager(firestore)

지정된 Firestore 객체에서 사용하는 PersistentCache 색인 관리자를 반환합니다.

PersistentCacheIndexManager 인스턴스 또는 로컬 영구 스토리지를 사용하지 않는 경우 null

서명:

export declare function getPersistentCacheIndexManager(firestore: Firestore): PersistentCacheIndexManager | null;

매개변수

매개변수	유형	설명
firestore	Firestore

반환:

PersistentCacheIndexManager | 없음

loadBundle(firestore, bundleData)

Firestore 번들을 로컬 캐시에 로드합니다.

서명:

export declare function loadBundle(firestore: Firestore, bundleData: ReadableStream<Uint8Array> | ArrayBuffer | string): LoadBundleTask;

매개변수

매개변수	유형	설명
firestore	Firestore	번들을 로드할 Firestore 인스턴스
번들 데이터	ReadableStream<Uint8Array> \| 배열 버퍼 \| 문자열	로드할 번들을 나타내는 객체입니다. 유효한 객체는 `ArrayBuffer`, `ReadableStream<Uint8Array>` 또는 `string`입니다.

반환:

LoadBundleTask

LoadBundleTask 객체: 호출자에게 진행률 업데이트, 완료 또는 오류 이벤트를 알립니다. Promise<LoadBundleTaskProgress>로 사용할 수 있습니다.

nameQuery(firestore, name)

지정된 이름으로 식별된 로컬 캐시에서 Firestore Query를 읽습니다.

이름이 지정된 쿼리는 결과 문서와 함께 서버 측 번들로 패키징되며 loadBundle를 사용하여 로컬 캐시에 로드됩니다. 로컬 캐시에 있으면 이 메서드를 사용하여 이름으로 Query를 추출합니다.

서명:

export declare function namedQuery(firestore: Firestore, name: string): Promise<Query | null>;

매개변수

매개변수	유형	설명
firestore	Firestore	쿼리를 읽을 Firestore 인스턴스
name	문자열	쿼리 이름입니다.

반환:

Promise<Query | null>

쿼리 또는 null로 확인되는 Promise입니다.

onSnapshotsInSync(firestore, 관찰자)

Metrics-in-sync 이벤트의 리스너를 연결합니다. Snapshot-in-sync 이벤트는 서버에서 생성된 단일 변경사항이 여러 리스너에 영향을 미치더라도 지정된 변경의 영향을 받은 모든 리스너가 실행되었음을 나타냅니다.

참고: 스냅샷 동기화 이벤트는 리스너가 서로 동기화되었음을 나타낼 뿐이며, 해당 스냅샷이 서버와 동기화되었는지와는 관계가 없습니다. 개별 리스너에서 SnapshotMetadata를 사용하여 스냅샷이 캐시에서 전송된 것인지, 서버에서 가져온 것인지 확인합니다.

서명:

export declare function onSnapshotsInSync(firestore: Firestore, observer: {
    next?: (value: void) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

매개변수

매개변수	유형	설명
firestore	Firestore	스냅샷 동기화를 위한 Firestore 인스턴스
관찰자	{ 다음?: (값: void) => 무효 오류?: (오류: FirestoreError) => 무효 완료 여부: () => 무효 }	`next` 및 `error` 콜백을 포함하는 단일 객체입니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshotsInSync(firestore, onSync)

참고: 스냅샷 동기화 이벤트는 리스너가 서로 동기화되었음을 나타낼 뿐이며, 해당 스냅샷이 서버와 동기화되었는지와는 관계가 없습니다. 개별 리스너에서 SnapshotMetadata를 사용하여 스냅샷의 출처가 캐시인지, 서버인지 확인합니다.

서명:

export declare function onSnapshotsInSync(firestore: Firestore, onSync: () => void): Unsubscribe;

매개변수

매개변수	유형	설명
firestore	Firestore	스냅샷 동기화를 위한 `Firestore` 인스턴스
onSync	() => 무효	모든 스냅샷 리스너가 서로 동기화될 때마다 호출되는 콜백입니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

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에서 반환된 프로미스가 여기에 반환됩니다. 그렇지 않고 트랜잭션이 실패하면 거부된 프로미스와 해당 실패 오류가 반환됩니다.

setIndexConfiguration(firestore, 구성)

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

를 통해 개인정보처리방침을 정의할 수 있습니다.

경고: 이 API는 이제 더 이상 사용되지 않습니다.

캐시 색인을 수동으로 만드는 대신 enablePersistentCacheIndexAutoCreation()를 사용하여 SDK에서 로컬에서 실행되는 쿼리의 캐시 색인을 만들지 여부를 결정하도록 하는 것이 좋습니다.

로컬 쿼리 실행의 색인 생성을 구성합니다. 이전 색인 구성이 재정의됩니다. Promise는 색인 구성이 유지되면 확인됩니다.

색인 항목 자체는 비동기식으로 생성됩니다. 색인을 아직 사용할 수 없더라도 색인 생성이 필요한 쿼리는 계속 사용할 수 있습니다. 색인 항목이 기록되면 쿼리 실행이 자동으로 색인을 사용하기 시작합니다.

색인은 IndexedDb 지속성으로만 지원됩니다. IndexedDb가 사용 설정되지 않은 경우 색인 구성이 무시됩니다.

서명:

export declare function setIndexConfiguration(firestore: Firestore, configuration: IndexConfiguration): Promise<void>;

매개변수

매개변수	유형	설명
firestore	Firestore	색인을 구성할 Firestore 인스턴스
구성	IndexConfiguration	색인 정의입니다.

반환:

Promise<void>

모든 색인이 성공적으로 구성되면 확인되는 Promise

예외

JSON 형식이 잘못된 경우 FirestoreError

setIndexConfiguration(firestore, json)

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

를 통해 개인정보처리방침을 정의할 수 있습니다.

경고: 이 API는 이제 더 이상 사용되지 않습니다.

캐시 색인을 수동으로 만드는 대신 enablePersistentCacheIndexAutoCreation()를 사용하여 SDK에서 로컬에서 실행되는 쿼리의 캐시 색인을 만들지 여부를 결정하도록 하는 것이 좋습니다.

로컬 쿼리 실행의 색인 생성을 구성합니다. 이전 색인 구성이 재정의됩니다. Promise는 색인 구성이 유지되면 확인됩니다.

색인은 IndexedDb 지속성으로만 지원됩니다. 색인 구성을 설정하기 전에 enableIndexedDbPersistence() 또는 enableMultiTabIndexedDbPersistence()를 호출합니다. IndexedDb가 사용 설정되지 않은 경우 색인 구성이 무시됩니다.

이 메서드는 Firebase CLI (firebase firestore:indexes)에서 내보낸 JSON 형식을 허용합니다. JSON 형식이 유효하지 않으면 이 메서드에서 오류가 발생합니다.

서명:

export declare function setIndexConfiguration(firestore: Firestore, json: string): Promise<void>;

매개변수

매개변수	유형	설명
firestore	Firestore	색인을 구성할 Firestore 인스턴스
json	문자열	Firebase CLI에서 내보낸 JSON 형식입니다.

반환:

Promise<void>

모든 색인이 성공적으로 구성되면 확인되는 Promise

예외

JSON 형식이 잘못된 경우 FirestoreError

종료(firestore)

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

terminate()를 호출한 후에는 clearIndexedDbPersistence() 함수만 사용할 수 있습니다. 다른 모든 함수는 FirestoreError을 발생시킵니다.

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

종료해도 대기 중인 쓰기가 취소되지 않으며 서버의 응답을 대기 중인 프로미스는 확인되지 않습니다. 지속성을 사용 설정하면 다음에 이 인스턴스를 시작할 때 서버에 이러한 쓰기 작업이 다시 전송됩니다.

서명:

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

매개변수

매개변수	유형	설명
firestore	Firestore

반환:

Promise<void>

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

waitForPendingWrites(firestore)

활성 사용자의 현재 대기 중인 모든 쓰기가 백엔드에서 확인할 때까지 대기합니다.

처리되지 않은 쓰기가 없으면 반환된 프로미스가 즉시 확인됩니다. 그 외의 경우 프로미스는 이전에 실행된 모든 쓰기 (이전 앱 세션에서 작성된 쓰기 포함)를 기다리지만 함수가 호출된 후에 추가된 쓰기는 기다리지 않습니다. 추가 쓰기를 기다리려면 waitForPendingWrites()를 다시 호출합니다.

처리되지 않은 waitForPendingWrites() 프로미스는 사용자 변경 중에 거부됩니다.

서명:

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

매개변수

매개변수	유형	설명
firestore	Firestore

반환:

Promise<void>

Promise: 현재 대기 중인 모든 쓰기가 백엔드에서 확인한 경우 확인

writeBatch(firestore)

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

트랜잭션과 달리 쓰기 배치는 오프라인으로 유지되므로 읽기 데이터에 쓰기를 컨디셔닝할 필요가 없는 경우에 권장됩니다.

서명:

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;

반환:

MemoryEagerGarbageCollector

기본 앱의 기본 Firestore 인스턴스

메모리 EagerGarbageCollector()

MemoryEagerGarbageCollector의 인스턴스를 생성합니다. 명시적으로 달리 지정되지 않는 한 기본 가비지 컬렉터이기도 합니다.

서명:

export declare function memoryEagerGarbageCollector(): MemoryEagerGarbageCollector;

반환:

PersistentMultipleTabManager()

PersistentMultipleTabManager의 인스턴스를 생성합니다.

서명:

export declare function persistentMultipleTabManager(): PersistentMultipleTabManager;

반환:

PersistentMultipleTabManager

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입니다.

function(indexManager, ...)

deleteAllPersistentCacheIndexes(indexManager)

모든 영구 캐시 색인을 삭제합니다.

이 함수는 지원 중단된 setIndexConfiguration()에서 생성된 색인도 삭제한다는 점에 유의하세요.

서명:

export declare function deleteAllPersistentCacheIndexes(indexManager: PersistentCacheIndexManager): void;

매개변수

매개변수	유형	설명
indexManager	PersistentCacheIndexManager

반환:

void

disablePersistentCacheIndexAutoCreation(indexManager)을 사용합니다.

로컬 쿼리 실행을 위한 영구 캐시 색인 자동 생성을 중지합니다. enablePersistentCacheIndexAutoCreation()를 호출하여 만든 색인은 계속 적용됩니다.

서명:

export declare function disablePersistentCacheIndexAutoCreation(indexManager: PersistentCacheIndexManager): void;

매개변수

매개변수	유형	설명
색인 관리자	PersistentCacheIndexManager

반환:

void

enablePersistentCacheIndexAutoCreation(indexManager)

SDK에서 캐시 색인이 성능 개선에 도움이 될 수 있다고 판단하는 경우 SDK가 로컬 쿼리 실행을 위해 영구 캐시 색인을 자동으로 만들 수 있도록 사용 설정합니다.

이 기능은 기본적으로 사용 중지되어 있습니다.

서명:

export declare function enablePersistentCacheIndexAutoCreation(indexManager: PersistentCacheIndexManager): void;

매개변수

매개변수	유형	설명
indexManager	PersistentCacheIndexManager

반환:

void

함수(왼쪽, ...)

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	숫자	증분할 값입니다.

반환:

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

함수(검색어, ...)

getAggregateFromServer(query, aggregateSpec)

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

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

서버에서 수신한 결과는 로컬 상태를 고려하지 않고 변경되지 않은 상태로 제공됩니다. 즉, 로컬 캐시의 문서는 고려되지 않으며, 둘 다 아직 서버와 동기화되지 않은 로컬 수정도 고려되지 않습니다. 이전에 다운로드한 결과가 있는 경우 사용되지 않습니다. 이 함수를 호출할 때마다 반드시 서버까지 왕복해야 합니다.

서명:

export declare function getAggregateFromServer<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 getAggregateFromServer(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;

getCountFromServer(쿼리)

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

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

서명:

export declare function getCountFromServer<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로 반환합니다.

서명:

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

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>

반환:

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

쿼리 결과로 확인될 Promise입니다.

getDocsFromCache(쿼리)

쿼리를 실행하고 결과를 캐시에서 QuerySnapshot로 반환합니다. 현재 쿼리와 일치하는 문서가 캐시된 문서가 없으면 빈 결과 집합을 반환합니다.

서명:

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

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>

반환:

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

쿼리 결과로 확인될 Promise입니다.

getDocsFromServer(쿼리)

쿼리를 실행하고 결과를 서버에서 QuerySnapshot로 반환합니다. 네트워크를 사용할 수 없는 경우 오류가 반환됩니다.

서명:

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

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>

반환:

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

쿼리 결과로 확인될 Promise입니다.

onSnapshot(쿼리, 관찰자)

QuerySnapshot 이벤트의 리스너를 연결합니다. 개별 onNext 및 onError 콜백을 전달하거나 next 및 error 콜백으로 단일 관찰자 객체를 전달할 수 있습니다. onSnapshot가 호출될 때 반환되는 함수를 호출하여 리스너를 취소할 수 있습니다.

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, observer: {
    next?: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	리슨할 쿼리입니다.
관찰자	{ 다음?: (스냅샷: QuerySnapshot<AppModelType, DBMModelType>) => 무효 오류?: (오류: FirestoreError) => 무효 완료 여부: () => 무효 }	`next` 및 `error` 콜백을 포함하는 단일 객체입니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshot(쿼리, 옵션, 관찰자)

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, options: SnapshotListenOptions, observer: {
    next?: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	수신 대기할 쿼리입니다.
옵션	SnapshotListenOptions	수신 대기 동작을 제어하는 옵션입니다.
관찰자	{ 다음?: (스냅샷: QuerySnapshot<AppModelType, DBMModelType>) => 무효 오류?: (오류: FirestoreError) => 무효 완료 여부: () => 무효 }	`next` 및 `error` 콜백을 포함하는 단일 객체입니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshot(query, onNext, onError, onFinished)

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, onNext: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	수신 대기할 쿼리입니다.
onNext	(스냅샷: QuerySnapshot<AppModelType, DBMModelType>) => 무효	새 `QuerySnapshot`를 사용할 수 있을 때마다 호출되는 콜백입니다.
onError	(오류: FirestoreError) => 무효	수신 대기가 실패하거나 취소되는 경우 호출할 콜백입니다. 더 이상 콜백이 발생하지 않습니다.
oncomplete	() => 무효	제공할 수 있지만 스트림이 끝나지 않으므로 호출되지 않습니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshot(query, options, onNext, onError, onFinished)

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(query: Query<AppModelType, DbModelType>, options: SnapshotListenOptions, onNext: (snapshot: QuerySnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

매개변수

매개변수	유형	설명
쿼리	쿼리<AppModelType, DBMModelType>	수신 대기할 쿼리입니다.
옵션	SnapshotListenOptions	수신 대기 동작을 제어하는 옵션입니다.
onNext	(스냅샷: QuerySnapshot<AppModelType, DBMModelType>) => 무효	새 `QuerySnapshot`를 사용할 수 있을 때마다 호출되는 콜백입니다.
onError	(오류: FirestoreError) => 무효	수신 대기가 실패하거나 취소되는 경우 호출할 콜백입니다. 더 이상 콜백이 발생하지 않습니다.
oncomplete	() => 무효	제공할 수 있지만 스트림이 끝나지 않으므로 호출되지 않습니다.

반환:

QueryCompositeFilterConstraint

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

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를 자동으로 할당합니다.

서명:

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로 확인됩니다 (오프라인 상태에서는 확인되지 않음).

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

지정된 상대 경로에 있는 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에서 참조한 문서를 삭제합니다.

서명:

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

매개변수

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

반환:

Promise<void>

문서가 백엔드에서 성공적으로 삭제되면 프로미스가 해결됩니다 (오프라인 상태에서는 확인되지 않음).

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(참조)

이 DocumentReference에서 참조하는 문서를 읽습니다.

서명:

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

매개변수

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

반환:

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

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

getDocFromCache(참조)

이 DocumentReference가 참조하는 문서를 캐시에서 읽습니다. 문서가 현재 캐시되지 않은 경우 오류를 반환합니다.

서명:

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

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>

반환:

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

Promise이 현재 문서 콘텐츠가 포함된 DocumentSnapshot로 확인되었습니다.

getDocFromServer(참조)

이 DocumentReference가 참조한 문서를 서버에서 읽습니다. 네트워크를 사용할 수 없는 경우 오류가 반환됩니다.

서명:

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

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>

반환:

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

Promise이 현재 문서 콘텐츠가 포함된 DocumentSnapshot로 확인되었습니다.

onSnapshot(참조, 관찰자)

DocumentSnapshot 이벤트의 리스너를 연결합니다. 개별 onNext 및 onError 콜백을 전달하거나 next 및 error 콜백으로 단일 관찰자 객체를 전달할 수 있습니다.

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, observer: {
    next?: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	리슨할 문서에 대한 참조입니다.
관찰자	{ 다음?: (스냅샷: DocumentSnapshot<AppModelType, DBMModelType>) => 무효 오류?: (오류: FirestoreError) => 무효 완료 여부: () => 무효 }	`next` 및 `error` 콜백을 포함하는 단일 객체입니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshot(reference, options, 관찰자)

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, options: SnapshotListenOptions, observer: {
    next?: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void;
    error?: (error: FirestoreError) => void;
    complete?: () => void;
}): Unsubscribe;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	리슨할 문서에 대한 참조입니다.
옵션	SnapshotListenOptions	수신 대기 동작을 제어하는 옵션입니다.
관찰자	{ 다음?: (스냅샷: DocumentSnapshot<AppModelType, DBMModelType>) => 무효 오류?: (오류: FirestoreError) => 무효 완료 여부: () => 무효 }	`next` 및 `error` 콜백을 포함하는 단일 객체입니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshot(reference, onNext, onError, oncomplete)

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, onNext: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	리슨할 문서에 대한 참조입니다.
onNext	(스냅샷: DocumentSnapshot<AppModelType, DBMModelType>) => 무효	새 `DocumentSnapshot`를 사용할 수 있을 때마다 호출되는 콜백입니다.
onError	(오류: FirestoreError) => 무효	수신 대기가 실패하거나 취소되는 경우 호출할 콜백입니다. 더 이상 콜백이 발생하지 않습니다.
oncomplete	() => 무효	제공할 수 있지만 스트림이 끝나지 않으므로 호출되지 않습니다.

반환:

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

onSnapshot(reference, options, onNext, onError, onFinished)

참고: onCompletion 콜백을 제공할 수는 있지만 스냅샷 스트림이 끝나지 않기 때문에 호출되지 않습니다.

서명:

export declare function onSnapshot<AppModelType, DbModelType extends DocumentData>(reference: DocumentReference<AppModelType, DbModelType>, options: SnapshotListenOptions, onNext: (snapshot: DocumentSnapshot<AppModelType, DbModelType>) => void, onError?: (error: FirestoreError) => void, onCompletion?: () => void): Unsubscribe;

매개변수

매개변수	유형	설명
참조	DocumentReference<AppModelType, DBMModelType>	리슨할 문서에 대한 참조입니다.
옵션	SnapshotListenOptions	수신 대기 동작을 제어하는 옵션입니다.
onNext	(스냅샷: DocumentSnapshot<AppModelType, DBMModelType>) => 무효	새 `DocumentSnapshot`를 사용할 수 있을 때마다 호출되는 콜백입니다.
onError	(오류: FirestoreError) => 무효	수신 대기가 실패하거나 취소되는 경우 호출할 콜백입니다. 더 이상 콜백이 발생하지 않습니다.
oncomplete	() => 무효	제공할 수 있지만 스트림이 끝나지 않으므로 호출되지 않습니다.

반환:

MemoryLruGarbageCollector

스냅샷 리스너를 취소하기 위해 호출할 수 있는 구독 해제 함수입니다.

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가 확인됩니다 (오프라인 상태에서는 확인되지 않음).

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>

데이터가 백엔드에 성공적으로 기록되면 프로미스가 해결됩니다 (오프라인 상태에서는 확인되지 않음).

updateDoc(참조, 데이터)

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

서명:

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가 확인됩니다 (오프라인 상태에서는 확인되지 않음).

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가 확인됩니다 (오프라인 상태에서는 확인되지 않음).

함수(설정, ...)

메모리 로컬 캐시(설정)

MemoryLocalCache의 인스턴스를 생성합니다. 인스턴스를 FirestoreSettings.cache로 설정하여 사용할 캐시 레이어를 SDK에 알릴 수 있습니다.

서명:

export declare function memoryLocalCache(settings?: MemoryCacheSettings): MemoryLocalCache;

매개변수

매개변수	유형	설명
설정	MemoryCacheSettings

반환:

MemoryLocalCache

메모리 LruGarbageCollector(설정)

MemoryLruGarbageCollector의 인스턴스를 생성합니다.

목표 크기는 설정 매개변수의 일부로 지정할 수 있습니다. 캐시 크기가 지정된 크기를 초과하면 수집기가 문서를 삭제하기 시작합니다. 기본 캐시 크기는 40MB (40 * 1024 * 1,024바이트)입니다.

서명:

export declare function memoryLruGarbageCollector(settings?: {
    cacheSizeBytes?: number;
}): MemoryLruGarbageCollector;

매개변수

매개변수	유형	설명
설정	{ cacheSizeBytes?: number; }

반환:

영구 로컬 캐시(설정)

PersistentLocalCache의 인스턴스를 생성합니다. 인스턴스를 FirestoreSettings.cache로 설정하여 사용할 캐시 레이어를 SDK에 알릴 수 있습니다.

영구 캐시는 Node.js 환경에서 사용할 수 없습니다.

서명:

export declare function persistentLocalCache(settings?: PersistentCacheSettings): PersistentLocalCache;

매개변수

매개변수	유형	설명
설정	PersistentCacheSettings

반환:

PersistentLocalCache

영구단일탭 관리자(설정)

PersistentSingleTabManager의 인스턴스를 생성합니다.

서명:

export declare function persistentSingleTabManager(settings: PersistentSingleTabManagerSettings | undefined): PersistentSingleTabManager;

매개변수

매개변수	유형	설명
설정	PersistentSingleTabManagerSettings \| 정의되지 않음	생성된 탭 관리자를 구성합니다.

반환:

PersistentSingleTabManager

함수(스냅샷, ...)

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>	시작할 문서의 스냅샷입니다.

반환: