Free · Private · No download required

MacBook Keyboard Tester

The free online Apple keyboard tester that instantly checks every key. Test your MacBook, MacBook Pro, Air, or Magic Keyboard for butterfly switch issues, double-typing, and broken keys.

MacBook keyboard layout
N-key rollover test
Issue detection
Key event inspector
Export history (CSV / TXT)
Press any key to start testing
Keys Tested
0 / 104
Working Keys
0
Potential Issues
0
Last Key
—
Active Keys
—
Duration
00:00
Test Progress
0%
Key Press History0
No keys pressed yet
Key Inspector
Last key event properties
Press a key to inspect it

How the keyboard tester works

Every time you press a key, the browser fires a KeyboardEvent. This tool listens for keydown and keyup events and maps each event's event.code — the physical key position on your keyboard — to the corresponding key on the visual layout.

Unlike event.key, which changes based on your OS language settings and modifier state, event.code always refers to the same physical key regardless of what character it produces. This makes it ideal for hardware diagnostics.

The tester tracks every unique key tested, detects simultaneous presses, and monitors for hardware anomalies like chattering (rapid repeat events) or stuck keys (keydown without a matching keyup).

What each color means

Untested
Default key color — this key has not been pressed yet during the current test.
Active (held)
The key is currently being held down. Glows cyan/blue while pressed.
Tested (OK)
The key was pressed and released normally. Shown with a subtle green tint.
Potential Issue
Chattering or stuck behavior detected. Highlighted in amber for investigation.

Built for real keyboard diagnostics

Everything you need to test, inspect, and diagnose your keyboard — without installing anything.

MacBook Keyboard Layout

Accurately represents the MacBook keyboard layout, including Command (⌘), Option (⌥), fn, and Globe keys.

N-Key Rollover Test

Press multiple keys simultaneously and see all of them highlighted at once. Verify that your keyboard correctly reports every key even under heavy use.

Issue Detection

Automatically flags chattering keys (rapid repeat events), stuck keys (keydown without keyup), and other anomalies that indicate hardware problems.

Key Event Inspector

See the raw KeyboardEvent properties for every key: event.key, event.code, location, repeat, and all modifier states. Ideal for developers and power users.

Key Press History

A complete timestamped log of every key event during your test session. Pause, resume, clear, or export as CSV or TXT — all processed locally.

100% Private

The entire keyboard test runs in your browser using native Web APIs. No keystrokes, history, or diagnostic data are ever transmitted to any server.

Why You Need a Dedicated MacBook Keyboard Tester

Apple keyboards are sleek and highly responsive, but they are notorious for hardware issues—especially the generation of MacBook Pro and Air models equipped with butterfly switches. Whether you are buying a used MacBook or your current Apple keyboard feels slightly off, a MacBook keyboard tester allows you to verify that every single switch is registering accurately.

Common Apple Keyboard Issues

If you own an Apple device, you may encounter these specific problems:

  • Double-typing (Chattering) — You press the spacebar or a letter once, but two characters appear on the screen. This is the most common butterfly switch failure.
  • Unresponsive Keys — Debris gets trapped under the incredibly low-profile keycaps, rendering the key completely dead.
  • Sticky Keys — The key presses down but fails to pop back up quickly, or fires a permanent keydown event.

Our Apple keyboard tester automatically monitors for these exact anomalies. If a key stutters or gets stuck, it will immediately light up in amber on the visual layout, giving you concrete proof to take to an Apple Store or Genius Bar.

Testing Magic Keyboards and External Apple Accessories

This tester isn't just for laptops. If you use a wireless Apple Magic Keyboard, you can use this tool to ensure the Bluetooth connection isn't dropping keystrokes or suffering from severe input lag. If you suspect your Magic Keyboard has high Bluetooth delay or inconsistent typing responsiveness, run our millisecond Keyboard Latency Test to benchmark transmission lag and polling jitter.

Unlike generic Windows-focused testers, our MacBook mode renders the correct layout with Command (⌘), Option (⌥), and the fn / Globe keys, so you aren't left guessing which Windows key corresponds to your Apple layout. For full-size keyboards with a 10-key numeric pad or PC mechanical keyboards, you can also use our core Online Keyboard Tester.

How to Use the Free Apple Keyboard Checker

  1. Load this page in Safari, Chrome, or Firefox on your macOS device.
  2. Start typing — Press every key on your keyboard from top to bottom.
  3. Look for Green — Every healthy key will turn green. Pay special attention to your Spacebar, Shift, and Enter keys, which are prone to failure.

The test runs 100% locally in your browser. No keystroke data is ever uploaded, guaranteeing total privacy while you diagnose your Mac.

