mediawiki-extensions-Echo/modules/model/mw.echo.dm.SeenTimeModel.js
thiemowmde fbcb1a5831 Fix improper @private documentation in .js code
@private usually means "cannot be used outside of this class". But
this is used. I assume it's meant to be @internal as in "internal to
this codebase".

Change-Id: I9326e17f706af336ea0d4b7c0af95330ed575810
2024-08-11 17:51:26 +02:00

80 lines
1.9 KiB
JavaScript

( function () {
/**
* SeenTime model for Echo notifications
*
* @param {Object} [config] Configuration
* @param {string|string[]} [config.types='alert','message'] The types of notifications
* that this model handles
*/
mw.echo.dm.SeenTimeModel = function MwEchoSeenTimeModel( config ) {
config = config || {};
// Mixin constructor
OO.EventEmitter.call( this );
this.types = [ 'alert', 'message' ];
if ( config.types ) {
this.types = Array.isArray( config.types ) ? config.types : [ config.types ];
}
this.seenTime = mw.config.get( 'wgEchoSeenTime' ) || {};
};
/* Initialization */
OO.initClass( mw.echo.dm.SeenTimeModel );
OO.mixinClass( mw.echo.dm.SeenTimeModel, OO.EventEmitter );
/* Events */
/**
* Seen time has been updated for the given source
*
* @event mw.echo.dm.SeenTimeModel#update
* @param {string} time Seen time, as a full UTC ISO 8601 timestamp.
*/
/* Methods */
/**
* Get the global seenTime value
*
* @return {string} Seen time, as a full UTC ISO 8601 timestamp.
*/
mw.echo.dm.SeenTimeModel.prototype.getSeenTime = function () {
return this.seenTime[ this.getTypes()[ 0 ] ] || 0;
};
/**
* Set the seen time value for the source
*
* @internal
* @param {string} time Seen time, as a full UTC ISO 8601 timestamp.
* @fires mw.echo.dm.SeenTimeModel#update
*/
mw.echo.dm.SeenTimeModel.prototype.setSeenTime = function ( time ) {
let hasChanged = false;
this.getTypes().forEach( ( type ) => {
if ( this.seenTime[ type ] !== time ) {
this.seenTime[ type ] = time;
hasChanged = true;
}
} );
if ( hasChanged ) {
this.emit( 'update', time );
}
};
/**
* Get the types associated with this model
*
* @internal
* @return {string[]} Types for this model; an array of 'alert', 'message' or both.
*/
mw.echo.dm.SeenTimeModel.prototype.getTypes = function () {
return this.types;
};
}() );