Bug 1615967 - Move customUserAgent to BrowsingContext. r=nika,remote-protocol-reviewers

Differential Revision: https://phabricator.services.mozilla.com/D63040

--HG--
extra : moz-landing-system : lando

devtools/server/actors/addon/webextension-inspected-window.js

@@ -140,6 +140,10 @@ CustomizedReload.prototype = {
       .getInterface(Ci.nsIWebNavigation);
   },
 
+  get browsingContext() {
+    return this.docShell.browsingContext;
+  },
+
   start() {
     if (!this.waitForReloadCompleted) {
       this.waitForReloadCompleted = new Promise((resolve, reject) => {
@@ -147,7 +151,7 @@ CustomizedReload.prototype = {
         this.rejectReloadCompleted = reject;
 
         if (this.userAgent) {
-          this.docShell.customUserAgent = this.userAgent;
+          this.browsingContext.customUserAgent = this.userAgent;
         }
 
         let reloadFlags = Ci.nsIWebNavigation.LOAD_FLAGS_NONE;
@@ -265,8 +269,11 @@ CustomizedReload.prototype = {
     }
 
     // Reset the customized user agent.
-    if (this.userAgent && this.docShell.customUserAgent == this.userAgent) {
-      this.docShell.customUserAgent = null;
+    if (
+      this.userAgent &&
+      this.browsingContext.customUserAgent == this.userAgent
+    ) {
+      this.browsingContext.customUserAgent = null;
     }
 
     if (error) {

devtools/server/actors/emulation/responsive.js

@@ -316,12 +316,12 @@ const ResponsiveActor = protocol.ActorClassWithSpec(responsiveSpec, {
     if (this._previousUserAgentOverride === undefined) {
       this._previousUserAgentOverride = this.getUserAgentOverride();
     }
-    this.docShell.customUserAgent = userAgent;
+    this.docShell.browsingContext.customUserAgent = userAgent;
     return true;
   },
 
   getUserAgentOverride() {
-    return this.docShell.customUserAgent;
+    return this.docShell.browsingContext.customUserAgent;
   },
 
   clearUserAgentOverride() {

docshell/base/BrowsingContext.cpp

@@ -1346,6 +1346,45 @@ void BrowsingContext::DidSet(FieldIndex<IDX_Muted>) {
   });
 }
 
+void BrowsingContext::SetCustomUserAgent(const nsAString& aUserAgent) {
+  Top()->SetUserAgentOverride(aUserAgent);
+}
+
+void BrowsingContext::DidSet(FieldIndex<IDX_UserAgentOverride>) {
+  MOZ_ASSERT(IsTop());
+
+  PreOrderWalk([&](BrowsingContext* aContext) {
+    nsIDocShell* shell = aContext->GetDocShell();
+    if (shell) {
+      shell->ClearCachedUserAgent();
+    }
+  });
+}
+
+bool BrowsingContext::CanSet(FieldIndex<IDX_UserAgentOverride>,
+                             const nsString& aUserAgent,
+                             ContentParent* aSource) {
+  if (!IsTop()) {
+    return false;
+  }
+
+  if (aSource) {
+    MOZ_ASSERT(XRE_IsParentProcess());
+
+    // Double-check ownership if we aren't the setter.
+    if (!Canonical()->IsOwnedByProcess(aSource->ChildID()) &&
+        aSource->ChildID() != Canonical()->GetInFlightProcessId()) {
+      return false;
+    }
+  } else if (!IsInProcess() && !XRE_IsParentProcess()) {
+    // Don't allow this to be set from content processes that
+    // don't own the BrowsingContext.
+    return false;
+  }
+
+  return true;
+}
+
 bool BrowsingContext::CanSet(FieldIndex<IDX_EmbedderInnerWindowId>,
                              const uint64_t& aValue, ContentParent* aSource) {
   // Generally allow clearing this. We may want to be more precise about this

docshell/base/BrowsingContext.h

@@ -107,7 +107,8 @@ class WindowProxyHolder;
   FIELD(GVInaudibleAutoplayRequestStatus, GVAutoplayRequestStatus)           \
   /* ScreenOrientation-related APIs */                                       \
   FIELD(CurrentOrientationAngle, float)                                      \
-  FIELD(CurrentOrientationType, mozilla::dom::OrientationType)
+  FIELD(CurrentOrientationType, mozilla::dom::OrientationType)               \
+  FIELD(UserAgentOverride, nsString)
 
 // BrowsingContext, in this context, is the cross process replicated
 // environment in which information about documents is stored. In
@@ -466,6 +467,11 @@ class BrowsingContext : public nsISupports, public nsWrapperCache {
                       const WindowPostMessageOptions& aOptions,
                       nsIPrincipal& aSubjectPrincipal, ErrorResult& aError);
 
+  void GetCustomUserAgent(nsString& aUserAgent) {
+    aUserAgent = Top()->GetUserAgentOverride();
+  }
+  void SetCustomUserAgent(const nsAString& aUserAgent);
+
   JSObject* WrapObject(JSContext* aCx);
 
   static JSObject* ReadStructuredClone(JSContext* aCx,
@@ -627,6 +633,10 @@ class BrowsingContext : public nsISupports, public nsWrapperCache {
 
   void DidSet(FieldIndex<IDX_AncestorLoading>);
 
+  void DidSet(FieldIndex<IDX_UserAgentOverride>);
+  bool CanSet(FieldIndex<IDX_UserAgentOverride>, const nsString& aUserAgent,
+              ContentParent* aSource);
+
   template <size_t I, typename T>
   bool CanSet(FieldIndex<I>, const T&, ContentParent*) {
     return true;

docshell/base/nsDocShell.cpp

@@ -2343,14 +2343,7 @@ nsDocShell::NameEquals(const nsAString& aName, bool* aResult) {
 }
 
 NS_IMETHODIMP
-nsDocShell::GetCustomUserAgent(nsAString& aCustomUserAgent) {
-  aCustomUserAgent = mCustomUserAgent;
-  return NS_OK;
-}
-
-NS_IMETHODIMP
-nsDocShell::SetCustomUserAgent(const nsAString& aCustomUserAgent) {
-  mCustomUserAgent = aCustomUserAgent;
+nsDocShell::ClearCachedUserAgent() {
   RefPtr<nsGlobalWindowInner> win =
       mScriptGlobal ? mScriptGlobal->GetCurrentInnerWindowInternal() : nullptr;
   if (win) {
@@ -2360,13 +2353,6 @@ nsDocShell::SetCustomUserAgent(const nsAString& aCustomUserAgent) {
     }
   }
 
-  uint32_t childCount = mChildList.Length();
-  for (uint32_t i = 0; i < childCount; ++i) {
-    nsCOMPtr<nsIDocShell> childShell = do_QueryInterface(ChildAt(i));
-    if (childShell) {
-      childShell->SetCustomUserAgent(aCustomUserAgent);
-    }
-  }
   return NS_OK;
 }
 
@@ -2628,7 +2614,6 @@ nsresult nsDocShell::SetDocLoaderParent(nsDocLoader* aParent) {
   // If parent is another docshell, we inherit all their flags for
   // allowing plugins, scripting etc.
   bool value;
-  nsString customUserAgent;
   nsCOMPtr<nsIDocShell> parentAsDocShell(do_QueryInterface(parent));
 
   if (parentAsDocShell) {
@@ -2663,10 +2648,6 @@ nsresult nsDocShell::SetDocLoaderParent(nsDocLoader* aParent) {
     if (NS_SUCCEEDED(parentAsDocShell->GetIsActive(&value))) {
       SetIsActive(value);
     }
-    if (NS_SUCCEEDED(parentAsDocShell->GetCustomUserAgent(customUserAgent)) &&
-        !customUserAgent.IsEmpty()) {
-      SetCustomUserAgent(customUserAgent);
-    }
     if (NS_FAILED(parentAsDocShell->GetAllowDNSPrefetch(&value))) {
       value = false;
     }

docshell/base/nsDocShell.h

@@ -1093,7 +1093,6 @@ class nsDocShell final : public nsDocLoader,
 
   nsID mHistoryID;
   nsString mTitle;
-  nsString mCustomUserAgent;
   nsCString mOriginalUriString;
   nsWeakPtr mOpener;
   nsTObserverArray<nsWeakPtr> mPrivacyObservers;

docshell/base/nsIDocShell.idl

@@ -178,11 +178,6 @@ interface nsIDocShell : nsIDocShellTreeItem
    */
   attribute EventTarget chromeEventHandler;
 
-  /**
-   * This allows chrome to set a custom User agent on a specific docshell
-   */
-  attribute AString customUserAgent;
-
   /**
    * Whether CSS error reporting is enabled.
    */
@@ -408,6 +403,8 @@ interface nsIDocShell : nsIDocShellTreeItem
    */
   void finishRestore();
 
+  void clearCachedUserAgent();
+
   /* Track whether we're currently restoring a document presentation. */
   readonly attribute boolean restoringDocument;
 

docshell/test/browser/browser_ua_emulation.js

@@ -9,12 +9,12 @@ const URL = "data:text/html;charset=utf-8,<iframe id='test-iframe'></iframe>";
 async function contentTask() {
   let docshell = docShell;
   is(
-    docshell.customUserAgent,
+    docshell.browsingContext.customUserAgent,
     "",
     "There should initially be no customUserAgent"
   );
 
-  docshell.customUserAgent = "foo";
+  docshell.browsingContext.customUserAgent = "foo";
   is(
     content.navigator.userAgent,
     "foo",

dom/base/Navigator.cpp

@@ -254,7 +254,7 @@ void Navigator::GetUserAgent(nsAString& aUserAgent, CallerType aCallerType,
     nsIDocShell* docshell = window->GetDocShell();
     nsString customUserAgent;
     if (docshell) {
-      docshell->GetCustomUserAgent(customUserAgent);
+      docshell->GetBrowsingContext()->GetCustomUserAgent(customUserAgent);
 
       if (!customUserAgent.IsEmpty()) {
         aUserAgent = customUserAgent;

dom/chrome-webidl/BrowsingContext.webidl

@@ -34,6 +34,8 @@ interface BrowsingContext {
 
   readonly attribute WindowProxy? window;
 
+  attribute [TreatNullAs=EmptyString] DOMString customUserAgent;
+
   /**
    * The sandbox flags on the browsing context. These reflect the value of the
    * sandbox attribute of the associated IFRAME or CSP-protectable content, if

mobile/android/chrome/geckoview/GeckoViewSettingsChild.js

@@ -98,7 +98,7 @@ class GeckoViewSettingsChild extends GeckoViewChildModule {
     this._userAgentMode = aMode;
     const docShell = content && GeckoViewUtils.getRootDocShell(content);
     if (docShell) {
-      docShell.customUserAgent = this.userAgent;
+      docShell.browsingContext.customUserAgent = this.userAgent;
     } else {
       warn`Failed to set custom user agent. Doc shell not found`;
     }
@@ -115,7 +115,7 @@ class GeckoViewSettingsChild extends GeckoViewChildModule {
     this._userAgentOverride = aUserAgent;
     const docShell = content && GeckoViewUtils.getRootDocShell(content);
     if (docShell) {
-      docShell.customUserAgent = this.userAgent;
+      docShell.browsingContext.customUserAgent = this.userAgent;
     } else {
       warn`Failed to set custom user agent. Doc shell not found`;
     }

netwerk/ipc/DocumentChannelChild.cpp

@@ -129,10 +129,6 @@ DocumentChannelChild::AsyncOpen(nsIStreamListener* aListener) {
   if (mTiming) {
     args.timing() = Some(mTiming);
   }
-  nsDocShell* docshell = GetDocShell();
-  if (docshell) {
-    docshell->GetCustomUserAgent(args.customUserAgent());
-  }
 
   nsCOMPtr<nsIBrowserChild> iBrowserChild;
   NS_QueryNotificationCallbacks(mCallbacks, mLoadGroup,

netwerk/ipc/DocumentChannelParent.cpp

@@ -43,8 +43,8 @@ bool DocumentChannelParent::Init(BrowserParent* aBrowser,
           aArgs.loadFlags(), aArgs.loadType(), aArgs.cacheKey(),
           aArgs.isActive(), aArgs.isTopLevelDoc(),
           aArgs.hasNonEmptySandboxingFlags(), aArgs.topWindowURI(),
-          aArgs.contentBlockingAllowListPrincipal(), aArgs.customUserAgent(),
-          aArgs.channelId(), aArgs.asyncOpenTime(), aArgs.documentOpenFlags(),
+          aArgs.contentBlockingAllowListPrincipal(), aArgs.channelId(),
+          aArgs.asyncOpenTime(), aArgs.documentOpenFlags(),
           aArgs.pluginsAllowed(), aArgs.timing().refOr(nullptr), &rv)) {
     return SendFailedAsyncOpen(rv);
   }

netwerk/ipc/DocumentLoadListener.cpp

@@ -255,9 +255,9 @@ bool DocumentLoadListener::Open(
     bool aIsActive, bool aIsTopLevelDoc, bool aHasNonEmptySandboxingFlags,
     const Maybe<URIParams>& aTopWindowURI,
     const Maybe<PrincipalInfo>& aContentBlockingAllowListPrincipal,
-    const nsString& aCustomUserAgent, const uint64_t& aChannelId,
-    const TimeStamp& aAsyncOpenTime, const Maybe<uint32_t>& aDocumentOpenFlags,
-    bool aPluginsAllowed, nsDOMNavigationTiming* aTiming, nsresult* aRv) {
+    const uint64_t& aChannelId, const TimeStamp& aAsyncOpenTime,
+    const Maybe<uint32_t>& aDocumentOpenFlags, bool aPluginsAllowed,
+    nsDOMNavigationTiming* aTiming, nsresult* aRv) {
   LOG(("DocumentLoadListener Open [this=%p, uri=%s]", this,
        aLoadState->URI()->GetSpecOrDefault().get()));
 
@@ -285,15 +285,6 @@ bool DocumentLoadListener::Open(
       httpBaseChannel->SetContentBlockingAllowListPrincipal(
           contentBlockingAllowListPrincipal);
     }
-
-    // The content process docshell can specify a custom override
-    // for the user agent value. If we had one, then add it to
-    // the header now.
-    if (!aCustomUserAgent.IsEmpty()) {
-      NS_ConvertUTF16toUTF8 utf8CustomUserAgent(aCustomUserAgent);
-      *aRv = httpBaseChannel->SetRequestHeader(NS_LITERAL_CSTRING("User-Agent"),
-                                               utf8CustomUserAgent, false);
-    }
   }
 
   nsCOMPtr<nsIPrivateBrowsingChannel> privateChannel =

netwerk/ipc/DocumentLoadListener.h

@@ -77,8 +77,7 @@ class DocumentLoadListener : public nsIInterfaceRequestor,
             bool aHasNonEmptySandboxingFlags,
             const Maybe<ipc::URIParams>& aTopWindowURI,
             const Maybe<ipc::PrincipalInfo>& aContentBlockingAllowListPrincipal,
-            const nsString& aCustomUserAgent, const uint64_t& aChannelId,
-            const TimeStamp& aAsyncOpenTime,
+            const uint64_t& aChannelId, const TimeStamp& aAsyncOpenTime,
             const Maybe<uint32_t>& aDocumentOpenFlags, bool aPluginsAllowed,
             nsDOMNavigationTiming* aTiming, nsresult* aRv);
 

netwerk/ipc/NeckoChannelParams.ipdlh

@@ -403,7 +403,6 @@ struct DocumentChannelCreationArgs {
   PrincipalInfo? contentBlockingAllowListPrincipal;
   TimeStamp asyncOpenTime;
   nsString? initiatorType;
-  nsString customUserAgent;
   uint64_t channelId;
   uint32_t loadFlags;
   uint32_t loadType;

netwerk/protocol/http/HttpBaseChannel.cpp

@@ -25,6 +25,7 @@
 #include "mozilla/Services.h"
 #include "mozilla/Telemetry.h"
 #include "mozilla/Tokenizer.h"
+#include "mozilla/dom/BrowsingContext.h"
 #include "mozilla/dom/Performance.h"
 #include "mozilla/dom/PerformanceStorage.h"
 #include "mozilla/net/PartiallySeekableInputStream.h"
@@ -42,6 +43,7 @@
 #include "nsICachingChannel.h"
 #include "nsIChannelEventSink.h"
 #include "nsIConsoleService.h"
+#include "nsIContentPolicy.h"
 #include "nsICookieService.h"
 #include "nsIDOMWindowUtils.h"
 #include "nsIDocShell.h"
@@ -485,35 +487,20 @@ HttpBaseChannel::SetTRRMode(nsIRequest::TRRMode aTRRMode) {
 
 NS_IMETHODIMP
 HttpBaseChannel::SetDocshellUserAgentOverride() {
-  // This sets the docshell specific user agent override
-  nsresult rv;
-  nsCOMPtr<nsILoadContext> loadContext;
-  NS_QueryNotificationCallbacks(this, loadContext);
-  if (!loadContext) {
+  RefPtr<dom::BrowsingContext> bc;
+  MOZ_ALWAYS_SUCCEEDS(mLoadInfo->GetBrowsingContext(getter_AddRefs(bc)));
+  if (!bc) {
     return NS_OK;
   }
 
-  nsCOMPtr<mozIDOMWindowProxy> domWindow;
-  loadContext->GetAssociatedWindow(getter_AddRefs(domWindow));
-  if (!domWindow) {
-    return NS_OK;
-  }
-
-  auto* pDomWindow = nsPIDOMWindowOuter::From(domWindow);
-  nsIDocShell* docshell = pDomWindow->GetDocShell();
-  if (!docshell) {
-    return NS_OK;
-  }
-
-  nsString customUserAgent;
-  docshell->GetCustomUserAgent(customUserAgent);
-  if (customUserAgent.IsEmpty()) {
+  const nsString& customUserAgent = bc->GetUserAgentOverride();
+  if (customUserAgent.IsEmpty() || customUserAgent.IsVoid()) {
     return NS_OK;
   }
 
   NS_ConvertUTF16toUTF8 utf8CustomUserAgent(customUserAgent);
-  rv = SetRequestHeader(NS_LITERAL_CSTRING("User-Agent"), utf8CustomUserAgent,
-                        false);
+  nsresult rv = SetRequestHeader(NS_LITERAL_CSTRING("User-Agent"),
+                                 utf8CustomUserAgent, false);
   if (NS_FAILED(rv)) return rv;
 
   return NS_OK;

remote/domains/content/Emulation.jsm

@@ -43,7 +43,7 @@ class Emulation extends ContentProcessDomain {
   }
 
   _setCustomUserAgent(userAgent) {
-    this.docShell.customUserAgent = userAgent;
+    this.docShell.browsingContext.customUserAgent = userAgent;
   }
 
   _setDPPXOverride(dppx) {