PointerEvent: twist property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2020⁩.

The twist read-only property of the PointerEvent interface represents the clockwise rotation of the pointer (e.g., pen stylus) around its major axis, in degrees.

Value

A long value representing the amount of twist, in degrees, applied to the transducer (pointer). The value is in the range 0 to 359, inclusive. For devices that do not report twist, the value is 0.

Examples

When a pointerdown event is fired, different functions are called depending on the value of the event's twist property.

someElement.addEventListener("pointerdown", (event) => {
  if (event.twist === 0) {
    // No twist
    process_no_twist(event);
  } else {
    // Default
    process_twist(event);
  }
});