Apple Keyboard Comparison: Built-in vs. Magic vs. Third-Party

Not all Apple-layout keyboards behave exactly the same. When using a MacBook keyboard tester, it helps to understand the hardware differences between Apple's official keyboards and third-party alternatives:

Keyboard TypeModifier KeysFunction Row (F1-F12)Fn / Globe Key
MacBook Built-inNative ⌘ Cmd & ⌥ OptHardware-controlled media/brightnessHardware Fn / Emoji panel
Apple Magic KeyboardNative ⌘ Cmd & ⌥ OptmacOS-controlled media/brightnessSupported natively
Third-Party (Mac Layout)Often mapped to Windows/AltRequires driver or software configRarely supported natively

Understanding Apple-Specific Keys (Command, Option, Globe)

One of the primary reasons to use a dedicated Apple keyboard tester is to accurately test Mac-specific modifiers. Here is how our tool handles them:

  • Command (⌘) — Registers as the Meta key in web browsers. Some combinations (like ⌘ + W or ⌘ + Q) are intercepted by your browser and may close the window before the tester can highlight the key.
  • Option (⌥) — Registers as the Alt key. Depending on your macOS settings, holding Option while pressing other keys may input special characters instead of triggering standard keydown events.
  • Fn / Globe — In many cases, the Fn or Globe key is processed at the hardware level by the MacBook firmware. Web browsers cannot always detect this key press independently unless it is pressed in combination with an F-key.
  • Function Row (F1-F12) — By default, Apple keyboards use the top row for media and system controls. To test the actual F1-F12 inputs, you must hold the Fn key while pressing them, or change your macOS System Settings to "Use F1, F2, etc. keys as standard function keys."

Browser Limitations: Blocked or Reinterpreted Keys

Because this tool runs in your web browser, certain macOS system shortcuts are blocked from being intercepted by any website. When testing, you may find that the following keys do not highlight:

  • Power / Touch ID — Never detectable by web browsers for security reasons.
  • Mission Control (F3) & Launchpad (F4) — Often intercepted by macOS before the browser sees them.
  • Caps Lock — Registers when pressed, but many browsers handle Caps Lock toggles uniquely, sometimes missing the initial keydown event.

Troubleshooting: "My Key Does Not Highlight"

If you press a key and it does not light up on the screen, follow this diagnostic decision tree to determine if it is a hardware failure or a software block:

  1. Is the key a system shortcut? (e.g., Brightness, Volume, Power) → These cannot be tested in a browser.
  2. Is it a function key (F1-F12)? → Hold the Fn key and try again.
  3. Does the key work in a text document? → If it types a letter in a normal document but not here, check your browser extensions.
  4. Is it completely dead everywhere? → This indicates a hardware failure (stuck switch, debris, or water damage).

For more in-depth solutions to Apple hardware failures, read our guide on how to test MacBook and Apple Magic Keyboards. If you need to test ribbon cables or liquid damage before replacing your laptop keyboard, follow our laptop keyboard pre-repair testing protocol, or test an external PC keyboard using our core online keyboard tester.

Frequently Asked Questions

Common questions about testing Apple Mac and Magic Keyboards.

What is a Macbook keyboard tester?
A Macbook keyboard tester is a free online tool specifically designed to test Apple keyboards. It renders the exact Apple layout with ⌘ Command, ⌥ Option, fn, and Globe keys so you can verify every key on your MacBook Air, MacBook Pro, or Magic Keyboard is working perfectly.
How do I test my MacBook keyboard?
Testing your MacBook keyboard is simple: just open this page and start pressing your keys. Working keys will highlight green on the visual Apple layout. If a key like your spacebar or shift key does not light up, it may be broken or stuck.
Can this tool detect Butterfly keyboard issues?
Yes. Older MacBooks (2015-2019) with butterfly switch keyboards are notorious for double-typing or stuck keys. This tool automatically detects "chattering" (double-typing) and stuck keys, highlighting them in amber so you can definitively prove a hardware fault to Apple Support.
Does this test the fn and Globe keys?
Yes! Our Mac keyboard tester is programmed to capture Apple-specific hardware inputs, including the bottom-left fn (Globe) key, Command (⌘), and Option (⌥).
Do I need to use Safari to test my MacBook?
No. This Apple keyboard tester works flawlessly in Safari, Google Chrome, Firefox, and Edge on macOS. No downloads or extensions are required.

Trademark Notice: MacBook, MacBook Pro, MacBook Air, macOS, iMac, and Magic Keyboard are trademarks of Apple Inc., registered in the U.S. and other countries. Online Keyboard Tester is an independent diagnostic utility and is not affiliated with, authorized by, sponsored by, or endorsed by Apple Inc.