console-panel
A console panel within web page to help in the following use-cases:
- Get notification on console messages
- Console logging on mobile and tablet devices
- Console logging on Microsoft Edge / Internet Explorer (without opening native Developer Tools)
Demo
Click here to view online demo.
How to use
Files to include
Minimal setup
In your HTML file, add the following tags:
Full-featured setup
In your HTML file, add the following tags:
<!-- Optional: Required for resizing panel height --> <!-- Optional: Required for logging arrays and objects --> <!-- Optional: A polyfill for native ES6 Promises (Not required for modern browsers) --> <!-- Optional: Required for logging DOM elements with syntax highlighting --> <!-- Required: Code for console-panel -->
API
consolePanel.enable(config)
This will initiate the interception logic based on the configuration options and activate console-panel as requested.
Configuration options
position
Summary: Position of console-panel's icon
Type: string
Supported positions: "top-left"
, "top-right"
, "bottom-left"
, "bottom-right"
Default value: "bottom-right"
Example value: "top-right"
functionsToIntercept
Summary: List of console functions which should be intercepted
Type: <falsy-value>
OR string "all"
OR array (of strings)
Supported function names: "window.onerror"
, "console.error"
, "console.warn"
, "console.info"
, "console.log"
Default value: "all"
,
Example value: ["window.onerror", "console.error"]
Notes: console.clear()
would always get intercepted when consolePanel.enable(config)
is called
showOnlyForTheseRelevantMessages
Summary: List of console function calls for which console-panel icon should be shown
Type: <falsy-value>
OR string "all"
OR array (of strings)
Supported function names: "window.onerror"
, "console.error"
, "console.warn"
, "console.info"
, "console.log"
Default value: null
Example value: ["window.onerror", "console.error", "console.warn"]
Notes: If it is a <falsy-value>
, then console-panel notification icon would be shown all the time
strongNotificationFor
Summary: List of console function calls for which console-panel notification should be shown strongly
Type: <falsy-value>
OR array (of strings)
Supported function names: "window.onerror"
, "console.error"
, "console.warn"
, "console.info"
, "console.log"
Default value: ["window.onerror", "console.error"]
Example value: ["window.onerror", "console.error", "console.warn"]
skipStrongNotificationIfNoStackTrace
Summary: When it is set as true, "strong-notification" effect is not shown for errors for which stack trace is not available. This can be used to avoid highlighting errors which are occurring due to a cross-origin / third-party script.
Type: boolean
Allowed values: <falsy-value>
OR <truthy-value>
Default value: false
Example value: false
reportLogLines
Summary: When it is set as true
, the corresponding code line is mentioned along with each console entry. When it is set as true
, it may interrupt your debugging session if you are using the "Pause on caught exceptions" feature in browser DevTools
Type: boolean
Allowed values: <falsy-value>
OR <truthy-value>
Default value: true
Example value: true
doNotUseWhenDevToolsMightBeOpenInTab
Summary: Disable console-panel if browser DevTools might be open within the tab
Type: boolean
Allowed values: <falsy-value>
OR <truthy-value>
Default value: false
Example value: false
Reference: https://github.com/sindresorhus/devtools-detect#support
disableButtonTitle
Summary: Customize the title for the "disable" button in console-panel
Type: string
Allowed values: Any non-empty string
Default value: "Disable for this instance"
Example value: "Disable\n(and keep disabled)"
beforeDisableButtonClick
Summary: Function to be called before performing the default action for "disable" button
Type: function
Example value: function () { localStorage['console-panel-status'] = 'disabled'; }
Notes: If this function returns boolean false
, then the default action would not be performed
Examples
// Enable console-panel in default mode.// Use this configuration for getting notified about console messages and// debugging for mobile devices and IE/Edge.consolePanel;
// Intercept only error logs.// Use this configuration to ensure that you don't miss out on any errors, while// continuing to use native DevTools logger for all other log entries.consolePanel;
// Do not use console-panel when browser's DevTools might be open in the tab.// Use this configuration to avoid using console-panel when you are debugging// with the help of native DevTools.consolePanel;
// Hide console-panel icon by default. But, show it as soon as any console// related message shows up.// Use this configuration if you wish to avoid seeing the console-panel icon as// long as it doesn't serve an important purpose.consolePanel;
// Show strong notification for all console related messages.// Use this configuration if you wish to catch any console messages missed out// from code clean up.consolePanel;
// Do not report the code lines for messages in console-panel.// Use this configuration if you wish to use "Pause on caught exceptions"// feature in browser DevTools (which would otherwise get interrupted by dummy// errors thrown by console-panel to report the code lines accurately).consolePanel;
// Skip strong-notification effect for errors without stack trace.// Use this configuration if you wish to ignore errors caused by cross-origin// (usually third-party) scripts where stack traces are not available.consolePanel;
// Add custom logic around the "Disable for this instance" button.// Use this configuration if you wish to disable console-panel and keep it// disabled for future page loads.if localStorage'console-panel-status' !== 'disabled' consolePanel;
consolePanel.disable()
If you wish to deactivate console-panel, run consolePanel.disable()
. It will restore the intercepted functions to their original state.
Browser support
Google Chrome
Microsoft Edge (and Internet Explorer)
Mozilla Firefox
Opera
Limitations / notable behavior
console.clear()
is always intercepted wheneverconsolePanel.enable()
is called.- In Microsoft Edge (EdgeHTML) and Internet Explorer, the console functions are
not intercepted if the browser's native Developer Tools are in activated state
(
window.onerror
can still be intercepted). Also, for these browsers, if the native Developer Tools have been opened once, then the intercepted calls to the console logging function calls are absorbed (rather than intercepted). - During a page load, if
consolePanel.enable(config)
has already been called once, then callingconsolePanel.enable(config_new)
with a different config may not work well for all the cases.
TODO
Alternative solutions you may like
Remote debugging
vConsole
A lightweight, extendable front-end developer tool for mobile web page (https://github.com/Tencent/vConsole)
Firebug Lite
In your HTML file, add the following tags:
References: