mirror of
				https://github.com/louislam/uptime-kuma.git
				synced 2025-11-04 13:46:13 +08:00 
			
		
		
		
	Added JSDoc for src/
Signed-off-by: Matthew Nickson <mnickson@sidingsmedia.com>
This commit is contained in:
		@@ -12,6 +12,11 @@ export default {
 | 
			
		||||
    },
 | 
			
		||||
 | 
			
		||||
    methods: {
 | 
			
		||||
        /**
 | 
			
		||||
         * Convert value to UTC
 | 
			
		||||
         * @param {string | number | Date | dayjs.Dayjs} value
 | 
			
		||||
         * @returns {dayjs.Dayjs}
 | 
			
		||||
         */
 | 
			
		||||
        toUTC(value) {
 | 
			
		||||
            return dayjs.tz(value, this.timezone).utc().format();
 | 
			
		||||
        },
 | 
			
		||||
@@ -34,6 +39,11 @@ export default {
 | 
			
		||||
            return this.datetimeFormat(value, "YYYY-MM-DD HH:mm:ss");
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Get time for maintenance
 | 
			
		||||
         * @param {string | number | Date | dayjs.Dayjs} value
 | 
			
		||||
         * @returns {string}
 | 
			
		||||
         */
 | 
			
		||||
        datetimeMaintenance(value) {
 | 
			
		||||
            const inputDate = new Date(value);
 | 
			
		||||
            const now = new Date(Date.now());
 | 
			
		||||
 
 | 
			
		||||
@@ -454,6 +454,10 @@ export default {
 | 
			
		||||
            socket.emit("getMonitorList", callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Get list of maintenances
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        getMaintenanceList(callback) {
 | 
			
		||||
            if (! callback) {
 | 
			
		||||
                callback = () => { };
 | 
			
		||||
@@ -470,22 +474,49 @@ export default {
 | 
			
		||||
            socket.emit("add", monitor, callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Adds a maintenace
 | 
			
		||||
         * @param {Object} maintenance
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        addMaintenance(maintenance, callback) {
 | 
			
		||||
            socket.emit("addMaintenance", maintenance, callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Add monitors to maintenance
 | 
			
		||||
         * @param {number} maintenanceID
 | 
			
		||||
         * @param {number[]} monitors
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        addMonitorMaintenance(maintenanceID, monitors, callback) {
 | 
			
		||||
            socket.emit("addMonitorMaintenance", maintenanceID, monitors, callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Add status page to maintenance
 | 
			
		||||
         * @param {number} maintenanceID
 | 
			
		||||
         * @param {number} statusPages
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        addMaintenanceStatusPage(maintenanceID, statusPages, callback) {
 | 
			
		||||
            socket.emit("addMaintenanceStatusPage", maintenanceID, statusPages, callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Get monitors affected by maintenance
 | 
			
		||||
         * @param {number} maintenanceID
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        getMonitorMaintenance(maintenanceID, callback) {
 | 
			
		||||
            socket.emit("getMonitorMaintenance", maintenanceID, callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Get status pages where maintenance is shown
 | 
			
		||||
         * @param {number} maintenanceID
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        getMaintenanceStatusPage(maintenanceID, callback) {
 | 
			
		||||
            socket.emit("getMaintenanceStatusPage", maintenanceID, callback);
 | 
			
		||||
        },
 | 
			
		||||
@@ -499,6 +530,11 @@ export default {
 | 
			
		||||
            socket.emit("deleteMonitor", monitorID, callback);
 | 
			
		||||
        },
 | 
			
		||||
 | 
			
		||||
        /**
 | 
			
		||||
         * Delete specified maintenance
 | 
			
		||||
         * @param {number} maintenanceID
 | 
			
		||||
         * @param {socketCB} callback
 | 
			
		||||
         */
 | 
			
		||||
        deleteMaintenance(maintenanceID, callback) {
 | 
			
		||||
            socket.emit("deleteMaintenance", maintenanceID, callback);
 | 
			
		||||
        },
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user