summaryrefslogtreecommitdiffstats
path: root/dom/base/MozQueryInterface.h
blob: 1dd3d9bfff6e7596d695f77293c31590672b1bda (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
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* 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/. */

#ifndef mozilla_dom_MozQueryInterface
#define mozilla_dom_MozQueryInterface

/**
 * This class implements an optimized QueryInterface method for
 * XPConnect-wrapped JS objects.
 *
 * For JavaScript callers, it behaves as an ordinary QueryInterface method,
 * returning its `this` object or throwing depending on the interface it was
 * passed.
 *
 * For native XPConnect callers, we bypass JSAPI entirely, and directly check
 * whether the queried interface is in the interfaces list.
 */

#include "mozilla/dom/BindingDeclarations.h"
#include "mozilla/dom/NonRefcountedDOMObject.h"
#include "nsID.h"

namespace mozilla {
class ErrorResult;

namespace dom {

class MozQueryInterface final : public NonRefcountedDOMObject {
 public:
  explicit MozQueryInterface(nsTArray<nsIID>&& aInterfaces)
      : mInterfaces(std::move(aInterfaces)) {}

  bool QueriesTo(const nsIID& aIID) const;

  void LegacyCall(JSContext* cx, JS::Handle<JS::Value> thisv,
                  JS::Handle<JS::Value> aIID,
                  JS::MutableHandle<JS::Value> aResult, ErrorResult& aRv) const;

  nsISupports* GetParentObject() const { return nullptr; }

  bool WrapObject(JSContext* aCx, JS::Handle<JSObject*> aGivenProto,
                  JS::MutableHandle<JSObject*> aReflector);

 private:
  nsTArray<nsIID> mInterfaces;
};

}  // namespace dom
}  // namespace mozilla

#endif  // mozilla_dom_MozQueryInterface