Mouse Button Test
A guided mouse button test. Follow the steps, press each button inside the box and get a clear result at the end.
Step 1
Left click
Do each step inside this box
How to Use the Mouse Button Test
Instead of clicking everything at once, this test walks you through one button at a time. If your mouse doesn't have a button, just skip it.
- Start the guided test. The first step asks for a left click inside the box.
- Test left and right click. These are the two buttons every mouse needs.
- Try middle and side buttons. Press the wheel, then the back (4) and forward (5) thumb buttons. Skip any you don't have.
- Read your result. You get Normal, Watch or Possible issue, plus what to do next.
What Your Mouse Button Test Result Means
| Result | Meaning |
|---|---|
| Normal | Every button you have works in this browser. |
| Watch | Left and right work, but an optional button was skipped or missing. That can be normal for basic mice, touchpads or remapped buttons. |
| Possible issue | A required button didn't register. Try another browser, USB port or computer before blaming the switch. |
Common Mouse Button Problems This Test Can Check
- Left click does not work: often a worn switch, or ClickLock in system settings.
- Right click does not work: check that buttons aren't swapped for left-handed use.
- Middle click is missing: the wheel click may be remapped in your mouse software.
- Side buttons are not detected: usually remapped to keys or macros, or an old browser.
- One click registers twice: that's chatter. Use the double click test.
How Browser Mouse-Button Detection Works
Browsers number mouse buttons 0 (left), 1 (middle), 2 (right), 3 (back) and 4 (forward). This page listens for those numbers. If your mouse software turns a button into a keystroke, the browser sees a key instead, so the button won't light up here.
What the Results Mean
| What you see | What it means | What to do |
|---|---|---|
| Button lights up once per press | Healthy | Nothing, you're done |
| Two presses for one click | Switch bounce (chatter) | Run the double click test |
| Button doesn't light up | Not reaching the browser | Check remaps, drivers, then hardware |
| Lights up, then lets go while held | Worn switch | Check with the hold test |
What Switch Bounce Actually Is
Inside most mouse buttons is a small metal leaf that snaps against a contact. When it's new, it closes cleanly. As it wears, it can bounce for a split second, and the mouse sees that as two clicks. Mice hide small bounces with a short delay called debounce. When the bounce gets longer than the debounce, you get double-clicks.
Optical switches use a beam of light instead of metal contacts, so they don't bounce. That's why many newer gaming mice use them.
What a Dead Button Looks Like
A dead button never lights up, no matter how hard you press. Before you blame the hardware, check three things: that the button isn't remapped in your mouse software, that a second app isn't grabbing it, and that the mouse works on another computer. If it fails everywhere, the switch or its solder joint has failed.
Side buttons are a special case. They're often remapped to keystrokes or macros. Our side buttons guide walks through all seven fixes.
Testing Side Buttons and the Middle Click
Browsers see buttons 4 and 5 (Back and Forward) just fine, and this page blocks them from navigating away while you test. The middle button (wheel click) is checked too. Press it straight down, without scrolling, so you don't trigger a scroll at the same time.
Extra buttons beyond five, like DPI or sniper buttons, are usually handled inside the mouse and never reach the browser. That's normal and not a fault.
Privacy
Button presses stay in your browser. Nothing is uploaded.
Summary
Click each button, hold each one, and check the side buttons and wheel click. Every button should light once per press and stay lit while held. If not, the guides above will help you fix it.
The Held-State Check
Pressing and releasing quickly only tells half the story. A button can register a quick click but fail to stay pressed when held. That shows up as items dropping when you drag or a held aim button letting go in games. Hold each button down for a few seconds here. It should stay lit the whole time. If it flickers or turns off, the switch is losing contact. Confirm with the hold test for timing details.
Mouse Button Test on Mac, Linux and ChromeOS
The test works the same way on every system. On macOS, right click may be set to a two-finger click or a Ctrl+click on Apple mice. Side buttons work in most browsers on Mac, but some apps ignore them. On Linux, buttons 4 and 5 are sometimes mapped to scroll on older setups, which can confuse things. On ChromeOS, everything works as expected with standard USB and Bluetooth mice.
Buttons Your Browser Can't See
Some mice have extra buttons for DPI, profiles or sniper mode. These are handled by the mouse or its software and usually never reach the browser. If your mouse software lets you map an extra button to a keyboard key, you can test it with the keyboard tester instead.
Test Every Button in 20 Seconds
Press left, right, middle, back and forward, once each. Then hold each for two seconds. That's a complete check.
Related Tests
Next, try the double click test and the scroll wheel test.
Frequently Asked Questions
Which mouse buttons can I test?
Left, right, middle (wheel click) and the two side buttons, 4 and 5.
Is this mouse button test free?
Yes, completely free, with no download.
Can this test mouse buttons 4 and 5?
Yes. The page stops the browser from going back or forward while you test.
Can it detect a broken mouse button?
It shows when a button doesn't register at all. For buttons that double-click or let go early, use the double click and hold tests.
Related Tools
Double Click Test
Catch switch chatter: every gap between clicks in milliseconds, flagged when too short.
Mouse Hold Test
Check that a held button stays down without dropping out.
Scroll Wheel Test
Count wheel ticks up and down, scroll speed and skipped or reversed steps.
Mouse Tester
The all-in-one mouse test: buttons, wheel, chatter and polling rate.