Mongoose-modified-at 是一款自动更新字段变化时间并记录到数据库中的 Mongoose 插件，类似 Mongoose 自带的 timestamps 功能。
使用场景
让我们考虑一个场景，我们有个文章发布与展示的需求，数据模型如下。
const schema = new mongoose.Schema({
当我们在展示最新文章列表时，应该是以文章第一次发布的时间倒序展示，因为文章可以存为草稿，多次编辑，所以不能用 Mongoose 提供的 createdAt 或 updatedAt 作为第一次发布的时间，正确的做法是在每次文章创建或更新时，确定用户是发布文章而不是存为草稿，然后记录此次时间，用该时间作为第一次发布的时间。
要实现该功能我们需要在代码逻辑层进行处理，这样可行不过有点耦合，或者自己封装一个 Mongoose 中间件来做这件事，不过现在你可以把这件事交给一个经受测试、API 优雅的插件 ModifiedAt 来处理。
首先安装插件。
npm install mongoose-modified-at --save
然后在 Schema 初始化时做简单的配置即可，如下。
import modifiedAt from 'mongoose-modified-at'
当文档保存或更新携带着 is_draft 字段并且值为 false 时，插件就会记录此次时间到你声明的 publishedAt 字段上一起写入数据库。
示例如下：
await Article.create({
结果如下（数据库）：
{
API介绍
上面是 ModifiedAt 的富 API 形式，即对象格式，全部参数选项如下。
schema.plugin(modifiedAt, {
🍎 参数解释：
-
fields: 设置监听字段，在文档创建或更新时，如果存在被监听的字段，则自动以字段名 + 后缀的形式作为字段，并记录此次更新时间到该字段上。 可选，Array类型。 -
suffix: 设置后缀，默认值为_modifiedAt。 可选，String类型。 -
select: 设置路径默认行为，默认为true。 可选，Boolean类型。 -
customField: 自定义字段，此字段不会加后缀，以函数形式添加到参数中，用于自定义功能，函数接收唯一文档参数，当函数返回值为真值时，则记录此次时间到该字段上。
简化API
🚀 为了增加 API 的简洁易用同时避免过度重载，ModifiedAt 只增加了一种简化传参格式，如下。
schema.plugin(modifiedAt, ['name', 'status'])
意思是将 fields 选项提取出来作为参数，写入数据库的结果如下。
{
支持异步
你需要 Node.js 版本支持 async/await 即可。
import P from 'bluebird'
支持 Mongoose 4.x
如果你现在使用的是 Mongoose 4.x，那么你需要使用插件 1.x 版本，文档可在阅读原文里查看。
npm install mongoose-modified-at@1 --save
“100%”测试覆盖率
29 个测试用例，777 行代码，“100%” 测试覆盖率。
细节
更多细节处理请移步至 GitHub 文档，请在阅读原文里查看。
最后
本插件在京东智能设计项目 - 羚珑中实际应用，ling.jd.com 欢迎体验 😘。
本文分享自微信公众号 - 凹凸实验室（AOTULabs）。
如有侵权，请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”，欢迎正在阅读的你也加入，一起分享。