¿Cómo funciona Query.prototype.collation() en Mongoose?

Query.prototype.collation () permite a los usuarios especificar reglas específicas del idioma para varias comparaciones, como la comparación de strings, como las reglas para los acentos o las reglas para las mayúsculas y minúsculas, etc.
Sintaxis: 
 

Query.prototype.collation()

Parámetros: esta función tiene un parámetro de array, es decir, un objeto que puede tener varias propiedades, como configuración regional, nivel de caso, primero de caso, etc.
Valor devuelto: esta función devuelve el objeto de consulta.

Instalación de mangosta: 

npm install mongoose

Después de instalar el módulo mongoose, puede verificar su versión mongoose en el símbolo del sistema usando el comando. 

npm mongoose --version

Después de eso, puede simplemente crear una carpeta y agregar un archivo, por ejemplo, index.js como se muestra a continuación.

Ejemplo 1:

const mongoose = require('mongoose');
  
// Database connection
mongoose.connect('mongodb://127.0.0.1:27017/geeksforgeeks', {
    useNewUrlParser: true,
    useCreateIndex: true,
    useUnifiedTopology: true
});
  
// User model
const User = mongoose.model('User', { 
    name: { type: String },
    age: { type: Number }
});
  
var query = User.find();
query.collation({ caseFirst:"upper" })
  
console.log("Collation set to : ", query.options)

La estructura del proyecto se verá así: 
 

Ejecute el archivo index.js usando el siguiente comando: 

node index.js

Producción:

Collation set to :  { collation: { caseFirst: 'upper' } }

Ejemplo 2:

const express = require('express');
const mongoose = require('mongoose');
const app = express()
  
// Database connection
mongoose.connect('mongodb://127.0.0.1:27017/geeksforgeeks', {
    useNewUrlParser: true,
    useCreateIndex: true,
    useUnifiedTopology: true
});
  
// User model
const User = mongoose.model('User', { 
    name: { type: String },
    age: { type: Number }
});
  
var query = User.find();
query.collation({ caseFirst:"upper" })
  
console.log("Collation : ", query.options)
  
app.listen(3000, function(error ){
    if(error) console.log(error)
    console.log("Server listening on PORT 3000")
})

La estructura del proyecto se verá así:

Ejecute el archivo index.js usando el siguiente comando: 

node index.js

Producción: 

Server listening on PORT 3000
Collation :  { collation: { caseFirst: 'upper' } }

Referencia: https://mongoosejs.com/docs/api/query.html#query_Query-collation