dom/base/ChromeUtils.h

   1 /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* vim: set ts=8 sts=2 et sw=2 tw=80: */
   3 /* This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #ifndef mozilla_dom_ChromeUtils__
   8 #define mozilla_dom_ChromeUtils__
   9
  10 #include "mozilla/AlreadyAddRefed.h"
  11 #include "mozilla/dom/BindingDeclarations.h"
  12 #include "mozilla/dom/ChromeUtilsBinding.h"
  13 #include "mozilla/dom/Exceptions.h"
  14 #include "mozilla/dom/Record.h"
  15 #include "nsDOMNavigationTiming.h"  // for DOMHighResTimeStamp
  16 #include "nsIDOMProcessChild.h"
  17 #include "nsIDOMProcessParent.h"
  18
  19 namespace mozilla {
  20
  21 class ErrorResult;
  22
  23 namespace devtools {
  24 class HeapSnapshot;
  25 }  // namespace devtools
  26
  27 namespace dom {
  28
  29 class ArrayBufferViewOrArrayBuffer;
  30 class BrowsingContext;
  31 class Element;
  32 class IdleRequestCallback;
  33 struct IdleRequestOptions;
  34 struct MediaMetadataInit;
  35 class MozQueryInterface;
  36 class PrecompiledScript;
  37 class Promise;
  38 struct ProcessActorOptions;
  39 struct WindowActorOptions;
  40
  41 class ChromeUtils {
  42  private:
  43   // Implemented in devtools/shared/heapsnapshot/HeapSnapshot.cpp
  44   static void SaveHeapSnapshotShared(GlobalObject& global,
  45                                      const HeapSnapshotBoundaries& boundaries,
  46                                      nsAString& filePath, nsAString& snapshotId,
  47                                      ErrorResult& rv);
  48
  49  public:
  50   // Implemented in devtools/shared/heapsnapshot/HeapSnapshot.cpp
  51   static uint64_t GetObjectNodeId(GlobalObject& global,
  52                                   JS::Handle<JSObject*> aVal);
  53
  54   // Implemented in devtools/shared/heapsnapshot/HeapSnapshot.cpp
  55   static void SaveHeapSnapshot(GlobalObject& global,
  56                                const HeapSnapshotBoundaries& boundaries,
  57                                nsAString& filePath, ErrorResult& rv);
  58
  59   // Implemented in devtools/shared/heapsnapshot/HeapSnapshot.cpp
  60   static void SaveHeapSnapshotGetId(GlobalObject& global,
  61                                     const HeapSnapshotBoundaries& boundaries,
  62                                     nsAString& snapshotId, ErrorResult& rv);
  63
  64   // Implemented in devtools/shared/heapsnapshot/HeapSnapshot.cpp
  65   static already_AddRefed<devtools::HeapSnapshot> ReadHeapSnapshot(
  66       GlobalObject& global, const nsAString& filePath, ErrorResult& rv);
  67
  68   static bool IsDevToolsOpened();
  69   static bool IsDevToolsOpened(GlobalObject& aGlobal);
  70   static void NotifyDevToolsOpened(GlobalObject& aGlobal);
  71   static void NotifyDevToolsClosed(GlobalObject& aGlobal);
  72
  73   static void NondeterministicGetWeakMapKeys(
  74       GlobalObject& aGlobal, JS::Handle<JS::Value> aMap,
  75       JS::MutableHandle<JS::Value> aRetval, ErrorResult& aRv);
  76
  77   static void NondeterministicGetWeakSetKeys(
  78       GlobalObject& aGlobal, JS::Handle<JS::Value> aSet,
  79       JS::MutableHandle<JS::Value> aRetval, ErrorResult& aRv);
  80
  81   static void Base64URLEncode(GlobalObject& aGlobal,
  82                               const ArrayBufferViewOrArrayBuffer& aSource,
  83                               const Base64URLEncodeOptions& aOptions,
  84                               nsACString& aResult, ErrorResult& aRv);
  85
  86   static void Base64URLDecode(GlobalObject& aGlobal, const nsACString& aString,
  87                               const Base64URLDecodeOptions& aOptions,
  88                               JS::MutableHandle<JSObject*> aRetval,
  89                               ErrorResult& aRv);
  90
  91   static void ReleaseAssert(GlobalObject& aGlobal, bool aCondition,
  92                             const nsAString& aMessage);
  93
  94   static void AddProfilerMarker(GlobalObject& aGlobal, const nsACString& aName,
  95                                 const ProfilerMarkerOptionsOrDouble& aOptions,
  96                                 const Optional<nsACString>& text);
  97
  98   static void GetXPCOMErrorName(GlobalObject& aGlobal, uint32_t aErrorCode,
  99                                 nsACString& aRetval);
 100
 101   static void OriginAttributesToSuffix(
 102       GlobalObject& aGlobal, const dom::OriginAttributesDictionary& aAttrs,
 103       nsCString& aSuffix);
 104
 105   static bool OriginAttributesMatchPattern(
 106       dom::GlobalObject& aGlobal, const dom::OriginAttributesDictionary& aAttrs,
 107       const dom::OriginAttributesPatternDictionary& aPattern);
 108
 109   static void CreateOriginAttributesFromOrigin(
 110       dom::GlobalObject& aGlobal, const nsAString& aOrigin,
 111       dom::OriginAttributesDictionary& aAttrs, ErrorResult& aRv);
 112
 113   static void CreateOriginAttributesFromOriginSuffix(
 114       dom::GlobalObject& aGlobal, const nsAString& aSuffix,
 115       dom::OriginAttributesDictionary& aAttrs, ErrorResult& aRv);
 116
 117   static void FillNonDefaultOriginAttributes(
 118       dom::GlobalObject& aGlobal, const dom::OriginAttributesDictionary& aAttrs,
 119       dom::OriginAttributesDictionary& aNewAttrs);
 120
 121   static bool IsOriginAttributesEqual(
 122       dom::GlobalObject& aGlobal, const dom::OriginAttributesDictionary& aA,
 123       const dom::OriginAttributesDictionary& aB);
 124
 125   static bool IsOriginAttributesEqual(
 126       const dom::OriginAttributesDictionary& aA,
 127       const dom::OriginAttributesDictionary& aB);
 128
 129   static bool IsOriginAttributesEqualIgnoringFPD(
 130       const dom::OriginAttributesDictionary& aA,
 131       const dom::OriginAttributesDictionary& aB) {
 132     return aA.mInIsolatedMozBrowser == aB.mInIsolatedMozBrowser &&
 133            aA.mUserContextId == aB.mUserContextId &&
 134            aA.mPrivateBrowsingId == aB.mPrivateBrowsingId;
 135   }
 136
 137   static void GetBaseDomainFromPartitionKey(dom::GlobalObject& aGlobal,
 138                                             const nsAString& aPartitionKey,
 139                                             nsAString& aBaseDomain,
 140                                             ErrorResult& aRv);
 141
 142   static void GetPartitionKeyFromURL(dom::GlobalObject& aGlobal,
 143                                      const nsAString& aURL,
 144                                      nsAString& aPartitionKey,
 145                                      ErrorResult& aRv);
 146
 147   // Implemented in js/xpconnect/loader/ChromeScriptLoader.cpp
 148   static already_AddRefed<Promise> CompileScript(
 149       GlobalObject& aGlobal, const nsAString& aUrl,
 150       const dom::CompileScriptOptionsDictionary& aOptions, ErrorResult& aRv);
 151
 152   static MozQueryInterface* GenerateQI(const GlobalObject& global,
 153                                        const Sequence<JS::Value>& interfaces);
 154
 155   static void WaiveXrays(GlobalObject& aGlobal, JS::Handle<JS::Value> aVal,
 156                          JS::MutableHandle<JS::Value> aRetval,
 157                          ErrorResult& aRv);
 158
 159   static void UnwaiveXrays(GlobalObject& aGlobal, JS::Handle<JS::Value> aVal,
 160                            JS::MutableHandle<JS::Value> aRetval,
 161                            ErrorResult& aRv);
 162
 163   static void GetClassName(GlobalObject& aGlobal, JS::Handle<JSObject*> aObj,
 164                            bool aUnwrap, nsAString& aRetval);
 165
 166   static bool IsDOMObject(GlobalObject& aGlobal, JS::Handle<JSObject*> aObj,
 167                           bool aUnwrap);
 168
 169   static void ShallowClone(GlobalObject& aGlobal, JS::Handle<JSObject*> aObj,
 170                            JS::Handle<JSObject*> aTarget,
 171                            JS::MutableHandle<JSObject*> aRetval,
 172                            ErrorResult& aRv);
 173
 174   static void IdleDispatch(const GlobalObject& global,
 175                            IdleRequestCallback& callback,
 176                            const IdleRequestOptions& options, ErrorResult& aRv);
 177
 178   static void GetRecentJSDevError(GlobalObject& aGlobal,
 179                                   JS::MutableHandle<JS::Value> aRetval,
 180                                   ErrorResult& aRv);
 181
 182   static void ClearRecentJSDevError(GlobalObject& aGlobal);
 183
 184   static void ClearStyleSheetCacheByPrincipal(GlobalObject&,
 185                                               nsIPrincipal* aForPrincipal);
 186
 187   static void ClearStyleSheetCacheByBaseDomain(GlobalObject& aGlobal,
 188                                                const nsACString& aBaseDomain);
 189
 190   static void ClearStyleSheetCache(GlobalObject& aGlobal);
 191
 192   static void SetPerfStatsCollectionMask(GlobalObject& aGlobal, uint64_t aMask);
 193
 194   static already_AddRefed<Promise> CollectPerfStats(GlobalObject& aGlobal,
 195                                                     ErrorResult& aRv);
 196
 197   static already_AddRefed<Promise> RequestProcInfo(GlobalObject& aGlobal,
 198                                                    ErrorResult& aRv);
 199
 200   static bool VsyncEnabled(GlobalObject& aGlobal);
 201
 202   static void Import(const GlobalObject& aGlobal,
 203                      const nsACString& aResourceURI,
 204                      const Optional<JS::Handle<JSObject*>>& aTargetObj,
 205                      JS::MutableHandle<JSObject*> aRetval, ErrorResult& aRv);
 206
 207   static void ImportESModule(const GlobalObject& aGlobal,
 208                              const nsAString& aResourceURI,
 209                              const ImportESModuleOptionsDictionary& aOptions,
 210                              JS::MutableHandle<JSObject*> aRetval,
 211                              ErrorResult& aRv);
 212
 213   static void DefineLazyGetter(const GlobalObject& aGlobal,
 214                                JS::Handle<JSObject*> aTarget,
 215                                JS::Handle<JS::Value> aName,
 216                                JS::Handle<JSObject*> aLambda, ErrorResult& aRv);
 217
 218   static void DefineModuleGetter(const GlobalObject& global,
 219                                  JS::Handle<JSObject*> target,
 220                                  const nsAString& id,
 221                                  const nsAString& resourceURI,
 222                                  ErrorResult& aRv);
 223
 224   static void DefineESModuleGetters(const GlobalObject& global,
 225                                     JS::Handle<JSObject*> target,
 226                                     JS::Handle<JSObject*> modules,
 227                                     ErrorResult& aRv);
 228
 229 #ifdef XP_UNIX
 230   static void GetLibcConstants(const GlobalObject&, LibcConstants& aConsts);
 231 #endif
 232
 233   static void GetCallerLocation(const GlobalObject& global,
 234                                 nsIPrincipal* principal,
 235                                 JS::MutableHandle<JSObject*> aRetval);
 236
 237   static void CreateError(const GlobalObject& global, const nsAString& message,
 238                           JS::Handle<JSObject*> stack,
 239                           JS::MutableHandle<JSObject*> aRetVal,
 240                           ErrorResult& aRv);
 241
 242   static already_AddRefed<Promise> RequestIOActivity(GlobalObject& aGlobal,
 243                                                      ErrorResult& aRv);
 244
 245   static bool HasReportingHeaderForOrigin(GlobalObject& global,
 246                                           const nsAString& aOrigin,
 247                                           ErrorResult& aRv);
 248
 249   static PopupBlockerState GetPopupControlState(GlobalObject& aGlobal);
 250
 251   static double LastExternalProtocolIframeAllowed(GlobalObject& aGlobal);
 252
 253   static void ResetLastExternalProtocolIframeAllowed(GlobalObject& aGlobal);
 254
 255   static void EndWheelTransaction(GlobalObject& aGlobal);
 256
 257   static void RegisterWindowActor(const GlobalObject& aGlobal,
 258                                   const nsACString& aName,
 259                                   const WindowActorOptions& aOptions,
 260                                   ErrorResult& aRv);
 261
 262   static void UnregisterWindowActor(const GlobalObject& aGlobal,
 263                                     const nsACString& aName);
 264
 265   static void RegisterProcessActor(const GlobalObject& aGlobal,
 266                                    const nsACString& aName,
 267                                    const ProcessActorOptions& aOptions,
 268                                    ErrorResult& aRv);
 269
 270   static void UnregisterProcessActor(const GlobalObject& aGlobal,
 271                                      const nsACString& aName);
 272
 273   static bool IsClassifierBlockingErrorCode(GlobalObject& aGlobal,
 274                                             uint32_t aError);
 275
 276   static void PrivateNoteIntentionalCrash(const GlobalObject& aGlobal,
 277                                           ErrorResult& aError);
 278
 279   static nsIDOMProcessChild* GetDomProcessChild(const GlobalObject&);
 280
 281   static void GetAllDOMProcesses(
 282       GlobalObject& aGlobal, nsTArray<RefPtr<nsIDOMProcessParent>>& aParents,
 283       ErrorResult& aRv);
 284
 285   static void ConsumeInteractionData(
 286       GlobalObject& aGlobal, Record<nsString, InteractionData>& aInteractions,
 287       ErrorResult& aRv);
 288
 289   static already_AddRefed<Promise> CollectScrollingData(GlobalObject& aGlobal,
 290                                                         ErrorResult& aRv);
 291
 292   static void GetFormAutofillConfidences(
 293       GlobalObject& aGlobal, const Sequence<OwningNonNull<Element>>& aElements,
 294       nsTArray<FormAutofillConfidences>& aResults, ErrorResult& aRv);
 295
 296   static bool IsDarkBackground(GlobalObject&, Element&);
 297
 298   static double DateNow(GlobalObject&);
 299
 300   static void EnsureJSOracleStarted(GlobalObject&);
 301
 302   static unsigned AliveUtilityProcesses(const GlobalObject&);
 303
 304   static void GetAllPossibleUtilityActorNames(GlobalObject& aGlobal,
 305                                               nsTArray<nsCString>& aNames);
 306
 307   static bool ShouldResistFingerprinting(GlobalObject& aGlobal,
 308                                          JSRFPTarget aTarget);
 309
 310  private:
 311   // Number of DevTools session debugging the current process
 312   static std::atomic<uint32_t> sDevToolsOpenedCount;
 313 };
 314
 315 }  // namespace dom
 316 }  // namespace mozilla
 317
 318 #endif  // mozilla_dom_ChromeUtils__