File: action_info.h

package info (click to toggle)
chromium 139.0.7258.127-1
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 6,122,068 kB
  • sloc: cpp: 35,100,771; ansic: 7,163,530; javascript: 4,103,002; python: 1,436,920; asm: 946,517; xml: 746,709; pascal: 187,653; perl: 88,691; sh: 88,436; objc: 79,953; sql: 51,488; cs: 44,583; fortran: 24,137; makefile: 22,147; tcl: 15,277; php: 13,980; yacc: 8,984; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (84 lines) | stat: -rw-r--r-- 2,747 bytes parent folder | download | duplicates (5)
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
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef EXTENSIONS_COMMON_API_EXTENSION_ACTION_ACTION_INFO_H_
#define EXTENSIONS_COMMON_API_EXTENSION_ACTION_ACTION_INFO_H_

#include <memory>
#include <string>

#include "extensions/common/extension.h"
#include "extensions/common/icons/extension_icon_set.h"
#include "extensions/common/icons/extension_icon_variants.h"
#include "url/gurl.h"

namespace extensions {

class Extension;

struct ActionInfo {
  // The types of extension actions.
  enum class Type {
    kAction,
    kBrowser,
    kPage,
  };

  enum class DefaultState {
    kEnabled,
    kDisabled,
  };

  explicit ActionInfo(Type type);
  ActionInfo(const ActionInfo& other);
  ActionInfo(ActionInfo&& other);
  ~ActionInfo();

  // Loads an ActionInfo from the given Dict. Populating
  // `install_warnings` if issues are encountered when parsing the manifest.
  static std::unique_ptr<ActionInfo> Load(
      const Extension* extension,
      Type type,
      const base::Value::Dict& dict,
      std::vector<InstallWarning>* install_warnings,
      std::u16string* error);

  // TODO(jlulejian): Rather than continue to grow this list of static helper
  // methods, move them to a action_helper.h class similar to
  // chrome/browser/extensions/settings_api_helpers.h

  // Returns any action associated with the extension, whether it's specified
  // under the "page_action", "browser_action", or "action" key.
  static const ActionInfo* GetExtensionActionInfo(const Extension* extension);

  // Retrieves the manifest key for the given action `type`.
  static const char* GetManifestKeyForActionType(ActionInfo::Type type);

  // Sets the extension's action.
  static void SetExtensionActionInfo(Extension* extension,
                                     std::unique_ptr<ActionInfo> info);

  // The key this action corresponds to. NOTE: You should only use this if you
  // care about the actual manifest key. Use the other members (like
  // `default_state` for querying general info.
  const Type type;

  // Empty implies the key wasn't present.
  ExtensionIconSet default_icon;
  std::string default_title;
  GURL default_popup_url;

  // Specifies if the action applies to all web pages ("enabled") or
  // only specific pages ("disabled"). Only applies to the "action" key.
  DefaultState default_state;
  // Whether or not this action was synthesized to force visibility.
  bool synthesized;

  // Icon Variants can be defined here in action or at manifest.json top level.
  std::optional<ExtensionIconVariants> icon_variants;
};

}  // namespace extensions

#endif  // EXTENSIONS_COMMON_API_EXTENSION_ACTION_ACTION_INFO_H_