summaryrefslogtreecommitdiff
path: root/dom/plugins/ipc/PPluginScriptableObject.ipdl
blob: 15d6cc1480f297d0b96dcb2618bdc9b299cb1f4a (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
/* -*- Mode: C++; c-basic-offset: 2; indent-tabs-mode: nil; tab-width: 8 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

include protocol PPluginInstance;
include PluginTypes;

using struct mozilla::void_t from "ipc/IPCMessageUtils.h";
using struct mozilla::null_t from "ipc/IPCMessageUtils.h";

namespace mozilla {
namespace plugins {

union Variant {
  void_t;
  null_t;
  bool;
  int;
  double;
  nsCString;
  nullable PPluginScriptableObject;
};

intr protocol PPluginScriptableObject
{
  manager PPluginInstance;

both:
  async __delete__();

parent:
  intr NPN_Evaluate(nsCString aScript)
    returns (Variant aResult,
             bool aSuccess);

child:
  intr Invalidate();

both:
  // NPClass methods
  intr HasMethod(PluginIdentifier aId)
    returns (bool aHasMethod);

  intr Invoke(PluginIdentifier aId,
             Variant[] aArgs)
    returns (Variant aResult,
             bool aSuccess);

  intr InvokeDefault(Variant[] aArgs)
    returns (Variant aResult,
             bool aSuccess);

  intr HasProperty(PluginIdentifier aId)
    returns (bool aHasProperty);

  intr SetProperty(PluginIdentifier aId,
                  Variant aValue)
    returns (bool aSuccess);

  intr RemoveProperty(PluginIdentifier aId)
    returns (bool aSuccess);

  intr Enumerate()
    returns (PluginIdentifier[] aProperties,
             bool aSuccess);

  intr Construct(Variant[] aArgs)
    returns (Variant aResult,
             bool aSuccess);

  // Objects are initially unprotected, and the Protect and Unprotect functions
  // only affect protocol objects that represent NPObjects created in the same
  // process (rather than protocol objects that are a proxy for an NPObject
  // created in another process). Protocol objects representing local NPObjects
  // are protected after an NPObject has been associated with the protocol
  // object. Sending the protocol object as an argument to the other process
  // temporarily protects the protocol object again for the duration of the call.
  async Protect();
  async Unprotect();

  /**
   * GetProperty is slightly wonky due to the way we support NPObjects that have
   * methods and properties with the same name. When child calls parent we
   * simply return a property. When parent calls child, however, we need to do
   * several checks at once and return all the results simultaneously.
   */
parent:
  intr GetParentProperty(PluginIdentifier aId)
    returns (Variant aResult,
             bool aSuccess);

child:
  intr GetChildProperty(PluginIdentifier aId)
    returns (bool aHasProperty,
             bool aHasMethod,
             Variant aResult,
             bool aSuccess);
};

} // namespace plugins
} // namespace mozilla