summaryrefslogtreecommitdiffstats
path: root/src/core/common/extensions/extensions_client_qt.h
blob: 6574872771282fa64962619133bc295936bbf704 (plain)
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
/****************************************************************************
**
** Copyright (C) 2018 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the QtWebEngine module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 3 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL3 included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 3 requirements
** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
**
** GNU General Public License Usage
** Alternatively, this file may be used under the terms of the GNU
** General Public License version 2.0 or (at your option) the GNU General
** Public license version 3 or any later version approved by the KDE Free
** Qt Foundation. The licenses are as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
** included in the packaging of this file. Please review the following
** information to ensure the GNU General Public License requirements will
** be met: https://www.gnu.org/licenses/gpl-2.0.html and
** https://www.gnu.org/licenses/gpl-3.0.html.
**
** $QT_END_LICENSE$
**
****************************************************************************/

// Portions copyright 2013 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 EXTENSIONS_CLIENT_QT_H
#define EXTENSIONS_CLIENT_QT_H

#include "extensions/common/extensions_client.h"

#include "base/compiler_specific.h"
#include "base/lazy_instance.h"
#include "base/macros.h"
#include "chrome/common/extensions/permissions/chrome_permission_message_provider.h"
#include "extensions/common/features/feature_provider.h"
#include "extensions/common/features/json_feature_provider_source.h"
#include "extensions/common/permissions/extensions_api_permissions.h"
#include "url/gurl.h"

namespace extensions {

// Sets up global state for the extensions system. Should be Set() once in each
// process. This should be implemented by the client of the extensions system.
class ExtensionsClientQt : public ExtensionsClient
{
public:
    ExtensionsClientQt();
    virtual ~ExtensionsClientQt() {}

    // Initializes global state. Not done in the constructor because unit tests
    // can create additional ExtensionsClients because the utility thread runs
    // in-process.
    void Initialize() override;
    void InitializeWebStoreUrls(base::CommandLine *command_line) override;

    // Returns the global PermissionMessageProvider to use to provide permission
    // warning strings.
    const PermissionMessageProvider &GetPermissionMessageProvider() const override;

    // Returns the application name. For example, "Chromium" or "app_shell".
    const std::string GetProductName() override;

    // Takes the list of all hosts and filters out those with special
    // permission strings. Adds the regular hosts to |new_hosts|,
    // and adds any additional permissions to |permissions|.
    // TODO(sashab): Split this function in two: One to filter out ignored host
    // permissions, and one to get permissions for the given hosts.
    void FilterHostPermissions(const URLPatternSet &hosts,
                               URLPatternSet *new_hosts,
                               PermissionIDSet *permissions) const override;

    // Replaces the scripting whitelist with |whitelist|. Used in the renderer;
    // only used for testing in the browser process.
    void SetScriptingWhitelist(const ScriptingWhitelist &whitelist) override;

    // Return the whitelist of extensions that can run content scripts on
    // any origin.
    const ScriptingWhitelist &GetScriptingWhitelist() const override;

    // Get the set of chrome:// hosts that |extension| can run content scripts on.
    URLPatternSet GetPermittedChromeSchemeHosts(const Extension *extension,
                                                const APIPermissionSet &api_permissions) const override;

    // Returns false if content scripts are forbidden from running on |url|.
    bool IsScriptableURL(const GURL &url, std::string *error) const override;

    // Determines if certain fatal extensions errors should be surpressed
    // (i.e., only logged) or allowed (i.e., logged before crashing).
    bool ShouldSuppressFatalErrors() const override;

    // Records that a fatal error was caught and suppressed. It is expected that
    // embedders will only do so if ShouldSuppressFatalErrors at some point
    // returned true.
    void RecordDidSuppressFatalError() override;

    // Returns the base webstore URL prefix.
    const GURL &GetWebstoreBaseURL() const override;

    // Returns the URL to use for update manifest queries.
    const GURL &GetWebstoreUpdateURL() const override;

    // Returns a flag indicating whether or not a given URL is a valid
    // extension blacklist URL.
    bool IsBlacklistUpdateURL(const GURL &url) const override;

    // Returns the set of file paths corresponding to any images within an
    // extension's contents that may be displayed directly within the browser UI
    // or WebUI, such as icons or theme images. This set of paths is used by the
    // extension unpacker to determine which assets should be transcoded safely
    // within the utility sandbox.
    //
    // The default implementation returns the images used as icons for the
    // extension itself, so implementors of ExtensionsClient overriding this may
    // want to call the base class version and then add additional paths to that
    // result.
    std::set<base::FilePath> GetBrowserImagePaths(const Extension *extension) override;
    // Get the LazyInstance for ChromeExtensionsClient.
    static ExtensionsClientQt *GetInstance();

private:
    ScriptingWhitelist scripting_whitelist_;
    const ChromePermissionMessageProvider permission_message_provider_;
    mutable GURL update_url_;
    mutable GURL base_url_;
    DISALLOW_COPY_AND_ASSIGN(ExtensionsClientQt);
};

} // namespace extensions

#endif // EXTENSIONS_CLIENT_QT_H