chromium/ui/events/cocoa/events_mac_unittest.mm

// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#import <Carbon/Carbon.h>
#import <Cocoa/Cocoa.h>
#include <stdint.h>

#include <memory>
#include <utility>

#include "base/apple/owned_objc.h"
#include "base/apple/scoped_cftyperef.h"
#include "testing/gtest/include/gtest/gtest.h"
#import "ui/base/test/cocoa_helper.h"
#import "ui/events/cocoa/cocoa_event_utils.h"
#include "ui/events/event_constants.h"
#include "ui/events/event_utils.h"
#import "ui/events/test/cocoa_test_event_utils.h"
#include "ui/events/types/event_type.h"
#include "ui/gfx/geometry/point.h"

namespace ui {

namespace {

// Although CGEventFlags is just a typedef to int in 10.10 and earlier headers,
// the 10.11 header makes this a CF_ENUM, but doesn't give an option for "none".
const CGEventFlags kNoEventFlags = static_cast<CGEventFlags>(0);

class EventsMacTest : public CocoaTest {
 public:
  EventsMacTest() = default;

  EventsMacTest(const EventsMacTest&) = delete;
  EventsMacTest& operator=(const EventsMacTest&) = delete;

  gfx::Point Flip(gfx::Point window_location) {
    NSRect window_frame = test_window().frame;
    CGFloat content_height =
        NSHeight([test_window() contentRectForFrameRect:window_frame]);
    window_location.set_y(content_height - window_location.y());
    return window_location;
  }

  // TODO(tapted): Move this to cocoa_test_event_utils. It's not a drop-in
  // replacement because -[NSApp sendEvent:] may route events generated this way
  // differently.
  NSEvent* TestMouseEvent(CGEventType type,
                          const gfx::Point& window_location,
                          CGEventFlags event_flags) {
    // CGEventCreateMouseEvent() ignores the CGMouseButton parameter unless
    // |type| is one of kCGEventOtherMouse{Up,Down,Dragged}. It can be an
    // integer up to 31. However, constants are only supplied up to 2. For now,
    // just assume "other" means the third/center mouse button, and rely on
    // Quartz ignoring it when the type is not "other".
    CGMouseButton other_button = kCGMouseButtonCenter;
    CGPoint screen_point = cocoa_test_event_utils::ScreenPointFromWindow(
        Flip(window_location).ToCGPoint(), test_window());
    base::apple::ScopedCFTypeRef<CGEventRef> mouse(
        CGEventCreateMouseEvent(nullptr, type, screen_point, other_button));
    CGEventSetFlags(mouse.get(), event_flags);
    return cocoa_test_event_utils::AttachWindowToCGEvent(mouse.get(),
                                                         test_window());
  }

  // Creates a scroll event from a "real" mouse wheel (i.e. not a trackpad).
  NSEvent* TestScrollEvent(const gfx::Point& window_location,
                           int32_t delta_x,
                           int32_t delta_y) {
    bool precise = false;
    return cocoa_test_event_utils::TestScrollEvent(
        Flip(window_location).ToCGPoint(), test_window(), delta_x, delta_y,
        precise, NSEventPhaseNone, NSEventPhaseNone);
  }

  // Creates the sequence of events generated by a trackpad scroll.
  // |initial_rest| indicates whether there is a pause before scrolling starts.
  // |delta_y| is the portion to scroll without momentum (fingers on the
  // trackpad). |momentum_delta_y| is the momentum portion. A zero delta skips
  // that phase (if both are zero, the |initial_rest| is cancelled).
  NSArray* TrackpadScrollSequence(bool initial_rest,
                                  int32_t delta_y,
                                  int32_t momentum_delta_y);

