chromium/base/android/junit/src/org/chromium/base/jank_tracker/JankActivityTrackerTest.java

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

package org.chromium.base.jank_tracker;

import static org.mockito.ArgumentMatchers.any;
import static org.mockito.Mockito.atLeastOnce;
import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;

import android.app.Activity;
import android.view.Window;

import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.mockito.InOrder;
import org.mockito.Mock;
import org.mockito.Mockito;
import org.mockito.MockitoAnnotations;

import org.chromium.base.ActivityState;
import org.chromium.base.ApplicationStatus;
import org.chromium.base.test.BaseRobolectricTestRunner;

/** Tests for JankActivityTracker. */
@RunWith(BaseRobolectricTestRunner.class)
public class JankActivityTrackerTest {
    @Mock private Activity mActivity;

    @Mock private Window mWindow;

    @Mock private FrameMetricsListener mFrameMetricsListener;

    @Mock private JankReportingScheduler mJankReportingScheduler;

    JankActivityTracker createJankActivityTracker(Activity activity) {
        JankActivityTracker tracker =
                new JankActivityTracker(activity, mFrameMetricsListener, mJankReportingScheduler);

        return tracker;
    }

    @Before
    public void setUp() {
        MockitoAnnotations.initMocks(this);

        when(mActivity.getWindow()).thenReturn(mWindow);

        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.CREATED);
    }

    @Test
    public void jankTrackerTest_TestInitialize() {
        JankActivityTracker jankActivityTracker = createJankActivityTracker(mActivity);
        jankActivityTracker.initialize();

        // Verify that we are listening to frame metrics.
        // Initialize also starts listening to activity lifecycle events, but that's harder to
        // verify.
        verify(mWindow).addOnFrameMetricsAvailableListener(any(), any());
    }

    @Test
    public void jankTrackerTest_TestActivityResume() {
        JankActivityTracker jankActivityTracker = createJankActivityTracker(mActivity);
        jankActivityTracker.initialize();

        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.STARTED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.RESUMED);

        // When an activity resumes we start reporting periodic metrics.
        verify(mJankReportingScheduler, atLeastOnce()).startReportingPeriodicMetrics();
        verify(mJankReportingScheduler, never()).stopReportingPeriodicMetrics();

        // When an activity resumes we start recording metrics.
        verify(mFrameMetricsListener, atLeastOnce()).setIsListenerRecording(true);
    }

    @Test
    public void jankTrackerTest_TestActivityPause() {
        JankActivityTracker jankActivityTracker = createJankActivityTracker(mActivity);
        jankActivityTracker.initialize();

        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.STARTED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.RESUMED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.PAUSED);

        // When an activity pauses the reporting task should still be looping.
        verify(mJankReportingScheduler, atLeastOnce()).startReportingPeriodicMetrics();
        verify(mJankReportingScheduler, never()).stopReportingPeriodicMetrics();

        InOrder orderVerifier = Mockito.inOrder(mFrameMetricsListener);

        orderVerifier.verify(mFrameMetricsListener, atLeastOnce()).setIsListenerRecording(true);
        // When an activity pauses we stop recording metrics.
        orderVerifier.verify(mFrameMetricsListener).setIsListenerRecording(false);
    }

    @Test
    public void jankTrackerTest_TestActivityStop() {
        JankActivityTracker jankActivityTracker = createJankActivityTracker(mActivity);
        jankActivityTracker.initialize();

        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.STARTED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.RESUMED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.PAUSED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.STOPPED);

        // When an activity stops we stop reporting periodic metrics.
        InOrder schedulerOrderVerifier = Mockito.inOrder(mJankReportingScheduler);
        schedulerOrderVerifier
                .verify(mJankReportingScheduler, atLeastOnce())
                .startReportingPeriodicMetrics();
        schedulerOrderVerifier.verify(mJankReportingScheduler).stopReportingPeriodicMetrics();
    }

    @Test
    public void jankTrackerTest_TestAttachTrackerOnResumedActivity() {
        // Modify the activity's state before attaching JankActivityTracker.
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.STARTED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.RESUMED);

        JankActivityTracker jankActivityTracker = createJankActivityTracker(mActivity);
        jankActivityTracker.initialize();

        // Verify that JankActivityTracker is running as expected for the Resumed state.
        // Periodic metric reporting should be enabled.
        verify(mJankReportingScheduler).startReportingPeriodicMetrics();
        // Metric recording should be enabled.
        verify(mFrameMetricsListener, atLeastOnce()).setIsListenerRecording(true);
    }

    @Test
    public void jankTrackerTest_TestOutOfOrderStateChange() {
        JankActivityTracker jankActivityTracker = createJankActivityTracker(mActivity);
        jankActivityTracker.initialize();

        // Move the activity from STOPPED to RESUMED without calling STARTED.
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.STOPPED);
        ApplicationStatus.onStateChangeForTesting(mActivity, ActivityState.RESUMED);

        // Verify that JankActivityTracker is running as expected for the Resumed state.
        // Reporting task should be running and looping.
        verify(mJankReportingScheduler).startReportingPeriodicMetrics();
        // Metric recording should be enabled.
        verify(mFrameMetricsListener, atLeastOnce()).setIsListenerRecording(true);
        verify(mFrameMetricsListener, atLeastOnce()).setIsListenerRecording(false);
    }
}