File: code_injection.mojom

package info (click to toggle)
chromium 138.0.7204.183-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,908 kB
  • sloc: cpp: 34,937,088; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; 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,806; 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 (79 lines) | stat: -rw-r--r-- 2,277 bytes parent folder | download | duplicates (6)
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
// Copyright 2021 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

module extensions.mojom;

import "extensions/common/mojom/css_origin.mojom";
import "extensions/common/mojom/execution_world.mojom";
import "third_party/blink/public/mojom/script/script_evaluation_params.mojom";
import "url/mojom/url.mojom";

// A single JS source to execute in the renderer.
struct JSSource {
  // The Javascript code to execute.
  string code;

  // The URL of the script that was injected, if any.
  url.mojom.Url script_url;
};

// A single CSS source to execute in the renderer.
struct CSSSource {
  // The CSS code to insert.
  string code;

  // A generated injection key for the CSS, which can be used to remove it
  // later.
  string? key;
};

// A struct representing a collection of JS code to inject in the renderer.
struct JSInjection {
  // The JS sources to execute.
  array<JSSource> sources;

  // The JS world into which to inject the scripts.
  ExecutionWorld world;

  // An optional world ID. All injections specifying a given world ID will be
  // injected into the same world. All injections omitting a world ID will be
  // injected into a "default" world.
  string? world_id;

  // Whether the caller is interested in the result value. Manifest-declared
  // content scripts and executeScript() calls without a response callback
  // are examples of when this will be `kNoResult`.
  blink.mojom.WantResultOption wants_result;

  // Whether the code to be executed with synthesized user activation.
  blink.mojom.UserActivationOption user_gesture;

  // For scripts that evaluate to promises, whether to wait for the resolution
  // of the resulting promises.
  blink.mojom.PromiseResultOption wait_for_promise;
};

// A struct representing a collection of CSS code to insert in the renderer.
struct CSSInjection {
  enum Operation {
    kAdd,
    kRemove,
  };

  // The CSS sources to insert.
  array<CSSSource> sources;

  // The origin of the CSS.
  CSSOrigin css_origin;

  // The type of operation to perform.
  Operation operation;
};

// A single CodeInjection, which is allowed to contain exactly one of
// CSS and JS.
union CodeInjection {
  CSSInjection css;
  JSInjection js;
};