 protected:
  const gfx::Point default_location_ = gfx::Point(10, 20);
};

// Trackpad scroll sequences below determined empirically on OS X 10.11 (linking
// to 10.10 SDK), and dumping out with NSLog in -[NSView scrollWheel:]. First
// created using a Magic Trackpad 2 on a MacPro. See the Trackpad* test cases
// below for example event streams.
NSArray* EventsMacTest::TrackpadScrollSequence(bool initial_rest,
                                               int32_t delta_y,
                                               int32_t momentum_delta_y) {
  int32_t delta_x = 0;  // Just test vertical scrolling for now.
  NSMutableArray* events = [NSMutableArray array];

  // Resting part.
  if (initial_rest) {
    // MayBegin always has a zero delta.
    [events addObject:cocoa_test_event_utils::TestScrollEvent(
                          Flip(default_location_).ToCGPoint(), test_window(),
                          delta_x, /*delta_y=*/0, /*has_precise_deltas=*/true,
                          NSEventPhaseMayBegin, NSEventPhaseNone)];
    if (delta_y == 0) {
      // Rest and release: event gets cancelled.
      DCHECK_EQ(0, momentum_delta_y);  // Pretty sure this is impossible.
      [events addObject:cocoa_test_event_utils::TestScrollEvent(
                            Flip(default_location_).ToCGPoint(), test_window(),
                            delta_x, /*delta_y=*/0, /*has_precise_deltas=*/true,
                            NSEventPhaseCancelled, NSEventPhaseNone)];
      return events;
    }
  }

  // With or without a rest, a begin is sent. It can have a non-zero
  // deviceDeltaY but regular deltaY is always 0.
  [events addObject:cocoa_test_event_utils::TestScrollEvent(
                        Flip(default_location_).ToCGPoint(), test_window(),
                        delta_x, /*delta_y=*/0, /*has_precise_deltas=*/true,
                        NSEventPhaseBegan, NSEventPhaseNone)];

  [events addObject:cocoa_test_event_utils::TestScrollEvent(
                        Flip(default_location_).ToCGPoint(), test_window(),
                        delta_x, delta_y,
                        /*has_precise_deltas=*/true, NSEventPhaseChanged,
                        NSEventPhaseNone)];

  // With or without momentum, an end is sent for the non-momentum part.
  [events addObject:cocoa_test_event_utils::TestScrollEvent(
                        Flip(default_location_).ToCGPoint(), test_window(),
                        delta_x, /*delta_y=*/0, /*has_precise_deltas=*/true,
                        NSEventPhaseEnded, NSEventPhaseNone)];

  if (momentum_delta_y == 0)
    return events;

  // Flick part. Basically the same, but with phase and momentumPhase swapped.
  [events addObject:cocoa_test_event_utils::TestScrollEvent(
                        Flip(default_location_).ToCGPoint(), test_window(),
                        delta_x, /*delta_y=*/0, /*has_precise_deltas=*/true,
                        NSEventPhaseNone, NSEventPhaseBegan)];

  [events addObject:cocoa_test_event_utils::TestScrollEvent(
                        Flip(default_location_).ToCGPoint(), test_window(),
                        delta_x, momentum_delta_y, /*has_precise_deltas=*/true,
                        NSEventPhaseNone, NSEventPhaseChanged)];

  [events addObject:cocoa_test_event_utils::TestScrollEvent(
                        Flip(default_location_).ToCGPoint(), test_window(),
                        delta_x, /*delta_y=*/0, /*has_precise_deltas=*/true,
                        NSEventPhaseNone, NSEventPhaseEnded)];
  return events;
}

}  // namespace

TEST_F(EventsMacTest, EventFlagsFromNative) {
  // Left click.
  NSEvent* left =
      cocoa_test_event_utils::MouseEventWithType(NSEventTypeLeftMouseUp, 0);
  EXPECT_EQ(EF_LEFT_MOUSE_BUTTON,
            EventFlagsFromNative(base::apple::OwnedNSEvent(left)));

  // Right click.
  NSEvent* right =
      cocoa_test_event_utils::MouseEventWithType(NSEventTypeRightMouseUp, 0);
  EXPECT_EQ(EF_RIGHT_MOUSE_BUTTON,
            EventFlagsFromNative(base::apple::OwnedNSEvent(right)));

  // Middle click.
  NSEvent* middle =
      cocoa_test_event_utils::MouseEventWithType(NSEventTypeOtherMouseUp, 0);
  EXPECT_EQ(EF_MIDDLE_MOUSE_BUTTON,
            EventFlagsFromNative(base::apple::OwnedNSEvent(middle)));

  // Caps + Left
  NSEvent* caps = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp, NSEventModifierFlagCapsLock);
  EXPECT_EQ(EF_LEFT_MOUSE_BUTTON | EF_CAPS_LOCK_ON,
            EventFlagsFromNative(base::apple::OwnedNSEvent(caps)));

