Se puede utilizar un objeto CollectionReference para agregar documentos, obtener referencias de documentos y consultar documentos (usando query() ).
Firma:
export declare class CollectionReference<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData> extends Query<AppModelType, DbModelType>
Se extiende: consulta <AppModelType, DbModelType>
Propiedades
| Propiedad | Modificadores | Tipo | Descripción |
|---|---|---|---|
| identificación | cadena | El identificador de la colección. | |
| padre | Referencia de documento < DocumentoDatos , Datos del documento > | nulo | Una referencia a la DocumentReference que la contiene si se trata de una subcolección. Si no es una subcolección, la referencia es nula. | |
| camino | cadena | Una cadena que representa la ruta de la colección a la que se hace referencia (relativa a la raíz de la base de datos). | |
| tipo | (No declarado) | El tipo de esta referencia de Firestore. |
Métodos
| Método | Modificadores | Descripción |
|---|---|---|
| conConvertidor(convertidor) | Aplica un convertidor de datos personalizado a esta CollectionReference , lo que le permite usar sus propios objetos de modelo personalizados con Firestore. Cuando llamas a addDoc() con la instancia CollectionReference devuelta, el convertidor proporcionado convertirá entre datos de Firestore de tipo NewDbModelType y tu tipo personalizado NewAppModelType . | |
| conConvertidor(convertidor) | Elimina el convertidor actual. |
ColecciónReferencia.id
El identificador de la colección.
Firma:
get id(): string;
ColecciónReferencia.padre
Una referencia a la DocumentReference que la contiene si se trata de una subcolección. Si no es una subcolección, la referencia es nula.
Firma:
get parent(): DocumentReference<DocumentData, DocumentData> | null;
ColecciónReferencia.ruta
Una cadena que representa la ruta de la colección a la que se hace referencia (relativa a la raíz de la base de datos).
Firma:
get path(): string;
ColecciónReferencia.tipo
El tipo de esta referencia de Firestore.
Firma:
readonly type = "collection";
ColecciónReference.withConverter()
Aplica un convertidor de datos personalizado a esta CollectionReference , permitiéndote usar tus propios objetos de modelo personalizados con Firestore. Cuando llamas a addDoc() con la instancia CollectionReference devuelta, el convertidor proporcionado convertirá entre los datos de Firestore de tipo NewDbModelType y tu tipo personalizado NewAppModelType .
Firma:
withConverter<NewAppModelType, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<NewAppModelType, NewDbModelType>): CollectionReference<NewAppModelType, NewDbModelType>;
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| convertidor | FirestoreDataConverter <Nuevo tipo de modelo de aplicación, nuevo tipo de modelo de base de datos> | Convierte objetos hacia y desde Firestore. |
Devoluciones:
ColecciónReferencia <Nuevo tipo de modelo de aplicación, nuevo tipo de modelo de base de datos>
Una CollectionReference que utiliza el convertidor proporcionado.
ColecciónReference.withConverter()
Elimina el convertidor actual.
Firma:
withConverter(converter: null): CollectionReference<DocumentData, DocumentData>;
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| convertidor | nulo | null elimina el convertidor actual. |
Devoluciones:
ColecciónReferencia < DocumentoDatos , Datos del documento >
Una CollectionReference<DocumentData, DocumentData> que no utiliza un convertidor.