iridium-timestamps
v1.0.0
Published
Iridium plugin for automatic creation and modification timestamping
Downloads
2
Readme
Iridium Modification Timestamps
This plugin adds the ability to keep track of createdOn
and modifiedOn
properties on models defined using Iridium, a high performance MongoDB ODM.
Install
npm install iridium-timestamps
Dependencies
You'll need Iridium to use this plugin, but other than that there are no external dependencies.
Example
var iridium = require('iridium'),
modts = require('iridium-timestamps');
iridium.register(modts);
module.exports = function(db) {
var schema = {
};
var options = {
timestamps: {
createdProperty: 'createdOn',
modifiedProperty: 'modifiedOn',
now: function() { return new Date(); },
persist: true
}
};
};
Options
createdProperty
string|false Determines the name of the property use to store the created timestamp (default"createdOn"
). If set tofalse
, disables this property.modifiedProperty
string|false Determines the name of the property used to store the modified timestamp (default"modifiedOn"
). If set tofalse
, disables this property.now
function Allows you to specify a custom function used to set the current time data for the database (defaultfunction() { return new Date(); }
).persist
boolean Used to prevent creation and modification timestamps from being stored in the database (defaulttrue
). If you set this to false, be aware that"createdOn"
will reflect the time at which the instance was retrieved from the database.
Features
- Easy to add created and modified date/time information to your models
- Highly customizable
- Supports existing creating and saving hooks through the use of a robust wrapper function
- Allows values to be stored "in-memory" if usage scenarios don't require them to be stored in the database.