Wikipedia:Reporting JavaScript errors
 | This help page is a how-to guide. It explains concepts or processes used by the Wikipedia community. It is not one of Wikipedia's policies or guidelines, and may reflect varying levels of consensus. |
Info to include in bug reports
When you experience an error with gadgets or user scripts and you want to report the issue at the appropriate page, please include the following information:
- What is the behaviour you're seeing?
- What is the behaviour you're expecting to see?
- How can the incorrect behaviour be reproduced? Describe exactly what you're doing and seeing.
- Confirm that you have tried bypassing your browser cache.
- Make note of the skin that you use, your browser, browser version, and operating system.
- Mention relevant JavaScript errors your browser logged. To do that, open your JavaScript console, and copy the relevant error messages. Error messages usually appear in red.
You are urged to have a look at "How to Report Bugs Effectively" by Simon Tatham for hints on how to report bugs effectively, to make sure the issue you are describing can be resolved as promptly as possible.
How to open your JavaScript console
Where to find your JavaScript console depends on your browser:
| Browser | Windows | Mac |
|---|---|---|
| Chrome | Ctrl+⇧ Shift+J | ⌥ Option+⌘ Command+J |
| Edge (new versions) | Ctrl+⇧ Shift+J | - |
| Firefox | F12 | ⌥ Option+⌘ Command+K |
| Safari | Ctrl+Alt+C | ⌥ Option+⌘ Cmd+C* |
| IE or Edge (legacy versions) | F12 | - |
| Opera | Page menu → Developer Tools → Error Console |
On some browsers, you may have to click on the "Console" tab once the developer tools pane opens up.
[*] In Safari, you might have to enable the Develop menu first in Preferences → Advanced → check "Show develop menu in menu bar". For OSX, use ⌥ Option+⌘ Command+I then hit esc (escape) to open the JavaScript console. Errors will appear in red.
Once you've opened the console...
- Click on the "Console" tab
- Reproduce the error (make the error happen with DevTools Console open)
- Scroll to the bottom of the console and look for log entries in yellow and red. Copy or screenshot these.
- If there is a "triangle" you can press to expand and show more info, do so, and copy/screenshot that info too.[1]
Which one is the error?
Unfortunately there is a lot of junk in the console. Programmers really only need one error message to debug, but the trick is getting the right error message. Here's some examples of useful error messages:
- Uncaught - typically red
- Uncaught DOMException
- Uncaught Error
- Uncaught ReferenceError
- Uncaught SyntaxError
- Uncaught TypeError
- Uncaught (something in all lowercase)[2]
- jQuery exception - typically yellow
- jQuery.Deferred exception
See also
Notes
- ^ This extra info will show the stack trace, which is needed to figure out which user script and what line #.
- ^ MediaWiki API error