  // Shift + Left
  NSEvent* shift = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp, NSEventModifierFlagShift);
  EXPECT_EQ(EF_LEFT_MOUSE_BUTTON | EF_SHIFT_DOWN,
            EventFlagsFromNative(base::apple::OwnedNSEvent(shift)));

  // Ctrl + Left. Note we map this to a right click on Mac and remove Control.
  NSEvent* ctrl = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp, NSEventModifierFlagControl);
  EXPECT_EQ(EF_RIGHT_MOUSE_BUTTON,
            EventFlagsFromNative(base::apple::OwnedNSEvent(ctrl)));

  // Ctrl + Right. Remains a right click.
  NSEvent* ctrl_right = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeRightMouseUp, NSEventModifierFlagControl);
  EXPECT_EQ(EF_RIGHT_MOUSE_BUTTON | EF_CONTROL_DOWN,
            EventFlagsFromNative(base::apple::OwnedNSEvent(ctrl_right)));

  // Alt + Left
  NSEvent* alt = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp, NSEventModifierFlagOption);
  EXPECT_EQ(EF_LEFT_MOUSE_BUTTON | EF_ALT_DOWN,
            EventFlagsFromNative(base::apple::OwnedNSEvent(alt)));

  // Cmd + Left
  NSEvent* cmd = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp, NSEventModifierFlagCommand);
  EXPECT_EQ(EF_LEFT_MOUSE_BUTTON | EF_COMMAND_DOWN,
            EventFlagsFromNative(base::apple::OwnedNSEvent(cmd)));

  // Shift + Ctrl + Left. Also mapped to a right-click. Control removed.
  NSEvent* shiftctrl = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp,
      NSEventModifierFlagShift | NSEventModifierFlagControl);
  EXPECT_EQ(EF_RIGHT_MOUSE_BUTTON | EF_SHIFT_DOWN,
            EventFlagsFromNative(base::apple::OwnedNSEvent(shiftctrl)));

  // Cmd + Alt + Right
  NSEvent* cmdalt = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseUp,
      NSEventModifierFlagCommand | NSEventModifierFlagOption);
  EXPECT_EQ(EF_LEFT_MOUSE_BUTTON | EF_COMMAND_DOWN | EF_ALT_DOWN,
            EventFlagsFromNative(base::apple::OwnedNSEvent(cmdalt)));

  // Make sure a repeat key-down event gets ui::EF_IS_REPEAT set.
  NSEvent* repeat_key_down = cocoa_test_event_utils::KeyDownEventWithRepeat();
  EXPECT_EQ(ui::EF_IS_REPEAT,
            EventFlagsFromNative(base::apple::OwnedNSEvent(repeat_key_down)));
}

