Source
/*
** Copyright (C) 2001-2025 Zabbix SIA
**
** This program is free software: you can redistribute it and/or modify it under the terms of
** the GNU Affero General Public License as published by the Free Software Foundation, version 3.
**
** This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
** without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
** See the GNU Affero General Public License for more details.
**
** You should have received a copy of the GNU Affero General Public License along with this program.
** If not, see <https://www.gnu.org/licenses/>.
**/
/**
* A stack implementation for identified overlay objects.
*
* @prop {int} length Overlay collection size.
* @prop {array} stack Array of overlay identifiers.
* @prop {object} map Overlay objects keyed by their identifiers.
*/
function OverlayCollection() {
this.stack = [];
this.map = {};
}
Object.defineProperty(OverlayCollection.prototype, 'length', {
get: function () {
return this.stack.length;
},
writeable: false
});
/**
* Fetches overlay object positioned at top of stack.
*
* @return {object|undefined} Overlay object currently in top of stack.
*/
OverlayCollection.prototype.end = function() {
return this.getById(this.stack[this.length - 1]);
};
/**
* Retrieve overlay by it's ID.
*
* @param {string} id Overlay identifier.
*
* @return {Overlay|undefined} Overlay object.
*/
OverlayCollection.prototype.getById = function(id) {
return this.map[id];
};
/**
* Adds new overlay to the stack or, if it already exists, moves it to the top of the stack.
*
* @param {object} Overlay object.
*/
OverlayCollection.prototype.pushUnique = function(overlay) {
if (this.map[overlay.dialogueid]) {
this._restackEnd(overlay.dialogueid);
}