Write about more API changes (and triage 2 commits)

Author: delan

_posts/2026-01-19-december-in-servo.md

@@ -27,10 +27,21 @@ We now use the **system root certificates** by default (@Narfinger, @mrobinson,
 If you don’t want to trust the system root certificates, you can instead continue to use Mozilla’s root certificates with `--pref network_use_webpki_roots`.
 As always, you can also add your own root certificates via [`Opts`](https://doc.servo.org/servo/opts/struct.Opts.html)::[`certificate_path`](https://doc.servo.org/servo/opts/struct.Opts.html#structfield.certificate_path) (`--certificate-path=`).
 
+We have a new [`SiteDataManager`](???) API for managing **localStorage**, **sessionStorage**, and **cookies** (@janvarga, #41236, #41255, #41378, #41523, #41528), and a new [`NetworkManager`](???) API for managing the **cache** (@janvarga, @mrobinson, #41255, #41474, #41386).
+To clear the cache, call [`NetworkManager`](???)::[`clear_cache`](???), and to list cache entries, call [`NetworkManager`](???)::[`cache_entries`](???).
+
+[**Simple dialogs**](https://html.spec.whatwg.org/multipage/#simple-dialogs) – that is alert(), confirm(), and prompt() – are now exposed to embedders via a new [`SimpleDialog`](https://doc.servo.org/servo/enum.SimpleDialog.html) type in [`EmbedderControl`](https://doc.servo.org/servo/webview_delegate/enum.EmbedderControl.html) (@mrobinson, @mukilan, #40982).
+This new interface is harder to misuse, and no longer requires boilerplate for embedders that wish to [ignore simple dialogs](https://html.spec.whatwg.org/multipage/#cannot-show-simple-dialogs).
+
+**Web console messages**, including messages from the [Console API](https://developer.mozilla.org/en-US/docs/Web/API/Console_API), are now accessible via [`ServoDelegate`](https://doc.servo.org/servo/trait.ServoDelegate.html)::[`show_console_message`](https://doc.servo.org/servo/trait.ServoDelegate.html#method.show_console_message) and [`WebViewDelegate`](https://doc.servo.org/servo/trait.WebViewDelegate.html)::[`show_console_message`](https://doc.servo.org/servo/trait.WebViewDelegate.html#method.show_console_message) (@atbrakhi, #41351).
+
 [`Servo`](https://doc.servo.org/servo/struct.Servo.html), the main handle for controlling Servo, is now cloneable for sharing within the same thread (@mukilan, @mrobinson, #41010).
+To shut down Servo, simply [drop](https://doc.rust-lang.org/std/mem/fn.drop.html) the last `Servo` handle or let it go out of scope.
+`Servo`::`start_shutting_down` and `Servo`::`deinit` have been removed (@mukilan, @mrobinson, #41012).
 
 Several interfaces have also been renamed:
 
+- [`Servo`](https://doc.servo.org/servo/struct.Servo.html)::`clear_cookies` is now [`SiteDataManager`](???)::[`clear_cookies`](???) (@janvarga, #41236, #41255)
 - `DebugOpts`::`disable_share_style_cache` is now [`Preferences`](https://doc.servo.org/servo/prefs/struct.Preferences.html)::[`layout_style_sharing_cache_enabled`](https://doc.servo.org/servo/prefs/struct.Preferences.html#structfield.layout_style_sharing_cache_enabled) (@atbrakhi, #40959)
 - The rest of `DebugOpts` has been moved to [`DiagnosticsLogging`](https://doc.servo.org/servo/opts/struct.DiagnosticsLogging.html), and the options have been renamed (@atbrakhi, #40960)
 

commits.txt

@@ -654,7 +654,7 @@ https://github.com/servo/servo/pull/40902	(@Loirooriol, @mrobinson, #40902)	scri
     # caret or selections get correctly updated.
     # Testing: Manually tested that #38989 is not regressing
 +https://github.com/servo/servo/pull/40982	(@mrobinson, @mukilan, #40982)	libservo: Finish the `SimpleDialog` API (#40982)
-    api; new SimpleDialog / AlertDialog / ConfirmDialog / PromptDialog interface, harder to misuse and reduces boilerplate for embedders that want to ignore dialogs
+    ;api; new SimpleDialog / AlertDialog / ConfirmDialog / PromptDialog interface, harder to misuse and reduces boilerplate for embedders that want to ignore dialogs
     # Finish exposing the `SimpleDialog` API in libservo, abstracting away the
     # response senders into structures with methods. In addition, add a
     # default behavior so that embedders do not have to explicitly send a
@@ -922,7 +922,7 @@ https://github.com/servo/servo/pull/41032	(@Narfinger, #41032)	Documentation: Ad
     # messages.
     # Testing: No behavioral change. Existing tests suffice.
 +https://github.com/servo/servo/pull/41012	(@mukilan, @mrobinson, #41012)	libservo: Trigger shutdown internally from `Servo`'s `Drop` impl (#41012)
-    api; Servo::start_shutting_down() and deinit() removed in favour of Drop the last handle
+    ;api; Servo::start_shutting_down() and deinit() removed in favour of Drop the last handle
     # Remove the public API to trigger shutdown and instead trigger the process from `Servo`'s implementation of `Drop`
     # trait.
     # This makes it hard to create issues involving the order of destruction of `Servo` and `WebView`s. It will also
@@ -2463,7 +2463,8 @@ https://github.com/servo/servo/pull/41257	(@mrobinson, #41257)	mach: Allow updat
     # logging in via the web interface, doing this via the API requires an
     # access token.
     # Testing: This change adds a unit test for the regex that matches GitHub Action URLs.
-https://github.com/servo/servo/pull/41236	(@janvarga, #41236)	libservo: Introduce `CookieManager` for embedders (#41236)
++https://github.com/servo/servo/pull/41236	(@janvarga, #41236)	libservo: Introduce `CookieManager` for embedders (#41236)
+    ;api; basis of #41255
     # This PR introduces an initial CookieManager abstraction intended primarily
     # for embedders to inspect and manage cookies.
     # At this stage, only clearing all cookies is supported. Additional
@@ -2780,7 +2781,7 @@ https://github.com/servo/servo/pull/41314	(@mrobinson, #41314)	servoshell: Do no
     # approach has never been adopted. We fall back to longer implicit wait time now.
     # Testing: https://github.com/servo/servo/actions/runs/20264413218
 +https://github.com/servo/servo/pull/41255	(@janvarga, #41255)	libservo: Introduce `SiteDataManager` and `NetworkManager` (#41255)
-    api; new SiteDataManager allowing clearing cache and cookies; old CookieManager renamed to NetworkManager
+    ;api; new SiteDataManager allowing clearing cache and cookies; old CookieManager renamed to NetworkManager
     # This PR introduces an initial `SiteDataManager` abstraction intended
     # primarily for embedders to inspect and manage site data.
     # At this stage, `SiteDataManager` supports clearing network cache and
@@ -3157,7 +3158,7 @@ https://github.com/servo/servo/pull/41014	(@Taym95, #41014)	IndexedDB: Handle er
     # Fixes: #17635.
     # Fixes: #14941.
 +https://github.com/servo/servo/pull/41351	(@atbrakhi, #41351)	Add `ServoDelegate` and `WebViewDelegate` methods for Console API (#41351)
-    api; new show_console_message() method in both ServoDelegate and WebViewDelegate
+    ;api; new show_console_message() method in both ServoDelegate and WebViewDelegate
     # Route console messages through the embedding API instead of printing directly, giving embedders control over
     # console output handling.
     # Testing: Should be covered by exsisting tests
@@ -3568,7 +3569,7 @@ https://github.com/servo/servo/pull/41401	(@yezhizhen, #41401)	servoshell: Prope
     # 3. `cargo build -p servoshell --features "gamepad,webxr,..."` (Gamepad & WebXR Enabled)
     # Fixes: #40897
 +https://github.com/servo/servo/pull/41378	(@janvarga, #41378)	libservo: Add initial `SiteDataManager::site_data` API (#41378)
-    api; new SiteDataManager API for listing sites that are storing data
+    ;api; new SiteDataManager API for listing sites that are storing data
     # This PR adds an initial `site_data` API to `SiteDataManager`, allowing
     # embedders to obtain a unified list of sites that have associated site data.
     # The implementation introduces supporting infrastructure across storage and
@@ -3603,7 +3604,8 @@ https://github.com/servo/servo/pull/41441	(@yezhizhen, #41441)	wpt: Disable prox
 https://github.com/servo/servo/pull/41486	(@leo030303, #41486)	LocalStorage: Add table initialisation for in memory databases (#41486)
     # Fixes #41485
     # Added a unit test.
-https://github.com/servo/servo/pull/41474	(@janvarga, #41474)	libservo: Move network cache management to `NetworkManager` (#41474)
++https://github.com/servo/servo/pull/41474	(@janvarga, #41474)	libservo: Move network cache management to `NetworkManager` (#41474)
+    ;api; NetworkManager::clear_cache (initially added in #41255)
     # This PR moves network cache management out of `SiteDataManager` and into
     # `NetworkManager`, aligning the API with how browser engines conceptually
     # separate network layer state from site scoped data.
@@ -4029,7 +4031,7 @@ https://github.com/servo/servo/pull/41519	(@sagudev, #41519)	script: Use more wr
     # Instead of storing the sizes of the start and end floats separately, we can just use a `LogicalSides1D`.
     # Testing: Not needed, no behavior change
 +https://github.com/servo/servo/pull/41523	(@janvarga, #41523)	libservo: Group site data entries by eTLD+1 and simplify related tests (#41523)
-    api; SiteDataManager (localStorage, sessionStorage, etc) now groups data by eTLD+1 (public suffix list), not just origin.
+    ;api; SiteDataManager (localStorage, sessionStorage, etc) now groups data by eTLD+1 (public suffix list), not just origin.
     # This PR updates `SiteDataManager::site_data` to group entries by eTLD+1
     # instead of origin, matching how site data is typically presented in browser
     # UI and aligning the API with user expectations.
@@ -4070,7 +4072,7 @@ https://github.com/servo/servo/pull/41540	(@jschwe, #41540)	servoshell: ohos: Mo
     # across multiple algorithms.
     # Testing: Refactoring. Existing tests suffice.
 +https://github.com/servo/servo/pull/41528	(@janvarga, #41528)	libservo: Extend `SiteDataManager::site_data` to include cookie sites (#41528)
-    api; SiteDataManager now exposes cookies, not just localStorage and sessionStorage. are supercookies blocked yet?
+    ;api; SiteDataManager now exposes cookies, not just localStorage and sessionStorage. are supercookies blocked yet?
     # Extend `SiteDataManager::site_data` to include sites that have cookies
     # stored by the networking layer.
     # This aligns cookie handling with the grouping model already used for
@@ -4283,7 +4285,7 @@ https://github.com/servo/servo/pull/41520	(@sagudev, #41520)	script: Support new
     # still spawned, see [mach try ohos, with failing build step](https://github.com/servo/servo/actions/runs/20556664058)
     # and [upstream issue](https://github.com/actions/toolkit/issues/581)
 +https://github.com/servo/servo/pull/41386	(@janvarga, @mrobinson, #41386)	libservo: Add initial `NetworkManager::cache_entries` API (#41386)
-    api; NetworkManager method for listing entries in HTTP cache
+    ;api; NetworkManager method for listing entries in HTTP cache
     # Add initial support in `NetworkManager` for listing entries currently stored
     # in the HTTP cache. Each returned entry is identified by its cache key (URL).
     # The necessary support has been added to the net crate to expose cache entry

outline.txt

@@ -7,9 +7,9 @@
       api; see SERVO_DIAGNOSTICS patch
     - DONE https://github.com/servo/servo/pull/41010	(@mukilan, @mrobinson, #41010)	libservo: Make `Servo` an opaque cloneable handle (#41010)
       api; `Servo` is now cloneable to share within a thread
-    - https://github.com/servo/servo/pull/40982	(@mrobinson, @mukilan, #40982)	libservo: Finish the `SimpleDialog` API (#40982)
+    - DONE https://github.com/servo/servo/pull/40982	(@mrobinson, @mukilan, #40982)	libservo: Finish the `SimpleDialog` API (#40982)
       api; new SimpleDialog / AlertDialog / ConfirmDialog / PromptDialog interface, harder to misuse and reduces boilerplate for embedders that want to ignore dialogs
-    - https://github.com/servo/servo/pull/41012	(@mukilan, @mrobinson, #41012)	libservo: Trigger shutdown internally from `Servo`'s `Drop` impl (#41012)
+    - DONE https://github.com/servo/servo/pull/41012	(@mukilan, @mrobinson, #41012)	libservo: Trigger shutdown internally from `Servo`'s `Drop` impl (#41012)
       api; Servo::start_shutting_down() and deinit() removed in favour of Drop the last handle
     - DONE https://github.com/servo/servo/pull/41013	(@atbrakhi, #41013)	config: Add `SERVO_DIAGNOSTICS` environment variable for diagnostic options (#41013)
       api; see SERVO_DIAGNOSTICS patch
@@ -19,19 +19,23 @@
       api; see other root certs change
     - DONE https://github.com/servo/servo/pull/41209	(@Narfinger, #41209)	config: Set the default value of the `network_http_proxy_uri` setting via the `http_proxy` variable (#41209)
       api; respect `http_proxy` environment variable
+    - DONE https://github.com/servo/servo/pull/41236  (@janvarga, #41236) libservo: Introduce `CookieManager` for embedders (#41236)
+      api; basis of #41255
     - DONE https://github.com/servo/servo/pull/41268	(@treeshateorcs, @yezhizhen, #41268)	prefs: Handle uppercase HTTP_PROXY variable (#41268)
       api; respect `HTTP_PROXY` environment variable
-    - https://github.com/servo/servo/pull/41255	(@janvarga, #41255)	libservo: Introduce `SiteDataManager` and `NetworkManager` (#41255)
+    - DONE https://github.com/servo/servo/pull/41255	(@janvarga, #41255)	libservo: Introduce `SiteDataManager` and `NetworkManager` (#41255)
       api; new SiteDataManager allowing clearing cache and cookies; old CookieManager renamed to NetworkManager
-    - https://github.com/servo/servo/pull/41351	(@atbrakhi, #41351)	Add `ServoDelegate` and `WebViewDelegate` methods for Console API (#41351)
+    - DONE https://github.com/servo/servo/pull/41351	(@atbrakhi, #41351)	Add `ServoDelegate` and `WebViewDelegate` methods for Console API (#41351)
       api; new show_console_message() method in both ServoDelegate and WebViewDelegate
-    - https://github.com/servo/servo/pull/41378	(@janvarga, #41378)	libservo: Add initial `SiteDataManager::site_data` API (#41378)
+    - DONE https://github.com/servo/servo/pull/41378	(@janvarga, #41378)	libservo: Add initial `SiteDataManager::site_data` API (#41378)
       api; new SiteDataManager API for listing sites that are storing data
-    - https://github.com/servo/servo/pull/41523	(@janvarga, #41523)	libservo: Group site data entries by eTLD+1 and simplify related tests (#41523)
+    - DONE https://github.com/servo/servo/pull/41474  (@janvarga, #41474) libservo: Move network cache management to `NetworkManager` (#41474)
+      api; NetworkManager::clear_cache (initially added in #41255)
+    - DONE https://github.com/servo/servo/pull/41523	(@janvarga, #41523)	libservo: Group site data entries by eTLD+1 and simplify related tests (#41523)
       api; SiteDataManager (localStorage, sessionStorage, etc) now groups data by eTLD+1 (public suffix list), not just origin.
-    - https://github.com/servo/servo/pull/41528	(@janvarga, #41528)	libservo: Extend `SiteDataManager::site_data` to include cookie sites (#41528)
+    - DONE https://github.com/servo/servo/pull/41528	(@janvarga, #41528)	libservo: Extend `SiteDataManager::site_data` to include cookie sites (#41528)
       api; SiteDataManager now exposes cookies, not just localStorage and sessionStorage. are supercookies blocked yet?
-    - https://github.com/servo/servo/pull/41386	(@janvarga, @mrobinson, #41386)	libservo: Add initial `NetworkManager::cache_entries` API (#41386)
+    - DONE https://github.com/servo/servo/pull/41386	(@janvarga, @mrobinson, #41386)	libservo: Add initial `NetworkManager::cache_entries` API (#41386)
       api; NetworkManager method for listing entries in HTTP cache
 - crash
     - https://github.com/servo/servo/pull/40743	(@mrobinson, #40743)	script: Make a Layout-safe version of `Element::each_custom_state` (#40743)