// Tests mouse button presses and mouse wheel events.
TEST_F(EventsMacTest, ButtonEvents) {
  gfx::Point location(5, 10);
  gfx::Vector2d offset;

  NSEvent* event =
      TestMouseEvent(kCGEventLeftMouseDown, location, kNoEventFlags);
  EXPECT_EQ(ui::EventType::kMousePressed,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(ui::EF_LEFT_MOUSE_BUTTON,
            ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));

  event =
      TestMouseEvent(kCGEventOtherMouseDown, location, kCGEventFlagMaskShift);
  EXPECT_EQ(ui::EventType::kMousePressed,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(ui::EF_MIDDLE_MOUSE_BUTTON | ui::EF_SHIFT_DOWN,
            ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));

  event = TestMouseEvent(kCGEventRightMouseUp, location, kNoEventFlags);
  EXPECT_EQ(ui::EventType::kMouseReleased,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(ui::EF_RIGHT_MOUSE_BUTTON,
            ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));

  // Scroll up.
  event = TestScrollEvent(location, 0, 1);
  EXPECT_EQ(ui::EventType::kScroll,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(0, ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));
  offset = ui::GetMouseWheelOffset(base::apple::OwnedNSEvent(event));
  EXPECT_GT(offset.y(), 0);
  EXPECT_EQ(0, offset.x());

  // Scroll down.
  event = TestScrollEvent(location, 0, -1);
  EXPECT_EQ(ui::EventType::kScroll,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(0, ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));
  offset = ui::GetMouseWheelOffset(base::apple::OwnedNSEvent(event));
  EXPECT_LT(offset.y(), 0);
  EXPECT_EQ(0, offset.x());

  // Scroll left.
  event = TestScrollEvent(location, 1, 0);
  EXPECT_EQ(ui::EventType::kScroll,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(0, ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));
  offset = ui::GetMouseWheelOffset(base::apple::OwnedNSEvent(event));
  EXPECT_EQ(0, offset.y());
  EXPECT_GT(offset.x(), 0);

  // Scroll right.
  event = TestScrollEvent(location, -1, 0);
  EXPECT_EQ(ui::EventType::kScroll,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(0, ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));
  offset = ui::GetMouseWheelOffset(base::apple::OwnedNSEvent(event));
  EXPECT_EQ(0, offset.y());
  EXPECT_LT(offset.x(), 0);
}

