File: android_app_communication_test_support.h

package info (click to toggle)
chromium 138.0.7204.183-1~deb12u1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm-proposed-updates
  • size: 6,080,960 kB
  • sloc: cpp: 34,937,079; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,954; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,811; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (117 lines) | stat: -rw-r--r-- 4,869 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_PAYMENTS_CONTENT_ANDROID_APP_COMMUNICATION_TEST_SUPPORT_H_
#define COMPONENTS_PAYMENTS_CONTENT_ANDROID_APP_COMMUNICATION_TEST_SUPPORT_H_

#include <memory>
#include <string>
#include <vector>

#include "components/payments/core/android_app_description.h"

namespace content {
class BrowserContext;
}  // namespace content

namespace payments {

// Cross-platform test support for Android payment app communication. On Chrome
// OS, this connects to the Android subsystem.
//
// The test expectations are platform-specific. For example, on Chrome OS,
// expectations are setup in the mock Mojo IPC service.
class AndroidAppCommunicationTestSupport {
 public:
  // The object that initializes the ability to invoke Android apps in tests.
  // For example, on Chrome OS, this object creates a mock Mojo IPC connection
  // for the Android subsystem. This is meant to be placed on the stack, so it
  // can perform clean up in its destructor.
  class ScopedInitialization {
   public:
    ScopedInitialization() = default;
    virtual ~ScopedInitialization() = default;

    ScopedInitialization(const ScopedInitialization& other) = delete;
    ScopedInitialization& operator=(const ScopedInitialization& other) = delete;
  };

  // Defined in platform-specific files.
  static std::unique_ptr<AndroidAppCommunicationTestSupport> Create();

  virtual ~AndroidAppCommunicationTestSupport() = default;

  // Disallow copy and assign.
  AndroidAppCommunicationTestSupport(
      const AndroidAppCommunicationTestSupport& other) = delete;
  AndroidAppCommunicationTestSupport& operator=(
      const AndroidAppCommunicationTestSupport& other) = delete;

  // Whether this platform supports Android apps. Used in tests to determine the
  // expected outcome when attempting to query and invoke Android payment apps.
  virtual bool AreAndroidAppsSupportedOnThisPlatform() const = 0;

  // Creates the object that initializes the ability to invoke Android apps
  // in tests. Places this on the stack, so it can perform clean up in its
  // destructor. It's also useful to have a test case that does not invoke this
  // method, so the code path that handles inability to invoke Android apps is
  // tested.
  virtual std::unique_ptr<ScopedInitialization>
  CreateScopedInitialization() = 0;

  // Sets up the expectation that the test case will not query the list of
  // Android payment apps. This can happen, for example, when there is no
  // ScopedInitialization object in scope.
  virtual void ExpectNoListOfPaymentAppsQuery() = 0;

  // Sets up the expectation that the test case will not query an
  // IS_READY_TO_PAY service.
  virtual void ExpectNoIsReadyToPayQuery() = 0;

  // Sets up the expectation that the test case will not invoke a PAY activity.
  virtual void ExpectNoPaymentAppInvoke() = 0;

  // Sets up the expectation that the test case will query the list of Android
  // payment apps. When that happens, the given list of |apps| will be used for
  // the response.
  virtual void ExpectQueryListOfPaymentAppsAndRespond(
      std::vector<std::unique_ptr<AndroidAppDescription>> apps) = 0;

  // Sets up the expectation that the test case will query an IS_READY_TO_PAY
  // service. When that happens, the service will reply with the given
  // |is_ready_to_pay| answer.
  virtual void ExpectQueryIsReadyToPayAndRespond(bool is_ready_to_pay) = 0;

  // Sets up the expectation that the test case will invoke a PAY activity. When
  // that happens, the activity will reply with the given parameters.
  virtual void ExpectInvokePaymentAppAndRespond(
      bool is_activity_result_ok,
      const std::string& payment_method_identifier,
      const std::string& stringified_details) = 0;

  // Sets up the expectation that the test case will invoke a PAY activity, and
  // then subsequently abort that payment. The invoke callback will be called
  // when the payment is aborted with an error result, and then the abort will
  // be reported as successful.
  virtual void ExpectInvokeAndAbortPaymentApp() = 0;

  // Sets up the expectation that the test case will not abort any payment
  // flows.
  virtual void ExpectNoAbortPaymentApp() = 0;

  // Returns the browser context to use.
  virtual content::BrowserContext* context() = 0;

  // Returns the expected error string when the communication cannot connected
  // to the instance. For Lacros, this string will be different to specify that
  // the connection is failed at the Lacros to Ash connection.
  virtual std::string GetNoInstanceExpectedErrorString() = 0;

 protected:
  AndroidAppCommunicationTestSupport() = default;
};

}  // namespace payments

#endif  // COMPONENTS_PAYMENTS_CONTENT_ANDROID_APP_COMMUNICATION_TEST_SUPPORT_H_