DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Mercurial (b6d82b1a6b02)

VCS Links

Line Code
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
/* -*- 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_WindowProxyHolder_h__
#define mozilla_dom_WindowProxyHolder_h__

#include "mozilla/dom/BrowsingContext.h"

struct JSContext;
class JSObject;

namespace JS {
template <typename T>
class MutableHandle;
}  // namespace JS

namespace mozilla {
namespace dom {

/**
 * This class is used for passing arguments and the return value for WebIDL
 * binding code that takes/returns a WindowProxy object and for WebIDL
 * unions/dictionaries that contain a WindowProxy member. It should never
 * contain null; if the value in WebIDL is nullable the binding code will use a
 * Nullable<WindowProxyHolder>.
 */
class WindowProxyHolder {
 public:
  WindowProxyHolder() = default;
  explicit WindowProxyHolder(BrowsingContext* aBC) : mBrowsingContext(aBC) {
    MOZ_ASSERT(mBrowsingContext, "Don't set WindowProxyHolder to null.");
  }
  explicit WindowProxyHolder(already_AddRefed<BrowsingContext>&& aBC)
      : mBrowsingContext(std::move(aBC)) {
    MOZ_ASSERT(mBrowsingContext, "Don't set WindowProxyHolder to null.");
  }
  WindowProxyHolder& operator=(BrowsingContext* aBC) {
    mBrowsingContext = aBC;
    MOZ_ASSERT(mBrowsingContext, "Don't set WindowProxyHolder to null.");
    return *this;
  }
  WindowProxyHolder& operator=(already_AddRefed<BrowsingContext>&& aBC) {
    mBrowsingContext = std::move(aBC);
    MOZ_ASSERT(mBrowsingContext, "Don't set WindowProxyHolder to null.");
    return *this;
  }

  BrowsingContext* get() const {
    MOZ_ASSERT(mBrowsingContext, "WindowProxyHolder hasn't been initialized.");
    return mBrowsingContext;
  }

 private:
  friend void ImplCycleCollectionUnlink(WindowProxyHolder& aProxy);

  RefPtr<BrowsingContext> mBrowsingContext;
};

inline void ImplCycleCollectionTraverse(
    nsCycleCollectionTraversalCallback& aCallback, WindowProxyHolder& aProxy,
    const char* aName, uint32_t aFlags = 0) {
  CycleCollectionNoteChild(aCallback, aProxy.get(), "mBrowsingContext", aFlags);
}

inline void ImplCycleCollectionUnlink(WindowProxyHolder& aProxy) {
  aProxy.mBrowsingContext = nullptr;
}

extern bool GetRemoteOuterWindowProxy(JSContext* aCx, BrowsingContext* aContext,
                                      JS::Handle<JSObject*> aTransplantTo,
                                      JS::MutableHandle<JSObject*> aValue);

}  // namespace dom
}  // namespace mozilla

#endif /* mozilla_dom_WindowProxyHolder_h__ */