// Test correct location when the window has a native titlebar.
TEST_F(EventsMacTest, NativeTitlebarEventLocation) {
  gfx::Point location(5, 10);
  NSUInteger style_mask = NSWindowStyleMaskTitled | NSWindowStyleMaskClosable |
                          NSWindowStyleMaskMiniaturizable |
                          NSWindowStyleMaskResizable;

  // First check that the window provided by ui::CocoaTest is how we think.
  DCHECK_EQ(NSWindowStyleMaskBorderless, test_window().styleMask);
  test_window().styleMask = style_mask;
  DCHECK_EQ(style_mask, test_window().styleMask);

  // EventLocationFromNative should behave the same as the ButtonEvents test.
  NSEvent* event =
      TestMouseEvent(kCGEventLeftMouseDown, location, kNoEventFlags);
  EXPECT_EQ(ui::EventType::kMousePressed,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(ui::EF_LEFT_MOUSE_BUTTON,
            ui::EventFlagsFromNative(base::apple::OwnedNSEvent(event)));
  EXPECT_EQ(location, gfx::ToFlooredPoint(ui::EventLocationFromNative(
                          base::apple::OwnedNSEvent(event))));

  // And be explicit, to ensure the test doesn't depend on some property of the
  // test harness. The change to the frame rect could be OS-specific, so set it
  // to a known value.
  const CGFloat kTestHeight = 400;
  NSRect content_rect = NSMakeRect(0, 0, 600, kTestHeight);
  NSRect frame_rect = [test_window() frameRectForContentRect:content_rect];
  [test_window() setFrame:frame_rect display:YES];
  event = [NSEvent mouseEventWithType:NSEventTypeLeftMouseDown
                             location:NSMakePoint(0, 0)  // Bottom-left corner.
                        modifierFlags:0
                            timestamp:0
                         windowNumber:test_window().windowNumber
                              context:nil
                          eventNumber:0
                           clickCount:0
                             pressure:1.0];
  // Bottom-left corner should be flipped.
  EXPECT_EQ(gfx::Point(0, kTestHeight),
            gfx::ToFlooredPoint(
                ui::EventLocationFromNative(base::apple::OwnedNSEvent(event))));

  // Removing the border, and sending the same event should move it down in the
  // toolkit-views coordinate system.
  int height_change = NSHeight(frame_rect) - kTestHeight;
  EXPECT_GT(height_change, 0);
  test_window().styleMask = NSWindowStyleMaskBorderless;
  [test_window() setFrame:frame_rect display:YES];
  EXPECT_EQ(gfx::Point(0, kTestHeight + height_change),
            gfx::ToFlooredPoint(
                ui::EventLocationFromNative(base::apple::OwnedNSEvent(event))));
}

// Test that window-less events preserve location (are in screen coordinates).
TEST_F(EventsMacTest, NoWindowLocation) {
  const CGPoint location = CGPointMake(5, 10);

  base::apple::ScopedCFTypeRef<CGEventRef> mouse(CGEventCreateMouseEvent(
      nullptr, kCGEventMouseMoved, location, kCGMouseButtonLeft));

  NSEvent* event = [NSEvent eventWithCGEvent:mouse.get()];
  EXPECT_FALSE(event.window);
  EXPECT_EQ(gfx::Point(location),
            gfx::ToFlooredPoint(
                ui::EventLocationFromNative(base::apple::OwnedNSEvent(event))));
}

// Testing for ui::EventTypeFromNative() not covered by ButtonEvents.
TEST_F(EventsMacTest, EventTypeFromNative) {
  NSEvent* event =
      cocoa_test_event_utils::KeyEventWithType(NSEventTypeKeyDown, 0);
  EXPECT_EQ(ui::EventType::kKeyPressed,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));

  event = cocoa_test_event_utils::KeyEventWithType(NSEventTypeKeyUp, 0);
  EXPECT_EQ(ui::EventType::kKeyReleased,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));

  event = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeLeftMouseDragged, 0);
  EXPECT_EQ(ui::EventType::kMouseDragged,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  event = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeRightMouseDragged, 0);
  EXPECT_EQ(ui::EventType::kMouseDragged,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  event = cocoa_test_event_utils::MouseEventWithType(
      NSEventTypeOtherMouseDragged, 0);
  EXPECT_EQ(ui::EventType::kMouseDragged,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));

  event = cocoa_test_event_utils::MouseEventWithType(NSEventTypeMouseMoved, 0);
  EXPECT_EQ(ui::EventType::kMouseMoved,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));

  event = cocoa_test_event_utils::EnterEvent();
  EXPECT_EQ(ui::EventType::kMouseEntered,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
  event = cocoa_test_event_utils::ExitEvent();
  EXPECT_EQ(ui::EventType::kMouseExited,
            ui::EventTypeFromNative(base::apple::OwnedNSEvent(event)));
}

// Verify that a mouse wheel scroll event is correctly lacking phase data.
TEST_F(EventsMacTest, MouseWheelScroll) {
  int32_t wheel_delta_y = 2;

  NSEvent* ns_wheel = TestScrollEvent(default_location_, 0, wheel_delta_y);
  EXPECT_FALSE([ns_wheel hasPreciseScrollingDeltas]);
  ui::ScrollEvent wheel((base::apple::OwnedNSEvent(ns_wheel)));
  EXPECT_EQ(ui::EventType::kScroll, wheel.type());

  // Currently wheel events still say two for finger count, but this may change.
  EXPECT_EQ(2, wheel.finger_count());

  // Note the phase is "end" for wheel events, not "none". There is always an
  // "end" when no more events are expected.
  EXPECT_EQ(ui::EventMomentumPhase::END, wheel.momentum_phase());
  EXPECT_EQ(default_location_, wheel.location());

  float pixel_delta_y = wheel_delta_y * ui::kScrollbarPixelsPerCocoaTick;
  EXPECT_EQ(pixel_delta_y, wheel.y_offset_ordinal());
  EXPECT_EQ(0, wheel.x_offset_ordinal());
}

