HTML mousemove DOM Event: Reference and Examples

When someone interacts with a webpage, the browser sends events to the relevant JavaScript code. The mousemove event happens when the pointer moves over an element.

When mousemove happens

The pointer moves over an element.

You can listen for it using addEventListener(). That keeps event handling separate from HTML attributes such as onclick and works well with modern code organization.

A small working example

<div id="demo-target" style="padding: 2rem; border: 1px solid">Move your pointer here</div>
<p id="event-status" role="status">Waiting for mousemove...</p>
<script>
    const eventTarget = document.getElementById("demo-target");
    const eventStatus = document.getElementById("event-status");

    if (eventTarget) {
        eventTarget.addEventListener("mousemove", (eventDetails) => {
            eventStatus.textContent = "mousemove event received";
            console.log(eventDetails.type, eventDetails.target);
        });
    }
</script>

Reading the code

The browser listens for mousemove on the relevant target. When the event occurs, the callback receives eventDetails, updates the status message and logs the event name and target in Developer Tools.

Move the mouse across the target and inspect coordinates.

Try it in your browser

Open the page, show the Console panel, and follow this test: Move the mouse across the target and inspect coordinates. Then change one thing in the example and observe whether the event still fires.

Common Beginner Mistakes

• Expecting mousemove to fire without its required user action or browser condition.
• Move the mouse across the target and inspect coordinates.
• Adding repeated event listeners without considering cleanup or unwanted side effects.

Key Takeaways

• mousemove reports the pointer moves over an element.
• addEventListener("mousemove", ...) listens for the event on the appropriate target.
• Move the mouse across the target and inspect coordinates.