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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_EXTENSIONS_EXTENSION_RECORD_API_H_
#define CHROME_BROWSER_EXTENSIONS_EXTENSION_RECORD_API_H_
#pragma once
#include "chrome/browser/extensions/extension_function.h"
#include "base/command_line.h"
#include "base/file_path.h"
#include "base/time.h"
namespace {
const FilePath::CharType kURLErrorsSuffix[] = FILE_PATH_LITERAL(".errors");
const char kErrorsKey[] = "errors";
const char kStatsKey[] = "stats";
};
// ProcessStrategy abstracts the API's starting and waiting on a test
// browser instance. This lets us browser-test the API without actually
// firing up a sub browser instance.
class ProcessStrategy {
public:
// Needed to void build warnings
virtual ~ProcessStrategy();
// Used only in test version to pump the blocking pool queue,
// which doesn't otherwise happen during test.
virtual void PumpBlockingPool() {}
// Start up process with given commandline. Real version does just
// that; test version mocks it up, generating errors or good results,
// as configured.
virtual void RunProcess(const CommandLine& line) = 0;
};
// Production (default) version of ProcessStrategy. See ProcessStrategy
// comments for more info. This subclass actually starts a sub browser
// instance.
class ProductionProcessStrategy : public ProcessStrategy {
public:
virtual void RunProcess(const CommandLine& line) OVERRIDE;
};
// Both page cycler calls (capture and replay) have a great deal in common,
// including the need to build and write a url list file, set the user
// data dir, start a sub-instance of Chrome, and parse a resultant error
// file. This base class encapslates those common elements.
class RunPageCyclerFunction : public AsyncExtensionFunction {
public:
explicit RunPageCyclerFunction(ProcessStrategy* strategy);
virtual ~RunPageCyclerFunction();
// Gather common page cycler parameters and store them, then do blocking
// thread invocation of RunTestBrowser.
virtual bool RunImpl() OVERRIDE;
// Make a CommandLine copy of |original|, removing all switches in
// |to_remove|.
static CommandLine RemoveSwitches(const CommandLine& original,
const std::vector<std::string>& to_remove);
// Return ProcessStrategy, to allow for test versions.
virtual const ProcessStrategy &GetProcessStrategy();
protected:
// Parse the JS parameters, and store them as member data.
virtual bool ParseJSParameters() = 0;
// Do a vanilla test browser run, bracketing it immediately before and
// after with a call of AddSwitches to add special commandline options
// for Capture or Replay, and ReadReplyFiles to do any special post-run
// data collection. Gather any error results into |errors_| and then do a
// BrowserThread call of Finish to return JS values.
virtual void RunTestBrowser();
virtual void AddSwitches(CommandLine* command_line) {}
// The test browser communicates URL errors, performance statistics, and
// possibly other data by posting them to text files. ReadReplyFiles
// collects these data for return to the JS side caller.
virtual void ReadReplyFiles() {}
// Return the values gathered in RunTestBrowser. No common code here; all
// logic is in subclasses.
virtual void Finish() {}
FilePath user_data_dir_;
std::string url_contents_;
std::vector<std::string> errors_;
// Base CommandLine on which to build the test browser CommandLine
CommandLine base_command_line_;
// ProcessStrategy to use for this run.
scoped_ptr<ProcessStrategy> process_strategy_;
};
class CaptureURLsFunction : public RunPageCyclerFunction {
public:
CaptureURLsFunction();
explicit CaptureURLsFunction(ProcessStrategy* strategy);
private:
virtual ~CaptureURLsFunction() {}
// Read the ReplayDetails parameter if it exists.
virtual bool ParseJSParameters() OVERRIDE;
// Add record-mode.
virtual void AddSwitches(CommandLine* command_line) OVERRIDE;
// Return error list.
virtual void Finish() OVERRIDE;
DECLARE_EXTENSION_FUNCTION_NAME("experimental.record.captureURLs");
};
class ReplayURLsFunction : public RunPageCyclerFunction {
public:
ReplayURLsFunction();
explicit ReplayURLsFunction(ProcessStrategy* strategy);
private:
virtual ~ReplayURLsFunction();
// Read the ReplayDetails parameter if it exists.
virtual bool ParseJSParameters() OVERRIDE;
// Add visit-urls-count and load-extension.
virtual void AddSwitches(CommandLine* command_line) OVERRIDE;
// Read stats file.
virtual void ReadReplyFiles() OVERRIDE;
// Return error list, statistical results, and runtime.
virtual void Finish() OVERRIDE;
DECLARE_EXTENSION_FUNCTION_NAME("experimental.record.replayURLs");
// These three data are additional information added to the sub-browser
// commandline.
int repeat_count_;
FilePath extension_path_;
FilePath stats_file_path_;
// This time datum marks the start and end of the sub-browser run.
base::Time timer_;
// These two data are additional information returned to caller.
int run_time_ms_;
std::string stats_;
};
#endif // CHROME_BROWSER_EXTENSIONS_EXTENSION_RECORD_API_H_
|