// Test the event flow for a trackpad "rest" that doesn't result in scrolling
// nor momentum. Also check the boring stuff like type, finger count and
// location, which isn't phase-specific.
// Sequence:
// (1) NSEvent: type=ScrollWheel loc=(780,41) time=14909.3 flags=0x100 win=<set>
//     {deviceD,d}elta{X,Y,Z}=0 count:0 phase=MayBegin momentumPhase=None
// (2) NSEvent: type=ScrollWheel loc=(780,41) time=14912.9 flags=0x100 win=<set>
//     {deviceD,d}elta{X,Y,Z}=0 count:0 phase=Cancelled momentumPhase=None.
TEST_F(EventsMacTest, TrackpadRestRelease) {
  NSArray* ns_events = TrackpadScrollSequence(true, 0, 0);
  ASSERT_EQ(2u, ns_events.count);
  EXPECT_TRUE([ns_events[0] hasPreciseScrollingDeltas]);

  ui::ScrollEvent rest((base::apple::OwnedNSEvent(ns_events[0])));
  EXPECT_EQ(ui::EventType::kScroll, rest.type());
  EXPECT_EQ(2, rest.finger_count());
  EXPECT_EQ(ui::EventMomentumPhase::MAY_BEGIN, rest.momentum_phase());
  EXPECT_EQ(0, rest.y_offset_ordinal());
  EXPECT_EQ(default_location_, rest.location());

  ui::ScrollEvent cancel((base::apple::OwnedNSEvent(ns_events[1])));
  EXPECT_EQ(ui::EventType::kScroll, cancel.type());
  EXPECT_EQ(2, cancel.finger_count());
  EXPECT_EQ(ui::EventMomentumPhase::END, cancel.momentum_phase());
  EXPECT_EQ(0, cancel.y_offset_ordinal());
  EXPECT_EQ(default_location_, cancel.location());
}

// Test the event flow for touching the trackpad while "in motion" already, then
// pausing so that a flick is not generated. deltaX and deltaZ are always zero.
// Note, deviceDeltaX may take on an integer value even though deltaX is zero.
// Sequence:
// (1) NSEvent: type=ScrollWheel loc=(780,41) time=15263.2 flags=0x100 win=<set>
//     deltaY=0.000000 deviceDeltaY=1.000000 phase=Began momentumPhase=None
// (n) NSEvent: type=ScrollWheel loc=(780,41) time=15263.2 flags=0x100 win=<set>
//     deltaY=0.400024 deviceDeltaY=3.000000 phase=Changed momentumPhase=None
// (3) NSEvent: type=ScrollWheel loc=(780,41) time=15264.2 flags=0x100 win=<set>
//     deltaY=0.000000 deviceDeltaY=0.000000 phase=Ended momentumPhase=None.
TEST_F(EventsMacTest, TrackpadScrollThenRest) {
  int32_t delta_y = 21;

  NSArray* ns_events = TrackpadScrollSequence(false, delta_y, 0);
  ASSERT_EQ(3u, ns_events.count);

  ui::ScrollEvent begin((base::apple::OwnedNSEvent(ns_events[0])));
  EXPECT_EQ(ui::EventMomentumPhase::MAY_BEGIN, begin.momentum_phase());
  EXPECT_EQ(0, begin.y_offset_ordinal());

  ui::ScrollEvent update((base::apple::OwnedNSEvent(ns_events[1])));
  // There's no momentum yet, so phase is none.
  EXPECT_EQ(ui::EventMomentumPhase::NONE, update.momentum_phase());
  // Note: No pixel conversion for "precise" deltas.
  EXPECT_EQ(delta_y, update.y_offset_ordinal());

  ui::ScrollEvent end((base::apple::OwnedNSEvent(ns_events[2])));
  EXPECT_EQ(ui::EventMomentumPhase::END, end.momentum_phase());
  EXPECT_EQ(0, end.y_offset_ordinal());
}

