How do you turn a Mongoose document into a plain object?

Mongoose 是一个 MongoDB 对象文档模型（ODM）库，它在 Node.js 环境下提供了一种模型化和处理 MongoDB 文档的便捷方式。Mongoose 文档是带有附加功能和行为的特殊对象，有时候我们需要把这些文档转换成普通的 JavaScript 对象，以便于进行 JSON 序列化或者简化处理逻辑。

要将 Mongoose 文档转换为普通对象，可以使用 .toObject() 方法，这个方法会返回一个纯净的 JavaScript 对象，剔除了 Mongoose 文档的所有特殊功能和额外的属性。此外，当你调用 .toJSON() 方法时，内部其实是调用了 .toObject() 并应用了 schema 上的 json 转换选项。

以下是一个例子，展示了如何使用 .toObject() 方法：

javascript
const mongoose = require('mongoose');
const Schema = mongoose.Schema;

// 定义一个Schema
const userSchema = new Schema({
  name: String,
  age: Number
});

// 创建Model
const User = mongoose.model('User', userSchema);

// 查询文档
User.findById('用户ID').exec((err, doc) => {
  if (err) throw err;
  
  if (doc) {
    // 将 Mongoose 文档转换为普通对象
    const plainObject = doc.toObject();
  
    // 现在你可以按照普通对象的处理方式来处理 plainObject
    console.log(plainObject);
  }
});

在 .toObject() 方法中，你还可以传递选项来自定义转换的结果：

javascript
const plainObject = doc.toObject({
  getters: true, // 应用 schema 定义的 getters
  virtuals: true, // 包含虚拟属性
  versionKey: false, // 不包含 __v 属性（版本键）
  transform: function (doc, ret, options) {
    // 自定义转换逻辑
    delete ret._id; // 不包含 _id 属性
    return ret;
  }
});

在实际的开发中，这个功能非常有用，比如在我们需要将查询出的结果返回给前端前，可以先转换为普通对象，去除不必要的信息或者调整对象结构，以满足前端的数据需求。