Safari for macOS fires the non-standard webkitmouseforcewillbegin event at an Element before firing the initial mousedown event.

This offers the opportunity to tell the system not to trigger any default Force Touch actions if and when the click turns into a Force Touch events.

To instruct macOS not to engage any default Force Touch actions if the user apply enough pressure to activate a Force Touch event, call preventDefault() on the webkitmouseforcewillbegin event object.

webkitmouseforcewillbegin is a proprietary, WebKit-specific event. It is part of the Force Touch events feature.

Syntax

Use the event name in addEventListener():

addEventListener("webkitmouseforcewillbegin", (event) => { })

Alternatively, assign to the event handler property of the interface:

onwebkitmouseforcewillbegin = (event) => { }

Event type

A MouseEvent. Inherits from UIEvent and Event.

Specifications

Not part of any specification. Apple has a description at the Mac Developer Library.

Browser compatibility

See also

• Learn: Introduction to events
• webkitmouseforcedown
• webkitmouseforceup
• webkitmouseforcechanged