// Same as the above, but with an initial rest, which is not cancelled. This
// results in multiple MAY_BEGIN phases.
TEST_F(EventsMacTest, TrackpadRestThenScrollThenRest) {
  int32_t delta_y = 21;

  NSArray* ns_events = TrackpadScrollSequence(true, delta_y, 0);
  ASSERT_EQ(4u, ns_events.count);

  ui::ScrollEvent rest((base::apple::OwnedNSEvent(ns_events[0])));
  EXPECT_EQ(ui::EventMomentumPhase::MAY_BEGIN, rest.momentum_phase());
  EXPECT_EQ(0, rest.y_offset_ordinal());

  ui::ScrollEvent begin((base::apple::OwnedNSEvent(ns_events[1])));
  EXPECT_EQ(ui::EventMomentumPhase::MAY_BEGIN, begin.momentum_phase());
  EXPECT_EQ(0, begin.y_offset_ordinal());

  ui::ScrollEvent update((base::apple::OwnedNSEvent(ns_events[2])));
  EXPECT_EQ(ui::EventMomentumPhase::NONE, update.momentum_phase());
  EXPECT_EQ(delta_y, update.y_offset_ordinal());

  ui::ScrollEvent end((base::apple::OwnedNSEvent(ns_events[3])));
  EXPECT_EQ(ui::EventMomentumPhase::END, end.momentum_phase());
  EXPECT_EQ(0, end.y_offset_ordinal());
}

// Test the event flows that lead to momentum, with and without an initial rest.
// Example sequence (no initial rest):
// (1) NSEvent: type=ScrollWheel loc=(780,41) time=15187.5 flags=0x100 win=<set>
//     deltaY=0.000000 deviceDeltaY=1.000000 phase=Began momentumPhase=None
// (n) NSEvent: type=ScrollWheel loc=(780,41) time=15187.5 flags=0x100 win=<set>
//     deltaY=0.500031  deviceDeltaY=4.000000 phase=Changed momentumPhase=None
// (3) NSEvent: type=ScrollWheel loc=(780,41) time=15187.6 flags=0x100 win=<set>
//     deltaY=0.000000 deviceDeltaY=0.000000 phase=Ended momentumPhase=None
// (4) NSEvent: type=ScrollWheel loc=(780,41) time=15187.6 flags=0x100 win=<set>
//     deltaY=0.900055 deviceDeltaY=3.000000 phase=None momentumPhase=Began
// (n) NSEvent: type=ScrollWheel loc=(780,41) time=15187.6 flags=0x100 win=<set>
//     deltaY=0.300018 deviceDeltaY=3.000000 phase=None momentumPhase=Changed
// (6) NSEvent: type=ScrollWheel loc=(780,41) time=15188.0 flags=0x100 win=<set>
//     deltaY=0.000000 deviceDeltaY=0.000000 phase=None momentumPhase=Ended.
TEST_F(EventsMacTest, TrackpadScrollThenFlick) {
  int32_t delta_y = 21;
  int32_t momentum_delta_y = 33;

  NSArray* ns_events = TrackpadScrollSequence(false, delta_y, momentum_delta_y);
  ASSERT_EQ(6u, ns_events.count);

  // Non-momentum part.
  {
    ui::ScrollEvent begin((base::apple::OwnedNSEvent(ns_events[0])));
    EXPECT_EQ(ui::EventMomentumPhase::MAY_BEGIN, begin.momentum_phase());
    EXPECT_EQ(0, begin.y_offset_ordinal());

    ui::ScrollEvent update((base::apple::OwnedNSEvent(ns_events[1])));
    EXPECT_EQ(ui::EventMomentumPhase::NONE, update.momentum_phase());
    EXPECT_EQ(delta_y, update.y_offset_ordinal());

    ui::ScrollEvent end((base::apple::OwnedNSEvent(ns_events[2])));
    // Even though the event stream continues, AppKit doesn't provide a way to
    // know this without peeking at future events. So this "end" mid-stream is
    // unavoidable.
    EXPECT_EQ(ui::EventMomentumPhase::END, end.momentum_phase());
    EXPECT_EQ(0, end.y_offset_ordinal());
  }
  // Momentum part.
  {
    ui::ScrollEvent begin((base::apple::OwnedNSEvent(ns_events[3])));
    // Since a momentum "begin" is really a continuation of the stream, it's
    // currently treated as an update, but the offsets should always be zero.
    EXPECT_EQ(ui::EventMomentumPhase::INERTIAL_UPDATE, begin.momentum_phase());
    EXPECT_EQ(0, begin.y_offset_ordinal());

    ui::ScrollEvent update((base::apple::OwnedNSEvent(ns_events[4])));
    EXPECT_EQ(ui::EventMomentumPhase::INERTIAL_UPDATE, update.momentum_phase());
    EXPECT_EQ(momentum_delta_y, update.y_offset_ordinal());

    ui::ScrollEvent end((base::apple::OwnedNSEvent(ns_events[5])));
    EXPECT_EQ(ui::EventMomentumPhase::END, end.momentum_phase());
    EXPECT_EQ(0, end.y_offset_ordinal());
  }
}

