mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-12-22 14:41:29 +01:00
350 lines
8.9 KiB
JavaScript
350 lines
8.9 KiB
JavaScript
/**
|
|
* EGroupware clientside API object
|
|
*
|
|
* @license http://opensource.org/licenses/gpl-license.php GPL - GNU General Public License
|
|
* @package etemplate
|
|
* @subpackage api
|
|
* @link http://www.egroupware.org
|
|
* @author Andreas Stöckel (as AT stylite.de)
|
|
* @author Ralf Becker <RalfBecker@outdoor-training.de>
|
|
* @version $Id$
|
|
*/
|
|
|
|
"use strict";
|
|
|
|
/*egw:uses
|
|
egw_core;
|
|
*/
|
|
|
|
egw.extend('debug', egw.MODULE_GLOBAL, function(_app, _wnd) {
|
|
|
|
/**
|
|
* DEBUGLEVEL specifies which messages are printed to the console.
|
|
* Decrease the value of EGW_DEBUGLEVEL to get less messages.
|
|
*
|
|
* @type Number
|
|
* 0 = off, no logging
|
|
* 1 = only "error"
|
|
* 2 = -- " -- plus "warning"
|
|
* 3 = -- " -- plus "info"
|
|
* 4 = -- " -- plus "log"
|
|
* 5 = -- " -- plus a stacktrace
|
|
*/
|
|
var DEBUGLEVEL = 3;
|
|
|
|
/**
|
|
* Log-level for local storage
|
|
*
|
|
* @type Number
|
|
*/
|
|
var LOCAL_LOG_LEVEL = 2;
|
|
/**
|
|
* Number of log-entries stored on client, new errors overwrite old ones
|
|
*
|
|
* @type Number
|
|
*/
|
|
var MAX_LOGS = 1000;
|
|
/**
|
|
* Number of last old log entry = next one to overwrite
|
|
*
|
|
* @type String
|
|
*/
|
|
var LASTLOG = 'lastLog';
|
|
/**
|
|
* Prefix for key of log-message, message number gets appended to it
|
|
*
|
|
* @type String
|
|
*/
|
|
var LOG_PREFIX = 'log_';
|
|
|
|
/**
|
|
* Log to clientside html5 localStorage
|
|
*
|
|
* @param {String} _level "navigation", "log", "info", "warn", "error"
|
|
* @param {Array} _args arguments to egw.debug
|
|
* @returns {Boolean} false if localStorage is NOT supported, null if level requires no logging, true if logged
|
|
*/
|
|
function log_on_client(_level, _args)
|
|
{
|
|
if (!window.localStorage) return false;
|
|
|
|
switch(_level)
|
|
{
|
|
case 'warn':
|
|
if (LOCAL_LOG_LEVEL < 2) return null;
|
|
case 'info':
|
|
if (LOCAL_LOG_LEVEL < 3) return null;
|
|
case 'log':
|
|
if (LOCAL_LOG_LEVEL < 4) return null;
|
|
default:
|
|
if (!LOCAL_LOG_LEVEL) return null;
|
|
}
|
|
var data = {
|
|
time: (new Date()).getTime(),
|
|
level: _level,
|
|
args: _args
|
|
};
|
|
// Add in a trace, if no navigation _level
|
|
if (_level != 'navigation' && typeof (new Error).stack != 'undefined')
|
|
{
|
|
data.stack = (new Error).stack;
|
|
}
|
|
if (typeof window.localStorage[LASTLOG] == 'undefined')
|
|
{
|
|
window.localStorage[LASTLOG] = 0;
|
|
}
|
|
try {
|
|
window.localStorage[LOG_PREFIX+window.localStorage[LASTLOG]] = JSON.stringify(data);
|
|
}
|
|
catch(e) {
|
|
// one of the args is not JSON.stringify, because it contains circular references eg. an et2 widget
|
|
for(var i=0; i < data.args.length; ++i)
|
|
{
|
|
try {
|
|
JSON.stringify(data.args[i]);
|
|
}
|
|
catch(e) {
|
|
// for Class we try removing _parent and _children attributes and try again to stringify
|
|
if (data.args[i] instanceof Class)
|
|
{
|
|
data.args[i] = jQuery.extend({}, data.args[i]);
|
|
delete data.args[i]._parent;
|
|
delete data.args[i]._children;
|
|
try {
|
|
JSON.stringify(data.args[i]);
|
|
continue; // stringify worked --> check other arguments
|
|
}
|
|
catch(e) {
|
|
// ignore error and remove whole argument
|
|
}
|
|
}
|
|
// if above doesnt work, we remove the attribute
|
|
data.args[i] = '** removed, circular reference **';
|
|
}
|
|
}
|
|
window.localStorage[LOG_PREFIX+window.localStorage[LASTLOG]] = JSON.stringify(data);
|
|
}
|
|
window.localStorage[LASTLOG] = (1 + parseInt(window.localStorage[LASTLOG])) % MAX_LOGS;
|
|
}
|
|
|
|
/**
|
|
* Get log from localStorage with oldest message first
|
|
*
|
|
* @returns {Array} of Object with values for attributes level, message, trace
|
|
*/
|
|
function get_client_log()
|
|
{
|
|
var logs = [];
|
|
|
|
if (window.localStorage && typeof window.localStorage[LASTLOG] != 'undefined')
|
|
{
|
|
var lastlog = parseInt(window.localStorage[LASTLOG]);
|
|
for(var i=lastlog; i < lastlog+MAX_LOGS; ++i)
|
|
{
|
|
var log = window.localStorage[LOG_PREFIX+(i%MAX_LOGS)];
|
|
if (typeof log != 'undefined')
|
|
{
|
|
try {
|
|
logs.push(JSON.parse(log));
|
|
}
|
|
catch(e) {
|
|
// ignore not existing log entries
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return logs;
|
|
}
|
|
|
|
/**
|
|
* Clears whole client log
|
|
*/
|
|
function clear_client_log()
|
|
{
|
|
// Remove indicator icon
|
|
jQuery('#topmenu_info_error').remove();
|
|
|
|
if (!window.localStorage) return false;
|
|
|
|
for(var i=0; i < MAX_LOGS; ++i)
|
|
{
|
|
if (typeof window.localStorage[LOG_PREFIX+i] != 'undefined')
|
|
{
|
|
delete window.localStorage[LOG_PREFIX+i];
|
|
}
|
|
}
|
|
delete window.localStorage[LASTLOG];
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Format one log message for display
|
|
*
|
|
* @param {Object} log {{level: string, time: number, stack: string, args: array[]}} Log information
|
|
* Actual message is in args[0]
|
|
* @returns {DOMNode}
|
|
*/
|
|
function format_message(log)
|
|
{
|
|
var row = document.createElement('tr');
|
|
row.setAttribute('class', log.level);
|
|
var timestamp = row.insertCell(-1);
|
|
timestamp.appendChild(document.createTextNode(new Date(log.time)));
|
|
timestamp.setAttribute('class', 'timestamp');
|
|
|
|
var level = row.insertCell(-1);
|
|
level.appendChild(document.createTextNode(log.level));
|
|
level.setAttribute('class', 'level');
|
|
|
|
var message = row.insertCell(-1);
|
|
for(var i = 0; i < log.args.length; i++)
|
|
{
|
|
|
|
var arg = document.createElement('p');
|
|
arg.appendChild(
|
|
document.createTextNode(typeof log.args[i] == 'string' ? log.args[i] : JSON.stringify( log.args[i]))
|
|
);
|
|
message.appendChild(arg);
|
|
}
|
|
|
|
var stack = row.insertCell(-1);
|
|
stack.appendChild(document.createTextNode(log.stack||''));
|
|
stack.setAttribute('class','stack');
|
|
|
|
return row;
|
|
}
|
|
|
|
/**
|
|
* Show user an error happend by displaying a clickable icon with tooltip of current error
|
|
*/
|
|
function raise_error()
|
|
{
|
|
var icon = jQuery('#topmenu_info_error');
|
|
if (!icon.length)
|
|
{
|
|
var icon = jQuery(egw(_wnd).image_element(egw.image('dialog_error')));
|
|
icon.addClass('topmenu_info_item').attr('id', 'topmenu_info_error');
|
|
// ToDo: tooltip
|
|
icon.on('click', egw(_wnd).show_log);
|
|
jQuery('#egw_fw_topmenu_info_items,#topmenu_info').append(icon);
|
|
}
|
|
}
|
|
|
|
// bind to global error handler
|
|
jQuery(_wnd).on('error', function(e)
|
|
{
|
|
log_on_client('error', [e.originalEvent.message]);
|
|
raise_error();
|
|
// rethrow error to let browser log and show it in usual way too
|
|
throw e;
|
|
});
|
|
|
|
/**
|
|
* The debug function can be used to send a debug message to the
|
|
* java script console. The first parameter specifies the debug
|
|
* level, all other parameters are passed to the corresponding
|
|
* console function.
|
|
*/
|
|
return {
|
|
debug: function(_level) {
|
|
if (typeof _wnd.console != "undefined")
|
|
{
|
|
// Get the passed parameters and remove the first entry
|
|
var args = [];
|
|
for (var i = 1; i < arguments.length; i++)
|
|
{
|
|
args.push(arguments[i]);
|
|
}
|
|
|
|
// Add in a trace
|
|
if (DEBUGLEVEL >= 5 && typeof (new Error).stack != "undefined")
|
|
{
|
|
var stack = (new Error).stack;
|
|
args.push(stack);
|
|
}
|
|
|
|
if (_level == "log" && DEBUGLEVEL >= 4 &&
|
|
typeof _wnd.console.log == "function")
|
|
{
|
|
_wnd.console.log.apply(_wnd.console, args);
|
|
}
|
|
|
|
if (_level == "info" && DEBUGLEVEL >= 3 &&
|
|
typeof _wnd.console.info == "function")
|
|
{
|
|
_wnd.console.info.apply(_wnd.console, args);
|
|
}
|
|
|
|
if (_level == "warn" && DEBUGLEVEL >= 2 &&
|
|
typeof _wnd.console.warn == "function")
|
|
{
|
|
_wnd.console.warn.apply(_wnd.console, args);
|
|
}
|
|
|
|
if (_level == "error" && DEBUGLEVEL >= 1 &&
|
|
typeof _wnd.console.error == "function")
|
|
{
|
|
_wnd.console.error.apply(_wnd.console, args);
|
|
}
|
|
}
|
|
// raise errors to user
|
|
if (_level == "error") raise_error(args);
|
|
|
|
// log to html5 localStorage
|
|
if (typeof stack != 'undefined') args.pop(); // remove stacktrace again
|
|
log_on_client(_level, args);
|
|
|
|
},
|
|
|
|
/**
|
|
* Display log to user because he clicked on icon showed by raise_error
|
|
*
|
|
* @returns {undefined}
|
|
*/
|
|
show_log: function()
|
|
{
|
|
var table = document.createElement('table');
|
|
var body = document.createElement('tbody');
|
|
var client_log = get_client_log();
|
|
for(var i = 0; i < client_log.length; i++)
|
|
{
|
|
body.appendChild(format_message(client_log[i]));
|
|
}
|
|
table.appendChild(body);
|
|
|
|
// Use a wrapper div for ease of styling
|
|
var wrapper = document.createElement('div');
|
|
wrapper.setAttribute('class', 'client_error_log');
|
|
wrapper.appendChild(table);
|
|
|
|
if(window.jQuery && window.jQuery.ui.dialog)
|
|
{
|
|
var $wrapper = $j(wrapper);
|
|
// Start hidden
|
|
$j('tr',$wrapper).addClass('hidden')
|
|
.on('click', function() {
|
|
$j(this).toggleClass('hidden',{});
|
|
$j(this).find('.stack').children().toggleClass('ui-icon ui-icon-circle-plus');
|
|
});
|
|
// Wrap in div so we can control height
|
|
$j('td',$wrapper).wrapInner('<div/>')
|
|
.filter('.stack').children().addClass('ui-icon ui-icon-circle-plus');
|
|
|
|
$wrapper.dialog({
|
|
title: egw.lang('Error log'),
|
|
buttons: [
|
|
{text: egw.lang('OK'), click: function() {$j(this).dialog( "close" ); }},
|
|
{text: egw.lang('clear'), click: function() {clear_client_log(); $j(this).empty();}}
|
|
],
|
|
width: 800,
|
|
height: 400
|
|
});
|
|
$wrapper[0].scrollTop = $wrapper[0].scrollHeight;
|
|
}
|
|
if (_wnd.console) _wnd.console.log(get_client_log());
|
|
}
|
|
};
|
|
});
|
|
|