gecko-dev/dom/base/WindowProxyHolder.h

78 lines
2.6 KiB
C++

/* -*- 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::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(RefPtr<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=(RefPtr<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 mozilla::dom
#endif /* mozilla_dom_WindowProxyHolder_h__ */