// Check that NSEventTypeFlagsChanged event is translated to key press or
// release event.
TEST_F(EventsMacTest, HandleModifierOnlyKeyEvents) {
  struct {
    const char* description;
    NSEventModifierFlags modifier_flags;
    uint16_t key_code;
    EventType expected_type;
    KeyboardCode expected_key_code;
  } test_cases[] = {
      {"CapsLock pressed", NSEventModifierFlagCapsLock, kVK_CapsLock,
       EventType::kKeyPressed, VKEY_CAPITAL},
      {"CapsLock released", 0, kVK_CapsLock, EventType::kKeyReleased,
       VKEY_CAPITAL},
      {"Shift pressed", NSEventModifierFlagShift, kVK_Shift,
       EventType::kKeyPressed, VKEY_SHIFT},
      {"Shift released", 0, kVK_Shift, EventType::kKeyReleased, VKEY_SHIFT},
      {"Control pressed", NSEventModifierFlagControl, kVK_Control,
       EventType::kKeyPressed, VKEY_CONTROL},
      {"Control released", 0, kVK_Control, EventType::kKeyReleased,
       VKEY_CONTROL},
      {"Option pressed", NSEventModifierFlagOption, kVK_Option,
       EventType::kKeyPressed, VKEY_MENU},
      {"Option released", 0, kVK_Option, EventType::kKeyReleased, VKEY_MENU},
      {"Command pressed", NSEventModifierFlagCommand, kVK_Command,
       EventType::kKeyPressed, VKEY_LWIN},
      {"Command released", 0, kVK_Command, EventType::kKeyReleased, VKEY_LWIN},
      {"Shift pressed with CapsLock on",
       NSEventModifierFlagShift | NSEventModifierFlagCapsLock, kVK_Shift,
       EventType::kKeyPressed, VKEY_SHIFT},
      {"Shift released with CapsLock off", NSEventModifierFlagCapsLock,
       kVK_Shift, EventType::kKeyReleased, VKEY_SHIFT},
  };
  for (const auto& test_case : test_cases) {
    SCOPED_TRACE(::testing::Message() << "While checking case: "
                                      << test_case.description);
    NSEvent* native_event = cocoa_test_event_utils::KeyEventWithModifierOnly(
        test_case.key_code, test_case.modifier_flags);
    std::unique_ptr<ui::Event> event =
        EventFromNative(base::apple::OwnedNSEvent(native_event));
    EXPECT_TRUE(event);
    EXPECT_EQ(test_case.expected_type, event->type());
    EXPECT_EQ(test_case.expected_key_code, event->AsKeyEvent()->key_code());
  }
}

}  // namespace ui