Una DocumentReference hace referencia a la ubicación de un documento en una base de datos de Firestore y se puede usar para escribir, leer o escuchar la ubicación. El documento en la ubicación a la que se hace referencia puede o no existir.
Firma:
export declare class DocumentReference<AppModelType = DocumentData, DbModelType extends DocumentData = DocumentData>
Propiedades
| Propiedad | modificadores | Tipo | Descripción |
|---|---|---|---|
| convertidor | FirestoreDataConverter <Tipo de modelo de aplicación, Tipo de modelo de base de datos> | nulo | Si se proporciona, el FirestoreDataConverter asociado con esta instancia. | |
| tienda de fuego | Firestore | La instancia de Firestore en la que se encuentra el documento. Esto es útil para realizar transacciones, por ejemplo. | |
| identificación | cadena | El identificador del documento dentro de su colección. | |
| padre | ColecciónReferencia <Tipo de modelo de aplicación, Tipo de modelo de base de datos> | La colección a la que pertenece esta DocumentReference . | |
| camino | cadena | Una cadena que representa la ruta del documento al que se hace referencia (en relación con 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 |
|---|---|---|
| withConverter(convertidor) | Aplica un convertidor de datos personalizado a esta DocumentReference , lo que le permite usar sus propios objetos de modelo personalizados con Firestore. Cuando llamas a setDoc() , obtenerDoc() , etc. con la instancia DocumentReference devuelta, el convertidor proporcionado convertirá entre los datos de Firestore de tipo NewDbModelType y su tipo personalizado NewAppModelType . | |
| withConverter(convertidor) | Elimina el convertidor de corriente. |
DocumentReference.convertidor
Si se proporciona, el FirestoreDataConverter asociado con esta instancia.
Firma:
readonly converter: FirestoreDataConverter<AppModelType, DbModelType> | null;
DocumentReference.firestore
La instancia de Firestore en la que se encuentra el documento. Esto es útil para realizar transacciones, por ejemplo.
Firma:
readonly firestore: Firestore;
DocumentReference.id
El identificador del documento dentro de su colección.
Firma:
get id(): string;
DocumentReference.parent
La colección a la que pertenece esta DocumentReference .
Firma:
get parent(): CollectionReference<AppModelType, DbModelType>;
DocumentReference.ruta
Una cadena que representa la ruta del documento al que se hace referencia (en relación con la raíz de la base de datos).
Firma:
get path(): string;
DocumentReference.type
El tipo de esta referencia de Firestore.
Firma:
readonly type = "document";
DocumentReference.withConverter()
Aplica un convertidor de datos personalizado a esta DocumentReference , lo que le permite usar sus propios objetos de modelo personalizados con Firestore. Cuando llamas a setDoc() , obtenerDoc() , etc. con la instancia DocumentReference devuelta, el convertidor proporcionado convertirá entre los datos de Firestore de tipo NewDbModelType y su tipo personalizado NewAppModelType .
Firma:
withConverter<NewAppModelType, NewDbModelType extends DocumentData = DocumentData>(converter: FirestoreDataConverter<NewAppModelType, NewDbModelType>): DocumentReference<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:
Referencia de documento <Nuevo Tipo de Modelo de Aplicación, Nuevo Tipo de Modelo de Base de Datos>
Una DocumentReference que usa el convertidor proporcionado.
DocumentReference.withConverter()
Elimina el convertidor de corriente.
Firma:
withConverter(converter: null): DocumentReference<DocumentData, DocumentData>;
Parámetros
| Parámetro | Tipo | Descripción |
|---|---|---|
| convertidor | nulo | null elimina el convertidor actual. |
Devoluciones:
Referencia de documento < Datos del documento , DocumentoDatos >
Una DocumentReference<DocumentData, DocumentData> que no usa un convertidor.