[webium] Sync initial Toolbar state via frame-specific WebUI property

The WebUI Toolbar startup latency suffers from Mojo pull roundtrips
when requesting the initial navigation controls and icon states during
browser window initialization.

To resolve this, this CL introduces a mechanism to serialize and push
the initial toolbar state browser-side during resource initialization.
We serialize the required initial state into a JSON string and push it
via a frame-specific WebUI property using
`RenderFrameHost::SetWebUIProperty()`. This allows the frontend to
retrieve the initial state synchronously using
`chrome.getVariableValue('initialState')` and parse it during
initialization.

(A) Alternative Approaches

We considered several designs to deliver the initial state:

1.  **Profile-wide `loadTimeData`**: Rejected because profile-wide
    data can leak window-specific state, like navigation button
    status, across different windows on the same profile.
2.  **Frame-specific `loadTimeData` via custom frame data binder and
    `SetTopFrameSpecificLocalizedStrings()`**: Rejected because
    `WebUIDataSource` and its backend are intentionally designed to be
    profile-shared. Attempting to bend it to support frame-specific
    data goes against this design.
3.  **Asynchronous `RenderFrameHost::SetWebUIProperty()`**: Rejected
    because the properties were delivered asynchronously, introducing
    race conditions where the initial state was not guaranteed to be
    available before the frontend TS constructor executed.

(B) Implementation Details

To ensure the properties set by `SetWebUIProperty()` are reliably
delivered to the renderer synchronously on startup before the TS ctor
runs, we update `WebUIExtensionData` to bind its Mojo receiver using
`rf->GetTaskRunner(TaskType::kInternalNavigationAssociated)`.
This binding is conditionally scoped to when
`features::kInitialWebUISurfaceSync` is enabled, avoiding priority
inversion on general WebUI pages.

A new `DependencyProvider` interface is introduced to supply this
controls state, abstracting whether the state comes from the actual
browser window or a default fallback during background prewarming. To
prevent dangling pointers and use-after-free vulnerabilities when views
are torn down or detached while `WebContents` remains alive,
`WebUIToolbarUIDependencyProviderUserData` stores a
`base::WeakPtr<DependencyProvider>` and explicitly removes its
`UserData` in `~WebUIToolbarWebView()`.

In the `chrome/` layer, the controller uses this mechanism inside
`WebUIToolbarUI::WebUIRenderFrameCreated()` to populate and inject the
initial state.

During background Pre-Navigate prewarming, before the actual
`WebUIToolbarWebView` exists and can act as the real dependency
provider, the WebContents UserData is missing. In this case,
`PopulateInitialState()` directly injects default-initialized dict
values, ensuring that the TS ctor can still initialize synchronously
with safe defaults without requiring an auxiliary fallback class. As
soon as the window adopts the prewarmed WebContents, the real window
provider overwrites the fallback via Mojo.

A test-only property `isInitializedSyncForTesting_` is exposed in
TS to verify synchronous initialization on startup.

Bug: 530370659
Change-Id: I8dc92a1420c70657377e47c5dd0c15bbb9191521
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/8049002
Reviewed-by: Thomas Lukaszewicz <tluk@chromium.org>
Reviewed-by: Rakina Zata Amni <rakina@chromium.org>
Commit-Queue: Ming-Ying Chung <mych@chromium.org>
Cr-Commit-Position: refs/heads/main@{#1667690}
12 files changed
tree: a29a3cc72009dda63a5fb849fd2abea95e97ad9a
  1. .agents/
  2. .claude/
  3. .gemini/
  4. .github/
  5. agents/
  6. android_webview/
  7. apps/
  8. ash/
  9. base/
  10. build/
  11. build_overrides/
  12. buildtools/
  13. cc/
  14. chrome/
  15. chromecast/
  16. chromeos/
  17. codelabs/
  18. components/
  19. content/
  20. crypto/
  21. dbus/
  22. device/
  23. docs/
  24. extensions/
  25. fuchsia_web/
  26. gin/
  27. google_apis/
  28. gpu/
  29. headless/
  30. infra/
  31. ios/
  32. ipc/
  33. media/
  34. mojo/
  35. net/
  36. pdf/
  37. printing/
  38. remoting/
  39. rlz/
  40. sandbox/
  41. services/
  42. skia/
  43. sql/
  44. storage/
  45. styleguide/
  46. testing/
  47. third_party/
  48. tools/
  49. ui/
  50. url/
  51. webkit/
  52. .clang-format
  53. .clang-tidy
  54. .clangd
  55. .cursorignore
  56. .geminiignore
  57. .git-blame-ignore-revs
  58. .gitallowed
  59. .gitattributes
  60. .gitignore
  61. .gitmodules
  62. .gn
  63. .mailmap
  64. .rustfmt.toml
  65. .vpython3
  66. .yapfignore
  67. ATL_OWNERS
  68. AUTHORS
  69. BRANCH_FEATURE_OWNERS
  70. BRANCH_OWNERS
  71. BUILD.gn
  72. CODE_OF_CONDUCT.md
  73. codereview.settings
  74. CPPLINT.cfg
  75. CRYPTO_OWNERS
  76. DEPS
  77. DIR_METADATA
  78. LICENSE
  79. LICENSE.chromium_os
  80. OWNERS
  81. package.json
  82. PRESUBMIT.py
  83. PRESUBMIT_test.py
  84. PRESUBMIT_test_mocks.py
  85. README.md
  86. SECURITY_OWNERS
  87. WATCHLISTS
README.md

Logo Chromium

Chromium is an open-source browser project that aims to build a safer, faster, and more stable way for all users to experience the web.

The project's web site is https://www.chromium.org.

To check out the source code locally, don't use git clone! Instead, follow the instructions on how to get the code.

Documentation in the source is rooted in docs/README.md.

Learn how to Get Around the Chromium Source Code Directory Structure.

For historical reasons, there are some small top level directories. Now the guidance is that new top level directories are for product (e.g. Chrome, Android WebView, Ash). Even if these products have multiple executables, the code should be in subdirectories of the product.

If you found a bug, please file it at https://crbug.com/new.