--- layout: default title: API Changelog description: GeckoView API Changelog. nav_exclude: true exclude: true --- {% capture javadoc_uri %}{{ site.url }}{{ site.baseurl}}/javadoc/mozilla-central/org/mozilla/geckoview{% endcapture %} {% capture bugzilla %}https://bugzilla.mozilla.org/show_bug.cgi?id={% endcapture %} # GeckoView API Changelog. ⚠️ breaking change and deprecation notices ## v161 - Added [`Autocomplete.CreditCard.securityCode`][161.1] and [`Autocomplete.CreditCard.Builder.securityCode`][161.2] so the credit card security code (CVV) can be passed to and from the [`Autocomplete.StorageDelegate`][161.3]. ([bug 2085419]({{bugzilla}}2085419)) - Added [`GeckoRuntimeSettings.Builder.proguardUuid`][161.4] and [`GeckoRuntimeSettings.getProguardUuid`][161.5] to set the UUID of the embedding app's R8/ProGuard mapping file. It is recorded as `meta.proguardUuid` in Gecko profiles. ([bug 2064150]({{bugzilla}}2064150)) [161.1]: {{javadoc_uri}}/Autocomplete.CreditCard.html#securityCode [161.2]: {{javadoc_uri}}/Autocomplete.CreditCard.Builder.html#securityCode(java.lang.String) [161.3]: {{javadoc_uri}}/Autocomplete.StorageDelegate.html [161.4]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#proguardUuid(java.lang.String) [161.5]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getProguardUuid() ## v160 - The `content-disposition` header of the [`WebResponse`][65.15] passed to [`ContentDelegate.onExternalResponse`][160.1] now contains a filename validated with the same rules desktop applies when saving a download, instead of the header sent by the server. ([bug 1822968]({{bugzilla}}1822968)) - Added [`GeckoSessionSettings.Builder.pictureInPictureToken`][160.2] so the session created for a picture-in-picture request is opened in the browsing context group and content process of the video it clones. ([bug 2065579]({{bugzilla}}2065579)) - Added experimental [`PictureInPictureController.SessionPictureInPicture.Delegate`][160.3], registered with [`GeckoSession.setPictureInPictureDelegate`][160.4], which is notified via [`onEnterPictureInPicture`][160.5] when Gecko wants a picture-in-picture window opened for a video. Added [`GeckoSession.getSessionPictureInPicture`][160.7], whose [`request`][160.6] asks Gecko for a window for the video the session last started playing. ([bug 2065581]({{bugzilla}}2065581)) - Added experimental [`onExitPictureInPicture`][160.8] so the application is told when the picture-in-picture window it opened should be closed. ([bug 2065581]({{bugzilla}}2065581)) - Added experimental [`setKeepActive`][160.9] so the application can keep a session active while a picture-in-picture window shows one of its videos. ([bug 2065581]({{bugzilla}}2065581)) - ⚠️ Removed `IPProtectionController.SERVICE_STATE_OPTED_OUT`. Gecko does not report an opted-out IP Protection service state. ([bug 2082578]({{bugzilla}}2082578)) - Added implementation of `ScrollCaptureCallback` to [`GeckoView`][70.5]. Now GeckoView apps will support the built-in Android OS functionality for taking scrollable screenshots. ([bug 2053909]({{bugzilla}}2053909)) [160.1]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onExternalResponse(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.WebResponse) [160.2]: {{javadoc_uri}}/GeckoSessionSettings.Builder.html#pictureInPictureToken(java.lang.String) [160.3]: {{javadoc_uri}}/PictureInPictureController.SessionPictureInPicture.Delegate.html [160.4]: {{javadoc_uri}}/GeckoSession.html#setPictureInPictureDelegate(org.mozilla.geckoview.PictureInPictureController.SessionPictureInPicture.Delegate) [160.5]: {{javadoc_uri}}/PictureInPictureController.SessionPictureInPicture.Delegate.html#onEnterPictureInPicture(org.mozilla.geckoview.GeckoSession,java.lang.String) [160.6]: {{javadoc_uri}}/PictureInPictureController.SessionPictureInPicture.html#request() [160.7]: {{javadoc_uri}}/GeckoSession.html#getSessionPictureInPicture() [160.8]: {{javadoc_uri}}/PictureInPictureController.SessionPictureInPicture.Delegate.html#onExitPictureInPicture(org.mozilla.geckoview.GeckoSession) [160.9]: {{javadoc_uri}}/PictureInPictureController.SessionPictureInPicture.html#setKeepActive(boolean) ## v157 - Added [`GeckoSession.getPdfViewerEditor`][157.1] and [`PdfViewerController.SessionEditor.addSignature`][157.2] to place a signature on the PDF the session is displaying. The PDF viewer side is a stub until bug 2069045. ([bug 2069043]({{bugzilla}}2069043)) - Added [`GeckoView.captureFullPage()`][157.3] and [`GeckoDisplay.captureFullPage`][157.4] to take screenshot of the full web page. Returns a [`GeckoResult`][65.25] that completes to a [`Bitmap`][67.17] containing a full scrollable screenshot of a web page. [157.1]: {{javadoc_uri}}/GeckoSession.html#getPdfViewerEditor() [157.2]: {{javadoc_uri}}/PdfViewerController.SessionEditor.html#addSignature(java.lang.String) [157.3]: {{javadoc_uri}}/GeckoView.html#captureFullPage() [157.4]: {{javadoc_uri}}/GeckoDisplay.html#capturePixels() ## v156 - Updated [`GeckoSession.saveAsPdf`][156.1] to identify if the currently displayed browser item is a PDF JS page, if so, then save using PDF JS machinery. Otherwise, save the PDF through the Gecko print framework. ([bug 2064162]({{bugzilla}}2064162)) - ⚠️ Added [`ContentParams.useSimpleText`][156.2] to request plain prose from [`SessionPageExtractor.getPageContent`][156.3] instead of markdown-annotated text. This adds a parameter to the [`ContentParams`][156.4] constructor. - ⚠️ Added [`PageMetadata.isGated`][156.5] to report whether a page declares its content to be gated, for example behind a paywall or a registration wall. This adds a parameter to the [`PageMetadata`][156.6] constructor. [156.1]: {{javadoc_uri}}/GeckoSession.html#saveAsPdf() [156.2]: {{javadoc_uri}}/PageExtractionController.ContentParams.html#useSimpleText [156.3]: {{javadoc_uri}}/PageExtractionController.SessionPageExtractor.html#getPageContent(org.mozilla.geckoview.PageExtractionController.ContentParams) [156.4]: {{javadoc_uri}}/PageExtractionController.ContentParams.html#ContentParams(boolean,boolean) [156.5]: {{javadoc_uri}}/PageExtractionController.PageMetadata.html#isGated [156.6]: {{javadoc_uri}}/PageExtractionController.PageMetadata.html#PageMetadata(java.lang.String[],int,java.lang.String,boolean,boolean) ## v155 - Added [`WebRequestError.ERROR_LOCAL_NETWORK_ACCESS_DENIED`][155.4] to indicate that a load failed because the user denied the local network access permission on Android 17+. - Added the [`IPProxyException.ERROR_CATASTROPHIC`][155.1] and [`IPProxyException.ERROR_VPN_UNAVAILABLE`][155.2] error codes for the [`IPProtectioController.activate`][155.3]. [155.1]: {{javadoc_uri}}/IPProtectionController.IPProxyException.html#ERROR_CATASTROPHIC [155.2]: {{javadoc_uri}}/IPProtectionController.IPProxyException.html#ERROR_VPN_UNAVAILABLE [155.3]: {{javadoc_uri}}/IPProtectionController.html#activate(boolean,boolean,java.lang.String) [155.4]: {{javadoc_uri}}/WebRequestError.html#ERROR_LOCAL_NETWORK_ACCESS_DENIED ## v154 - Added [`Autofill.Node.getDatalist`][154.1] to expose predefined values by [`datalist`][154.2] elements for input fields. - Added experimental [`ContentPermission.notifyShown`][154.3] so embedders can signal that a permission prompt UI has been displayed to the user, enabling per-prompt telemetry on the Gecko side (e.g. for local network access). ([bug 2009145]({{bugzilla}}2009145)) - Added [`IPProtectionController.refreshUsage`][154.4] to request a refresh of proxy usage information, delivered asynchronously via [`Delegate#onUsageChanged`][154.5]. ([bug 2042799]({{bugzilla}}2042799)) - Added [`IPProtectionController.getCountryList`][154.6] and [`IPProtectionController.Country`][154.7] to request the list of countries available in the proxy serverlist, delivered asynchronously via [`Delegate#onCountryListChanged`][154.8] whenever the list changes. - Added [`IPProtectionController.activate(boolean, boolean, String)`][154.9] to activate the proxy with explicit user-action, private-browsing, and country options. - ⚠️ Made [`ScrollPositionUpdate`][154.10] immutable: its fields are now `final` and instances are constructed via `ScrollPositionUpdate(float, float, float, int)` instead of the previous no-argument constructor with mutable fields. ([bug 1994863]({{bugzilla}}1994863)) - Added [`GeckoSession.getBrokenSiteReport`][154.11] that returns a `GeckoResult` containing information for a broken site report. ([bug 2049050]({{bugzilla}}2049050)). - Changed [`GeckoSession.setHistoryDelegate`][154.12], [`setContentBlockingDelegate`][154.13], [`setMediaDelegate`][154.14], [`setMediaSessionDelegate`][154.15], [`setTranslationsSessionDelegate`][154.16], [`setPrintDelegate`][154.17], and [`setExperimentDelegate`][154.18] from `@AnyThread` to `@UiThread`, reflecting that they must be called on the UI thread. - Added [`MediaSession.notifySystemAudioFocusChange`][154.19] so embedders can route a system audio-focus change to the tab's W3C Audio Session interrupt, suspending and resuming the tab's audible media elements, Web Audio, and Web Speech. ([bug 2048732]({{bugzilla}}2048732)) - Added [`GeckoSession.sendGleanBrokenSiteReport`][154.20] which sends a broken site report using Glean. ([bug 2054543]({{bugzilla}}2054543)). - Added [`GeckoSession.HistoryDelegate.hasVisitedHostSince`][154.21] so embedders can report whether a host was visited within a time window, used to derive first-daily-load pageload telemetry. ([bug 2058980]({{bugzilla}}2058980)) - Added experimental [`GeckoRuntimeSettings.setIpProtectionAuthProvider`][154.22] and [`getIpProtectionAuthProvider`][154.23] to select the IP Protection authentication provider (`"fxa"` or `"gpi"`) on Android. ([bug 2054901]({{bugzilla}}2054901)) - ⚠️ Removed the Cookie Banner Handling API. The underlying Gecko feature no longer exists and there is no replacement. The following members were removed: `ContentBlocking.CookieBannerMode` and `ContentBlocking.CBCookieBannerMode`; `ContentBlocking.Settings.setCookieBannerMode`, `getCookieBannerMode`, `setCookieBannerModePrivateBrowsing`, `getCookieBannerModePrivateBrowsing`, `setCookieBannerDetectOnlyMode`, `getCookieBannerDetectOnlyMode`, `setCookieBannerGlobalRulesEnabled`, `getCookieBannerGlobalRulesEnabled`, `setCookieBannerGlobalRulesSubFramesEnabled` and `getCookieBannerGlobalRulesSubFramesEnabled`; `ContentBlocking.Settings.Builder.cookieBannerHandlingMode`, `cookieBannerHandlingModePrivateBrowsing`, `cookieBannerHandlingDetectOnlyMode`, `cookieBannerGlobalRulesEnabled` and `cookieBannerGlobalRulesSubFramesEnabled`; `GeckoSession.ContentDelegate.onCookieBannerDetected` and `onCookieBannerHandled`; `GeckoSession.hasCookieBannerRuleForBrowsingContextTree`; `StorageController.setCookieBannerModeForDomain`, `setCookieBannerModeAndPersistInPrivateBrowsingForDomain`, `removeCookieBannerModeForDomain` and `getCookieBannerModeForDomain`. ([bug 2058143]({{bugzilla}}2058143)) [154.1]: {{javadoc_uri}}/Autofill.Node.html#getDatalist() [154.2]: https://developer.mozilla.org/en/docs/Web/HTML/Reference/Elements/datalist [154.3]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.ContentPermission.html#notifyShown() [154.4]: {{javadoc_uri}}/IPProtectionController.html#refreshUsage() [154.5]: {{javadoc_uri}}/IPProtectionController.Delegate.html#onUsageChanged(org.mozilla.geckoview.IPProtectionController.UsageInfo) [154.6]: {{javadoc_uri}}/IPProtectionController.html#getCountryList() [154.7]: {{javadoc_uri}}/IPProtectionController.Country.html [154.8]: {{javadoc_uri}}/IPProtectionController.Delegate.html#onCountryListChanged(java.util.List) [154.9]: {{javadoc_uri}}/IPProtectionController.html#activate(boolean,boolean,java.lang.String) [154.10]: {{javadoc_uri}}/GeckoSession.ScrollPositionUpdate.html [154.12]: {{javadoc_uri}}/GeckoSession.html#setHistoryDelegate(org.mozilla.geckoview.GeckoSession.HistoryDelegate) [154.13]: {{javadoc_uri}}/GeckoSession.html#setContentBlockingDelegate(org.mozilla.geckoview.ContentBlocking.Delegate) [154.14]: {{javadoc_uri}}/GeckoSession.html#setMediaDelegate(org.mozilla.geckoview.GeckoSession.MediaDelegate) [154.15]: {{javadoc_uri}}/GeckoSession.html#setMediaSessionDelegate(org.mozilla.geckoview.MediaSession.Delegate) [154.16]: {{javadoc_uri}}/GeckoSession.html#setTranslationsSessionDelegate(org.mozilla.geckoview.TranslationsController.SessionTranslation.Delegate) [154.17]: {{javadoc_uri}}/GeckoSession.html#setPrintDelegate(org.mozilla.geckoview.GeckoSession.PrintDelegate) [154.18]: {{javadoc_uri}}/GeckoSession.html#setExperimentDelegate(org.mozilla.geckoview.GeckoSession.ExperimentDelegate) [154.19]: {{javadoc_uri}}/MediaSession.html#notifySystemAudioFocusChange(int) [154.21]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.html#hasVisitedHostSince(org.mozilla.geckoview.GeckoSession,java.lang.String,long,long) [154.22]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setIpProtectionAuthProvider(java.lang.String) [154.23]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getIpProtectionAuthProvider() ## v153 - Added [`SourceType`][153.1] annotation to [`ScrollPositionUpdate.source`][153.2] ([bug 1994860]({{bugzilla}}1994860)) - Updated the [`PURGED_BOUNCETRACKER`][129.3] value and added new [`REPLACED_FINGERPRINTING_CONTENT`] ContentBlockingController.Event. ([bug 2039485]({{bugzilla}}2039485)) - Added [`clearTrackingDb`][153.4] to ContentBlockingController to support clearing all data stored about blocked trackers in previous browsing sessions. ([bug 2042068]({{bugzilla}}2042068)) - Added [`onAudioSessionTypeChanged`][153.5] to [`MediaSession.Delegate`][153.6] so embedders can request platform audio focus matching the tab's W3C Audio Session type. ([bug 2047296]({{bugzilla}}2047296)) [153.1]: {{javadoc_uri}}/GeckoSession.ScrollPositionUpdate.SourceType.html [153.2]: {{javadoc_uri}}/GeckoSession.ScrollPositionUpdate.html#source [153.3]: {{javadoc_uri}}/ContentBlockingController.Event.html#REPLACED_FINGERPRINTING_CONTENT [153.4]: {{javadoc_uri}}/ContentBlockingController.html#clearTrackingDb() [153.5]: {{javadoc_uri}}/MediaSession.Delegate.html#onAudioSessionTypeChanged(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.MediaSession,java.lang.String) [153.6]: {{javadoc_uri}}/MediaSession.Delegate.html ## v152 - Added [`WebExtensionController.INSTALLATION_METHOD_RTAMO`][152.1], which should be used when a `WebExtension` is installed for the RTAMO feature. ([bug 2029607]({{bugzilla}}2029607)) - Added [`IPProtectionController.AuthProvider`][152.2], [`setAuthProvider`][152.3] / [`getAuthProvider`][152.4], and [`notifySignInStateChanged`][152.5] so embedders can supply Guardian authentication tokens to the IP Protection service. ([bug 2020725]({{bugzilla}}2020725)) - Added `safeBrowsingGlobalCacheEnabled`, `safeBrowsingRealTimeEnabled`, `safeBrowsingRealTimeSimulationEnabled`, `safeBrowsingRealTimeSimulationHitProbability`, `safeBrowsingRealTimeSimulationCacheTTLSec`, `safeBrowsingRealTimeSimulationNegativeCacheEnabled`, `safeBrowsingRealTimeSimulationNegativeCacheTTLSec` to [`ContentBlocking.Settings.Builder`][152.6] to enable configuring SafeBrowsing V5 Real-Time mode simulation. - Added new APIs - [`getTrackingDbEventsByDateRange`][152.7], [`sumAllTrackingDbEvents`][152.8] and [`getTrackingDbEarliestRecordedDate`][152.9] to ContentBlockingController to query Gecko for tracking protection details. - Added [`WebAuthnRelatedOriginPrompt`][152.10] and [`onWebAuthnRelatedOriginPrompt`][152.11] to `GeckoSession.PromptDelegate` for confirming WebAuthn related origin requests. ([bug 2010193]({{bugzilla}}2010193)) - Added [`IPProtectionController.enroll`][152.12] and [`IPProtectionController.EnrollResult`][152.13] to trigger enrollment via the active auth provider. ([bug 2037352]({{bugzilla}}2037352)) - Added [`IPProtectionController.GpiProvider`][152.14], [`setGpiProvider`][152.15] / [`getGpiProvider`][152.16] so embedders can supply Google Play Integrity tokens to the IP Protection service. ([bug 2037184]({{bugzilla}}2037184)) [152.1]: {{javadoc_uri}}/WebExtensionController.html#INSTALLATION_METHOD_RTAMO [152.2]: {{javadoc_uri}}/IPProtectionController.AuthProvider.html [152.3]: {{javadoc_uri}}/IPProtectionController.html#setAuthProvider(org.mozilla.geckoview.IPProtectionController.AuthProvider) [152.4]: {{javadoc_uri}}/IPProtectionController.html#getAuthProvider() [152.5]: {{javadoc_uri}}/IPProtectionController.html#notifySignInStateChanged(boolean) [152.6]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html [152.7]: {{javadoc_uri}}/ContentBlockingController.html#getTrackingDbEventsByDateRange(long,long) [152.8]: {{javadoc_uri}}/ContentBlockingController.html#sumAllTrackingDbEvents() [152.9]: {{javadoc_uri}}/ContentBlockingController.html#getTrackingDbEarliestRecordedDate() [152.10]: {{javadoc_uri}}/GeckoSession.PromptDelegate.WebAuthnRelatedOriginPrompt.html [152.11]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onWebAuthnRelatedOriginPrompt(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.WebAuthnRelatedOriginPrompt) [152.12]: {{javadoc_uri}}/IPProtectionController.html#enroll() [152.13]: {{javadoc_uri}}/IPProtectionController.EnrollResult.html [152.14]: {{javadoc_uri}}/IPProtectionController.GpiProvider.html [152.15]: {{javadoc_uri}}/IPProtectionController.html#setGpiProvider(org.mozilla.geckoview.IPProtectionController.GpiProvider) [152.16]: {{javadoc_uri}}/IPProtectionController.html#getGpiProvider() ## v151 - Added `isBlocked` to `AIFeature` on [`AIFeaturesController`][150.3]. - ⚠️ Remove deprecated `ContentDelegate.ContextElement` constructor. - ⚠️ Removed deprecated `ContentDelegate.ContextElement.textContent`. - ⚠️ Renamed `RuntimeAIFeatures.resetFeature` to [`RuntimeAIFeatures.makeFeatureAvailable`][151.1] in [`AIFeaturesController`][150.3] and `disable` to `block` to align with updated toolkit API naming. - Added [`ERROR_ENGINE_DEACTIVATED`][151.2] to `TranslationsController.TranslationsException` to indicate that session-level translation operations failed because the translations engine was deactivated by AI controls. - Added [`ContentParams`][151.3] to [`PageExtractionController`][149.2] and [`getPageContent(ContentParams)`][151.4] to [`SessionPageExtractor`][149.3] for controlling how page text is extracted (e.g. boilerplate removal). ([bug 2015480]({{bugzilla}}2015480)) - Added [`isReaderable`][151.5] to [`PageMetadata`][150.6] in `PageExtractionController` to indicate whether the page is likely readable by reader mode. ([bug 2030001]({{bugzilla}}2030001)) - Added `getContentBlockingDatabaseStatus` \ `setContentBlockingDatabaseStatus` to [`ContentBlocking.Settings`][151.6] to enable the trackers blocked database recording blocked trackers events. ([bug 1974742]({{bugzilla}}1974742)) - Added experimental [`IPProtectionController`][151.7] for accessing the IPProtection feature. [151.1]: {{javadoc_uri}}/AIFeaturesController.RuntimeAIFeatures.html#makeFeatureAvailable(java.lang.String) [151.2]: {{javadoc_uri}}/TranslationsController.TranslationsException.html#ERROR_ENGINE_DEACTIVATED [151.3]: {{javadoc_uri}}/PageExtractionController.GetTextOptions.html [151.4]: {{javadoc_uri}}/PageExtractionController.SessionPageExtractor.html#getPageContent(org.mozilla.geckoview.PageExtractionController.ContentParams) [151.5]: {{javadoc_uri}}/PageExtractionController.PageMetadata.html#isReaderable [151.6]: {{javadoc_uri}}/ContentBlocking.Settings.html [151.7]: {{javadoc_uri}}/IPProtectionController.html ## v150 - Added support for `COOKIES_PARTITIONED_TRACKER` in the tracking protection blocking log. ([bug 2020898 ]({{bugzilla}}2020898)) - Added [`GeckoSession.qwacStatus`][150.1] API. - Added [`GeckoRuntime.warmUp`][150.2] method. - ⚠️ Creating a GeckoRuntime will no longer eagerly start a child process. You can manually "preallocate" them by calling `GeckoRuntime.warmUp`. - Added experimental [`AIFeaturesController`][150.3] for coordinating GeckoView AI feature state. - ⚠️ Deprecated [`GeckoRuntimeSettings.getDisableShip`][150.4] and [`GeckoRuntimeSettings.Builder.disableShip`][150.5]. - Added [`PageMetadata`][150.6] to `PageExtractionController` and [`getPageMetadata`][150.7] to [`SessionPageExtractor`][149.3] for retrieving structured metadata about the current page. ([bug 2020508]({{bugzilla}}2020508)) - Added `getSafeBrowsingGlobalCacheEnabled`/`setSafeBrowsingGlobalCacheEnabled`, `getSafeBrowsingRealTimeEnabled`/`setSafeBrowsingRealTimeEnabled`, `getSafeBrowsingRealTimeSimulationEnabled`/`setSafeBrowsingRealTimeSimulationEnabled`, `getSafeBrowsingRealTimeSimulationHitProbability`/`setSafeBrowsingRealTimeSimulationHitProbability`, `getSafeBrowsingRealTimeSimulationCacheTTLSec`/`setSafeBrowsingRealTimeSimulationCacheTTLSec`, `getSafeBrowsingRealTimeSimulationNegativeCacheEnabled`/`setSafeBrowsingRealTimeSimulationNegativeCacheEnabled`, and `getSafeBrowsingRealTimeSimulationNegativeCacheTTLSec`/`setSafeBrowsingRealTimeSimulationNegativeCacheTTLSec` to [`ContentBlocking.Settings`][150.8] to control SafeBrowsing real-time lookup and simulation. [150.1]: {{javadoc_uri}}/GeckoSession.html#qwacStatus() [150.2]: {{javadoc_uri}}/GeckoRuntime.html#warmUp [150.3]: {{javadoc_uri}}/AIFeaturesController.html [150.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getDisableShip() [150.5]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#disableShip(boolean) [150.6]: {{javadoc_uri}}/PageExtractionController.PageMetadata.html [150.7]: {{javadoc_uri}}/PageExtractionController.SessionPageExtractor.html#getPageMetadata() [150.8]: {{javadoc_uri}}/ContentBlocking.Settings.html ## v149 - Introduce the Firefox Relay APIs in `GeckoRuntimeSettings`. - See also the annotation [`GeckoRuntimeSettings.FirefoxRelayMode`][149.1]. - Added experimental [`PageExtractionController`][149.2] and [`SessionPageExtractor`][149.3] for extracting the text content of a page - Added [`processBackPressed`][149.4] to handle [`CloseWatcher`][149.5]. ([bug 1966467]({{bugzilla}}1966467)) - Added [`HandlerThread`][149.6] annotation to better show that APIs using `GeckoResult`s require handlers and `ThreadUtils.assertOnHandlerThread`. - ⚠️ Switched `GeckoResult` APIs using `@AnyThread` annotations for `@HandlerThread` to better prevent unexpected behavior. ([bug 2015177]({{bugzilla}}2015177)) [149.1]: {{javadoc_uri}}/GeckoRuntimeSettings.FirefoxRelayMode.html [149.2]: {{javadoc_uri}}/PageExtractionController.html [149.3]: {{javadoc_uri}}/PageExtractionController.SessionPageExtractor.html [149.4]: {{javadoc_uri}}/GeckoSession.html#processBackPressed() [149.5]: https://developer.mozilla.org/en-US/docs/Web/API/CloseWatcher [149.6]: {{javadoc_uri}}/HandlerThread.html ## v148 - Introduce the harmful-addon URL-Classifier feature - [`HARMFULADDON`][148.1] - ⚠️ Remove deprecated `GeckoRuntimeSettings.Builder.setLnaBlockingEnabled`, `GeckoRuntimeSettings.setLnaBlockingEnabled` and `GeckoRuntimeSettings.getLnaBlockingEnabled` APIs. Alternatives were introduced in v147. - Added [`linkText`][148.2] to [`ContentDelegate.ContextElement`][65.21] and a new [`constructor`][148.3] to [`ContentDelegate.ContextElement`][65.21] - ⚠️ Deprecated [`ContentDelegate.ContextElement`][148.4] constructor. - ⚠️ Deprecated [`ContentDelegate.ContextElement.textContent`][148.5]. - ⚠️ Removed superfluous constructor overload for [`ContentDelegate.ContextElement`] [148.1]: {{javadoc_uri}}/ContentBlocking.SafeBrowsing.html#HARMFULADDON [148.2]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#linkText [148.3]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#(java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String) [148.4]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#(java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String) [148.5]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#textContent ## v147 - Changed Local Network / Device Access APIs in `GeckoRuntimeSettings` & `GeckoRuntimeSettings.Builder` for more granularity - Added new APIs in `GeckoRuntimeSettings` - [`setLnaEnabled`][147.1] & [`getLnaEnabled`][147.2] - [`setLnaBlockTrackers`][147.3] & [`getLnaBlockTrackers`][147.4] - [`setLnaBlocking`][147.5] & [`getLnaBlocking`][147.6] - Added corresponding APIs in `GeckoRuntimeSettings.Builder` - [`setLnaEnabled`][147.7] - [`setLnaBlockTrackers`][147.8] - [`setLnaBlocking`][147.9] - ⚠️ Deprecated `GeckoRuntimeSettings.Builder.setLnaBlockingEnabled`, `GeckoRuntimeSettings.setLnaBlockingEnabled` and `GeckoRuntimeSettings.getLnaBlockingEnabled` APIs. [147.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setLnaEnabled(boolean) [147.2]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getLnaEnabled [147.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setLnaBlockTrackers(boolean) [147.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getLnaBlockTrackers [147.5]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setLnaBlocking(boolean) [147.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getLnaBlocking [147.7]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setLnaEnabled(boolean) [147.8]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setLnaBlockTrackers(boolean) [147.9]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setLnaBlocking(boolean) ## v146 - Added `getSafeBrowsingV5Enabled` and `setSafeBrowsingV5Enabled` to [`ContentBlocking.Settings`][146.1] to control whether to use the SafeBrowsing V5 protocol to access the Google SafeBrowsing service. - Added [`Autocomplete.AddressStructure`][146.2] API used to retrieve the structure of an address for a given country. - Added [`GeckoRuntimeSettings.getAppZygoteProcessEnabled`][146.3] and [`GeckoRuntimeSettings.Builder.appZygoteProcessEnabled`][146.4] to control whether content service runs using App Zygote preloading or not. [146.1]: {{javadoc_uri}}/ContentBlocking.html [146.2]: {{javadoc_uri}}/Autocomplete.AddressStructure.html [146.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getAppZygoteProcessEnabled [146.4]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#appZygoteProcessEnabled(boolean) ## v145 - Added [`WebNotification.show`][145.1]. Implementations of `WebNotificationDelegate.onShowNotification` should now call either `show` when the notification is successfully opened, or `dismiss` if it failed. - Added [`WebExtension.InvalidMetaDataException`][145.2]. ([bug 1981496]({{bugzilla}}1981496)) - Added [`GeckoSession.PromptDelegate.RedirectPrompt`][145.3] to display a prompt when a third-party redirect is blocked. - Added support for controlling `security.pki.crlite_channel` via [`GeckoRuntimeSettings.setCrliteChannel`][145.4] - Changed certificate transparency information in TLS connections to now be required by default. This can be controlled by the [`GeckoRuntimeSettings.setCertificateTransparencyMode`][145.5] API. [145.1]: {{javadoc_uri}}/WebNotification.html#show [145.2]: {{javadoc_uri}}/WebExtension.InvalidMetaDataException.html [145.3]: {{javadoc_uri}}/GeckoSession.PromptDelegate.RedirectPrompt.html [145.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setCrliteChannel [145.5]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setCertificateTransparencyMode ## v144 - Added [`GeckoSession.flushSessionState()`][144.1] to immediately notify the registered [`GeckoSession.ProgressDelegate`][144.2] and [`GeckoSession.HistoryDelegate`][144.3] of the current session state. ([bug 1970055]({{bugzilla}}1970055)) - Added [`GeckoRuntimeSettings.getIsolatedProcessEnabled`][144.4] and [`GeckoRuntimeSettings.Builder.isolatedProcessEnabled`][144.5] to control whether content service runs on isolated process or not. - Added [`ContentBlocking.GOOGLE_SAFE_BROWSING_V5_PROVIDER`][144.6] for the configuration of the SafeBrowsing V5 provider - ⚠️ Removed deprecated `onOptionalPrompt` function signature. ([bug 1972510]({{bugzilla}}1972510)) - ⚠️ Removed deprecated `onUpdatePrompt` function signature. ([bug 1974744]({{bugzilla}}1974744)) - Added [`RequiresApi`][144.7] annotations to APIs. - Added `appLinkLaunchType` to [`GeckoSession.Loader`][144.8] to set the launch type of the app session for the load.([bug 1982622]({{bugzilla}}1982622)) - ⭐ Support for [`16 KB page sizes`][144.9] is now available. [144.1]: {{javadoc_uri}}/GeckoSession.html#flushSessionState() [144.2]: {{javadoc_uri}}/GeckoSession.ProgressDelegate.html [144.3]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.html [144.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getIsolatedProcessEnabled [144.5]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#isolatedProcessEnabled(boolean) [144.6]: {{javadoc_uri}}/ContentBlocking.SafeBrowsingProvider.html [144.7]: https://developer.android.com/reference/androidx/annotation/RequiresApi [144.8]: {{javadoc_uri}}/GeckoSession.Loader.html#appLinkLaunchType(int) [144.9]: https://developer.android.com/guide/practices/page-sizes ## v143 - Added an option to set multiple preferences on [`GeckoPreferenceController`][140.1] as [`checkStateAndSetGeckoPrefs`][143.1]. - Added [`WebNotification.origin`][143.2] that shows the origin of the notification. ([bug 1976269]({{bugzilla}}1976269)) - ⚠️ Removed deprecated functions that were scheduled for removal in GeckoView 143. Includes deprecations to versions of `onInstallPromptRequest`, `removeOptionalPermissions`, `addOptionalPermissions`, `PermissionPromptResponse()`, and `CertificateRequest()`. ([bug 1980176]({{bugzilla}}1980176)) - Added [`GeckoRuntimeSettings#setLnaBlockingEnabled`][143.3], [`GeckoRuntimeSettings#getLnaBlockingEnabled`][143.4] and [`GeckoRuntimeSettings.Builder#setLnaBlockingEnabled`][143.5] to enable LNA blocking. - Added new permissions [`GeckoSession.PermissionDelegate#PERMISSION_LOCAL_DEVICE_ACCESS`][143.6] and [`GeckoSession.PermissionDelegate#PERMISSION_LOCAL_NETWORK_ACCESS`][143.7] [143.1]: {{javadoc_uri}}/GeckoPreferenceController.html#setGeckoPrefs(java.util.List) [143.2]: {{javadoc_uri}}/WebNotification.html#origin [143.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setLnaBlockingEnabled(boolean) [143.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getLnaBlockingEnabled [143.5]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setLnaBlockingEnabled(boolean) [143.6]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_LOCAL_DEVICE_ACCESS [143.7]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_LOCAL_NETWORK_ACCESS ## v142 - Added support for data collection permissions to [`WebExtensionController.onOptionalPrompt`][142.1] ([bug 1964999]({{bugzilla}}1964999)) - ⚠️ Removed deprecated functions that were scheduled for removal in GeckoView 142. ([bug 1963053]({{bugzilla}}1963053)) - Added `setBounceTrackingProtectionMode`, `getBounceTrackingProtectionMode` to [`ContentBlocking.Settings`][142.2]. ([bug 1963445]({{bugzilla}}1963445)) - Added the list of data collection permission names to [`WebExtension`][142.3] ([bug 1972228]({{bugzilla}}1972228)) - Added [`@ExperimentalGeckoViewApi`][142.4] to annotate APIs that need special care. Opt in via `@OptIn(markerClass = ExperimentalGeckoViewApi.class)` to accept the risks. - ⚠️ [`GeckoPreferenceController`][140.1] is now annotated with `@ExperimentalGeckoViewApi`. - Added `setAllowListBaselineTrackingProtection`, `getAllowListBaselineTrackingProtection`, `setAllowListConvenienceTrackingProtection`, `setAllowListConvenienceTrackingProtection` to [`ContentBlocking.Settings`][142.5]. ([bug 1970649]({{bugzilla}}1970649)) - Added support for data collection permissions to [`WebExtensionController.onUpdatePrompt`][142.6] ([bug 1974742]({{bugzilla}}1974742)) [142.1]: {{javadoc_uri}}/WebExtensionController.PromptDelegate.html#onOptionalPrompt(org.mozilla.geckoview.WebExtension,java.lang.String[],java.lang.String[],java.lang.String[]) [142.2]: {{javadoc_uri}}/ContentBlocking.html [142.3]: {{javadoc_uri}}/WebExtension.html [142.4]: {{javadoc_uri}}/ExperimentalGeckoViewApi.html [142.5]: {{javadoc_uri}}/ContentBlocking.html [142.6]: {{javadoc_uri}}/WebExtensionController.PromptDelegate.html#onUpdatePrompt(org.mozilla.geckoview.WebExtension,java.lang.String[],java.lang.String[],java.lang.String[]) ## v141 - Changed the methods in [`ProfilerController`][141.1] to static. ([bug 1955403]({{bugzilla}}1955403)) - ⚠️ Deprecated [`GeckoRuntime.getProfilerController`][141.2], will now be removed in v142. ([bug 1955403]({{bugzilla}}1955403)) - Added options on [`GeckoPreferenceController`][140.1] to [`register multiple prefs`][141.3] and [`deregister multiple prefs`][141.4] - Added [`GeckoRuntime.notifyTelemetryPrefChanged`][141.5] to notify Gecko about telemetry preference changes. - Added [`GeckoRuntimeSettings.getBaselineFingerprintingProtection`][141.6], [`GeckoRuntimeSettings.getBaselineFingerprintingProtectionOverrides`][141.7], [`GeckoRuntimeSettings.setBaselineFingerprintingProtection`][141.8], and [`GeckoRuntimeSettings.setBaselineFingerprintingProtectionOverrides`][141.9] to control the baseline fingerprinting protection settings via Nimbus. - Added data collection permissions to [`WebExtension.MetaData`][141.10] ([bug 1960551]({{bugzilla}}1960551)) - Added option on [`GeckoPreferenceController`][140.1] to [`get multiple preference`][141.12] values at once. - Added [`WebNotificationAction`][141.13] that represents action buttons of notifications. - Added [`WebNotification.actions`][141.14] and a new function signature with `action` to [`WebNotification.click()`][141.15] to indicate action click. - Added support for special "technical and interaction" data collection permission ([bug 1964992]({{bugilla}}1964992)) - Added support for data collection permissions in [`WebExtensionController.addOptionalPermissions`][141.16] and [`WebExtensionController.removeOptionalPermissions`][141.17] ([bug 1964992]({{bugzilla}}1964992)) - Added [`CrashPullController.Delegate`][141.18] interface, which allows Gecko's `RemoteSettingsCrashPull` module to request that the application uploads a specified subset of user crash dumps. [141.1]: {{javadoc_uri}}/ProfilerController.html [141.2]: {{javadoc_uri}}/GeckoRuntime.html#getProfilerController() [141.3]: {{javadoc_uri}}/GeckoPreferenceController.Observer.html#registerPreferences(java.util.List) [141.4]: {{javadoc_uri}}/GeckoPreferenceController.Observer.html#unregisterPreferences(java.util.List) [141.5]: {{javadoc_uri}}/GeckoRuntime.html#notifyTelemetryPrefChanged(boolean) [141.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getBaselineFingerprintingProtection [141.7]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getBaselineFingerprintingProtectionOverrides [141.8]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setBaselineFingerprintingProtection [141.9]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setBaselineFingerprintingProtectionOverrides [141.10]: {{javadoc_uri}}/WebExtension.MetaData.html [141.12]: {{javadoc_uri}}/GeckoPreferenceController.html#getGeckoPrefs(java.util.List) [141.13]: {{javadoc_uri}}/WebNotificationAction.html [141.14]: {{javadoc_uri}}/WebNotification.html#actions [141.15]: {{javadoc_uri}}/WebNotification.html#click(java.lang.String) [141.16]: {{javadoc_uri}}/WebExtensionController.html#addOptionalPermissions [141.17]: {{javadoc_uri}}/WebExtensionController.html#removeOptionalPermissions [141.18]: {{javadoc_uri}}/CrashPullController.html#CrashPullController.Delegate ## v140 - Added a [`GeckoPreferenceController`][140.1] class to manage Gecko preferences. - Introduced a new [`preference observer delegate`][140.2] and a way to [`register`][140.3] preferences on the delegate. - Added options on [`GeckoPreferenceController`][140.1] to [`Get`][140.4] and [`Set`][140.5] Gecko preferences. - Added option on [`GeckoPreferenceController`][140.1] to [`Clear`][140.6] a Gecko preference. - Added [`setSameDocumentNavigationOverridesLoadType`][140.7] and [`setSameDocumentNavigationOverridesLoadTypeForceDisable`][140.8] to set values on the `GeckoRuntimeSettings` builder to determine whether the same document navigation should override the load type or not. - Added [`getSameDocumentNavigationOverridesLoadType`][140.9], [`setSameDocumentNavigationOverridesLoadType`][140.10], [`getSameDocumentNavigationOverridesLoadTypeForceDisable`][140.11], [`setSameDocumentNavigationOverridesLoadTypeForceDisable`][140.12] to get the runtime settings for same document navigation overriding the load type. - ⚠️ Deprecated a [`GeckoSession.PromptDelegate.CertificateRequest`][140.13] constructor in favor of one that takes an array of acceptable issuers. - Added support for controlling `network.android_doh.autoselect_enabled` via [`GeckoRuntimeSettings.setDohAutoselectEnabled`][140.14] - Added support for controlling `network.security.ports.banned` via [`GeckoRuntimeSettings.setBannedPorts`][140.15] [140.1]: {{javadoc_uri}}/GeckoPreferenceController.html [140.2]: {{javadoc_uri}}/GeckoPreferenceController.Observer.Delegate.html [140.3]: {{javadoc_uri}}/GeckoPreferenceController.Observer.html [140.4]: {{javadoc_uri}}/GeckoPreferenceController.html#getGeckoPref(java.lang.String,int) [140.5]: {{javadoc_uri}}/GeckoPreferenceController.html#setGeckoPref(java.lang.String,java.lang.String,int) [140.6]: {{javadoc_uri}}/GeckoPreferenceController.html#clearGeckoUserPref(java.lang.String) [140.7]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setSameDocumentNavigationOverridesLoadType(boolean) [140.8]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setSameDocumentNavigationOverridesLoadTypeForceDisable(java.lang.String) [140.9]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getSameDocumentNavigationOverridesLoadType() [140.10]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setSameDocumentNavigationOverridesLoadType(boolean) [140.11]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getSameDocumentNavigationOverridesLoadTypeForceDisable() [140.12]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setSameDocumentNavigationOverridesLoadTypeForceDisable(java.lang.String) [140.13]: {{javadoc_uri}}/GeckoSession.PromptDelegate.CertificateRequest.html#(java.lang.String,org.mozilla.geckoview.GeckoSession.PromptDelegate.BasePrompt.Observer,java.lang.String) [140.14]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setDohAutoselectEnabled [140.15]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setBannedPorts ## v139 - ⚠️ Removed deprecated [`GeckoSession.requestAnalysis`][118.4], [`GeckoSession.requestCreateAnalysis`][122.2], [`GeckoSession.requestAnalysisStatus`][137.1], [`GeckoSession.sendPlacementAttributionEvent`][123.3], [`GeckoSession.pollForAnalysisCompleted`][137.2], [`GeckoSession.sendClickAttributionEvent`][121.4], [`GeckoSession.sendImpressionAttributionEvent`][121.5], [`GeckoSession.sendPlacementAttributionEvent`][123.3], [`GeckoSession.requestRecommendations`][118.5], [`GeckoSession.reportBackInStock`][122.1], `AnalysisStatusResponse`, [`ReviewAnalysis`][120.2] and [`Recommendation`][120.3]. - Added [`CompositorController.onPipModeChanged`][139.1] to [`CompositorController`][65.1] to inform GeckoSession of changes to and from picture-in-picture mode. - ⚠️Increased `compileSdkVersion` to 36 (Android 16) - Added [`getLowMemoryDetection()`][139.2] on `GeckoRuntimeSettings` and [`lowMemoryDetection(boolean)`][139.3] on `GeckoRuntimeSettings.Builder` to control the low-memory detection machinery. - ⚠️ Changed the meaning of `EXTRA_CRASH_PROCESS_TYPE`: it now refers to the actual process type reported by gecko. The previous meaning has moved to `EXTRA_CRASH_PROCESS_VISIBILITY` in `ACTION_CRASHED` intents to avoid confusion with "process type" terminology in crash handling code. The `CRASHED_PROCESS_TYPE_*` constants are deprecated (to be removed in v142) and equivalent `CRASHED_PROCESS_VISIBILITY_*` constants have been added. ([bug 1959799]({{bugzilla}}1959799) - Added `setEnhancedTrackingProtectionCategory` to [`ContentBlocking.Settings`][139.4]. ([bug 1956620]({{bugzilla}}1956620)) [139.1]: {{javadoc_uri}}/CompositorController.html#onPipModeChanged [139.2]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getLowMemoryDetection [139.3]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#lowMemoryDetection [139.4]: {{javadoc_uri}}/ContentBlocking.html ## v138 - Added [`GeckoSession.Loader.originalInput`][138.1] option, which allows passing through the original user address bar input - Added [`PromptDelegate.FilePrompt.Type.FOLDER`][138.2] to show directory picker. ([bug 1674428]({{bugzilla}}1674428)) - Added [`onFolderUploadPrompt`][138.3] and [`PromptDelegate.FolderUploadPrompt`][138.4] to confirm folder upload. ([bug 1674428]({{bugzilla}}1674428)) - Added [`GeckoSession.PromptDelegate.onRequestCertificate`][138.5] to support client authentication certificates. ([bug 1813930]({{bugzilla}}1813930)) - Added [`Loader#textDirectiveUserActivation`][138.6] to set text directive user activation. ([bug 1912095]({{bugzilla}}1912095)) - Added [`GeckoSession.sendMoreWebCompatInfo`][138.7] that sends a `GeckoResult` of web compatibility information. ([bug 1952931]({{bugzilla}}1952931)). - Added [`GeckoWebExecutor#FETCH_FLAG_OHTTP`][138.8]. This new flag allows for making Oblivious HTTP requests. [138.1]: {{javadoc_uri}}/GeckoSession.Loader.html#originalInput(java.lang.String) [138.2]: {{javadoc_uri}}/GeckoSession.PromptDelegate.FilePrompt.Type.html#FOLDER [138.3]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onFolderUploadPrompt(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.FolderUploadPrompt) [138.4]: {{javadoc_uri}}/GeckoSession.PromptDelegate.FolderUploadPrompt.html [138.5]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onRequestCertificate(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.CertificateRequest) [138.6]: {{javadoc_uri}}/GeckoSession.Loader.html#textDirectiveUserActivation(boolean) [138.7]: {{javadoc_uri}}/GeckoSession.html#sendMoreWebCompatInfo() [138.8]: {{javadoc_uri}}/GeckoWebExecutor.html#FETCH_FLAG_OHTTP ## v137 - ⚠️ [`GeckoSession.requestAnalysis`][118.4], [`GeckoSession.requestCreateAnalysis`][122.2], [`GeckoSession.requestAnalysisStatus`][137.1], [`GeckoSession.sendPlacementAttributionEvent`][123.3], [`GeckoSession.pollForAnalysisCompleted`][137.2], [`GeckoSession.sendClickAttributionEvent`][121.4], [`GeckoSession.sendImpressionAttributionEvent`][121.5], [`GeckoSession.sendPlacementAttributionEvent`][123.3], [`GeckoSession.requestRecommendations`][118.5], [`GeckoSession.reportBackInStock`][122.1], `AnalysisStatusResponse`, [`ReviewAnalysis`][120.2] and [`Recommendation`][120.3] are deprecated, and it will be deleted in version 139 see https://bugzilla.mozilla.org/show_bug.cgi?id=1941470. - Added support for controlling `network.trr.default_provider_uri` via [`GeckoRuntimeSettings.setDefaultRecursiveResolverUri`][137.3] and [`GeckoRuntimeSettings.getDefaultRecursiveResolverUri`][137.4] - [`GeckoRuntimeSettings.getFingerprintingProtection`][137.6] and [`GeckoRuntimeSettings.getFingerprintingProtectionPrivateBrowsing`][137.7] are now `@Nullable` to indicates that their values are controlled by the engine. - Added support for controlling `security.tls.enable_kyber` and `network.http.http3.enable_kyber` via [`GeckoRuntimeSettings.setPostQuantumKeyExchangeEnabled`][137.8] [137.1]: {{javadoc_uri}}/GeckoSession.html#requestAnalysisStatus(String) [137.2]: {{javadoc_uri}}/GeckoSession.html#pollForAnalysisCompleted(String) [137.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setDefaultRecursiveResolverUri [137.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getDefaultRecursiveResolverUri [137.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getFingerprintingProtection [137.7]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getFingerprintingProtectionPrivateBrowsing [137.8]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setPostQuantumKeyExchangeEnabled ## v136 - Added support for controlling `security.pki.certificate_transparency.mode` via [`GeckoRuntimeSettings.setCertificateTransparencyMode`][136.1] - Added [`GeckoSession.CompositorScrollDelegate`][136.2] interface, which allows reacting to scroll position changes as soon as they are composited - Added support for controlling `network.trr.excluded-domains` via [`GeckoRuntimeSettings.setTrustedRecursiveResolverExcludedDomains`][136.3] and [`GeckoRuntimeSettings.getTrustedRecursiveResolverExcludedDomains`][136.4] - Added [`GeckoSession.Loader.originalInput`][136.5] option, which allows passing through the original user address bar input [136.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setCertificateTransparencyMode [136.2]: {{javadoc_uri}}/GeckoSession.html#CompositorScrollDelegate [136.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setTrustedRecursiveResolverExcludedDomains [136.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getTrustedRecursiveResolverExcludedDomains [136.5]: {{javadoc_uri}}/GeckoSession.Loader.html#originalInput(java.lang.String) ## v134 - ⚠️ [`WebExtensionController.PromptDelegate.onInstallPrompt`][133.5] is removed see https://bugzilla.mozilla.org/show_bug.cgi?id=1919374 for more details. - Added support for controlling `javascript.options.mem.gc_parallel_marking` via [`GeckoRuntimeSettings.setParallelMarkingEnabled`][134.1] [134.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setParallelMarkingEnabled ## v133 - Added [`GeckoSession.getWebCompatInfo`][133.1] that returns a `GeckoResult` for web compatability information. ([bug 1917273]({{bugzilla}}1917273)). - Added [`isInteractiveWidgetDefaultResizesVisual`][133.2] to tell the preference value of "dom.interactive_widget_default_resizes_visual". - Added [`WebExtension.PermissionPromptResponse`][133.3] Represents a response from `WebExtension` prompt request. - Added [`WebExtension.onInstallPromptRequest`][133.4] Delegate notified when install prompt needs to be shown. - ⚠️ [`WebExtensionController.PromptDelegate.onInstallPrompt`][133.5] is deprecated, and it will be deleted in version 134 see https://bugzilla.mozilla.org/show_bug.cgi?id=1919374. - Added [`ERROR_SOFT_BLOCKED`][133.6] to `WebExtension.InstallException.ErrorCodes`, and [`SOFT_BLOCKLIST`][133.7] to`WebExtension.DisabledFlags`. ([bug 1917852]({{bugzilla}}1917852)) - Added [`InstallException.extensionId`][133.8], which indicates the ID of the extension that caused the exception. - Added [`getFissionEnabled()`][133.9] on `GeckoRuntimeSettings` and [`fissionEnabled(boolean)`][133.10] on `GeckoRuntimeSettings.Builder` to control Fission on Android. - Added [`InstallException.extensionVersion`][133.11], which indicates the version of the extension that caused the exception. - Added [`WebExtensionController.INSTALLATION_METHOD_ONBOARDING`][133.12], which should be used when a `WebExtension` is installed from the embedder's onboarding feature. - Added support for controlling `network.fetchpriority.enabled` via [`GeckoRuntimeSettings.setFetchPriorityEnabled`][133.13] - Added [`GeckoRuntimeSettings.setCookieBehaviorOptInPartitioning`][133.14] and [`GeckoRuntimeSettings.setCookieBehaviorOptInPartitioningPBM`][133.15] to control the cookie behavior opt-in partitioning. [133.1]: {{javadoc_uri}}/GeckoSession.html#getWebCompatInfo() [133.2]: {{javadoc_uri}}/GeckoRuntime.html#isInteractiveWidgetDefaultResizesVisual() [133.3]: {{javadoc_uri}}/WebExtension.PermissionPromptResponse.html [133.4]: {{javadoc_uri}}/WebExtensionController.PromptDelegate.html#onInstallPromptRequest [133.5]: {{javadoc_uri}}/WebExtensionController.PromptDelegate.html#onInstallPrompt [133.6]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_BLOCKLISTED [133.7]: {{javadoc_uri}}/WebExtension.DisabledFlags.html#SOFT_BLOCKLIST [133.8]: {{javadoc_uri}}/WebExtension.InstallException.html#extensionId [133.9]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getFissionEnabled() [133.10]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#fissionEnabled(boolean) [133.11]: {{javadoc_uri}}/WebExtension.InstallException.html#extensionVersion [133.12]: {{javadoc_uri}}/WebExtensionController.html#INSTALLATION_METHOD_ONBOARDING [133.13]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setFetchPriorityEnabled [133.14]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setCookieBehaviorOptInPartitioning [133.15]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setCookieBehaviorOptInPartitioningPBM ## v132 -Added [`getDisableShip`][132.1] to get the setting for Session History in Parent (SHIP)) and [`disableShip`][132.2] to set the status of SHIP on the `GeckoRuntimeSettings` builder. - Added [`setWebContentIsolationStrategy`][132.3] and [`getWebContentIsolationStrategy`][132.4] and defined the strategies. [132.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getDisableShip() [132.2]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#disableShip(boolean) [132.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setWebContentIsolationStrategy(int) [132.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getWebContentIsolationStrategy() ## v131 - Added [`GeckoDisplay.windowInsetsChanged`][131.1]. - Added [`GeckoView.addWindowInsetsListener`][131.2] and [`GeckoView.removeWindowInsetsListener`][131.3] to allow listening WindowInsets changes of Activity's root window with multiple listeners. - ⚠️Increased `compileSdkVersion` to 35 (Android 15) - ️️⚠️ Removed deprecated [`GeckoSession.ContentDelegate.onProductUrl`][128.5]. - Added support for controlling `toolkit.telemetry.user_characteristics_ping.current_version` via [`GeckoRuntimeSettings.setUserCharacteristicPingCurrentVersion`][131.4] [131.1]: {{javadoc_uri}}/GeckoDisplay.html#windowInsetsChanged [131.2]: {{javadoc_uri}}/GeckoView.html#addWindowInsetsListener [131.3]: {{javadoc_uri}}/GeckoView.html#removeWindowInsetsListener [131.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setUserCharacteristicPingCurrentVersion ## v130 - ⚠️ Removed [`TranslationState`][127.4] constructor, please use the new [`TranslationState`][127.3] constructor with `hasVisibleChange`. ([bug 1895275]({{bugzilla}}1895275)) - Added support for controlling `privacy.fingerprintingProtection` and `privacy.fingerprintingProtection.pbmode` via [`GeckoRuntimeSettings.setFingerprintingProtection`][130.1] - Added support for controlling `privacy.fingerprintingProtection.overrides` via [`GeckoRuntimeSettings.setFingerprintingProtectionOverrides`][130.2] - Added support for controlling `javascript.options.use_fdlibm_for_sin_cos_tan` via [`GeckoRuntimeSettings.setFdlibmMathEnabled`][130.3] [130.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setFingerprintingProtection [130.2]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setFingerprintingProtectionOverrides [130.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setFdlibmMathEnabled ## v129 - Added [`ERROR_ADMIN_INSTALL_ONLY`][129.1] to `WebExtension.InstallException.ErrorCodes`. ([bug 1902222]({{bugzilla}}1902222)) - Added [`ContentDelegate.onHideDynamicToolbar`][129.2] to notify the app that it must fully-collapse its dynamic toolbar ([bug 1855990]({{bugzilla}}1855990)) - Added [`PURGED_BOUNCETRACKER`][129.3] and [`BLOCKED_SUSPICIOUS_FINGERPRINTING`][129.4] to `ContentBlockingController.Event`. ([bug 1901808]({{bugzilla}}1901808)) [129.1]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_ADMIN_INSTALL_ONLY [129.2]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onHideDynamicToolbar(org.mozilla.geckoview.GeckoSession) [129.3]: {{javadoc_uri}}/ContentBlockingController.Event.html#PURGED_BOUNCETRACKER [129.4]: {{javadoc_uri}}/ContentBlockingController.Event.html#BLOCKED_SUSPICIOUS_FINGERPRINTING ## v128 - ⚠️ Removed deprecated [`GeckoSession.NavigationDelegate.onLocationChange`][128.1] - Reverted the change to the `WebExtension.MetaData` related to "prompt" permissions ([bug 1879543]({{bugzilla}}1879543)) and explicitly passed the permissions/origins into the `PromptDelegate` methods. Required permissions and origins are now available via [`WebExtension.MetaData.requiredPermissions`][128.2] and [`WebExtension.MetaData.requiredOrigins`][128.3]. - Added additional [`Autocomplete.LoginSelectOption`][128.4] constructor that takes a `hint` ([bug 1877237]({{bugzilla}}1877237)). - ⚠️ Deprecated [`GeckoSession.ContentDelegate.onProductUrl`][128.5], will now be removed in v131. ([bug 1898055]({{bugzilla}}1898055)) [128.1]: {{javadoc_uri}}/GeckoSession.NavigationDelegate#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String,java.util.List) [128.2]: {{javadoc_uri}}/WebExtension.MetaData.html#promptPermissions [128.3]: {{javadoc_uri}}/WebExtension.MetaData.html#promptOrigins [128.4]: {{javadoc_uri}}/Autocomplete.LoginSelectOption.html#(org.mozilla.geckoview.Autocomplete.LoginEntry,int) [128.5]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onProductUrl(org.mozilla.geckoview.GeckoSession) ## v127 - ⚠️ Removed deprecated [`RuntimeTelemetry`][125.5], [`GeckoRuntimeSettings.getTelemetryDelegate`][125.6] and [`GeckoRuntimeSettings.telemetryDelegate`][125.7]. - Added [FINDER_FIND_FORWARD][127.1] - Added [`WebExtensionController.AddonManagerDelegate.onOptionalPermissionsChanged`][127.2] ([bug 1892302]({{bugzilla}}1892302). - Added a new [`TranslationState`][127.3] constructor to add `hasVisibleChange` and deprecated the prior [`TranslationsState`][127.4] constructor to be removed in v130. [127.1]: {{javadoc_uri}}/GeckoSession.html#FINDER_FIND_FORWARD [127.2]: {{javadoc_uri}}/WebExtensionController.AddonManagerDelegate.html#onOptionalPermissionsChanged [127.3]: {{javadoc_uri}}/TranslationsController.SessionTranslation.TranslationState.html#%3Cinit%3E(org.mozilla.geckoview.TranslationsController.SessionTranslation.TranslationPair,java.lang.String,org.mozilla.geckoview.TranslationsController.SessionTranslation.DetectedLanguages,java.lang.Boolean,java.lang.Boolean) [127.4]: {{javadoc_uri}}/TranslationsController.SessionTranslation.TranslationState.html#(org.mozilla.geckoview.TranslationsController.SessionTranslation.TranslationPair,java.lang.String,org.mozilla.geckoview.TranslationsController.SessionTranslation.DetectedLanguages,java.lang.Boolean) ## v125 - ⚠️ Deprecated [`GeckoSession.NavigationDelegate.onLocationChange`][125.1], to be removed in v127. ([bug 1837601]({{bugzilla}}1837601)) - Added [`GeckoSession.NavigationDelegate.onLocationChange#hasUserGesture`][125.2]. This indicates if a location change was requested while a user gesture was active (e.g., a tap). ([bug 1837601]({{bugzilla}}1837601)) - Added [`WebExtension.MetaData.optionalPermissions`][125.3] and [`WebExtension.MetaData.optionalOrigins`][125.4] which expose the optional and origin optional permissions of an extension ([bug 1811900]({{bugzilla}}1811900)). - ⚠️ Deprecated [`RuntimeTelemetry`][125.5], [`GeckoRuntimeSettings.getTelemetryDelegate`][125.6] and [`GeckoRuntimeSettings.telemetryDelegate`][125.7], to be removed in v127. ([bug 1877836]({{bugzilla}}1877836)) - Added [`WebExtension.MetaData.grantedOptionalPermissions`][125.8] and [`WebExtension.MetaData.grantedOptionalOrigins`][125.9] which expose the granted optional and origin optional permissions of an extension ([bug 1879543]({{bugzilla}}1879543)). - Added [`WebExtension.MetaData.promptPermissions`][125.10] which exposes a list of permissions which needs to be prompted to users ([bug 1879547]({{bugzilla}}1879547)). - ⚠️ Deprecate the [`WebExtension.MetaData.permissions`][125.11] API to be removed in v131. Please use `WebExtension.MetaData.promptPermissions`][125.10] instead. - Added [`WebExtensionController.addOptionalPermissions`][125.12] and [`WebExtensionController.removeOptionalPermissions`][125.13], which allow to add and remove optional permissions/origins of an extension ([bug 1796176]({{bugzilla}}1796176)). [125.1]: {{javadoc_uri}}/GeckoSession.NavigationDelegate#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String,java.util.List) [125.2]: {{javadoc_uri}}/GeckoSession.NavigationDelegate#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String,java.util.List,boolean) [125.3]: {{javadoc_uri}}/WebExtension.MetaData.html#optionalPermissions [125.4]: {{javadoc_uri}}/WebExtension.MetaData.html#optionalOrigins [125.5]: {{javadoc_uri}}/RuntimeTelemetry.html [125.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getTelemetryDelegate [125.7]: {{javadoc_uri}}/GeckoRuntimeSettings.html#telemetryDelegate [125.8]: {{javadoc_uri}}/WebExtension.MetaData.html#grantedOptionalPermissions [125.9]: {{javadoc_uri}}/WebExtension.MetaData.html#grantedOptionalOrigins [125.10]: {{javadoc_uri}}/WebExtension.MetaData.html#promptPermissions [125.11]: {{javadoc_uri}}/WebExtension.MetaData.html#permissions [125.12]: {{javadoc_uri}}/WebExtensionController.html#addOptionalPermissions [125.13]: {{javadoc_uri}}/WebExtensionController.html#removeOptionalPermissions ## v124 - Added [`GeckoRuntimeSettings#setTrustedRecursiveResolverMode`][124.1] to enable DNS-over-HTTPS using different resolver modes ([bug 1591533]({{bugzilla}}1591533)). - Added [`GeckoRuntimeSettings#setTrustedRecursiveResolverUri`][124.2] to specify the DNS-over-HTTPS server to be used if DoH is enabled ([bug 1591533]({{bugzilla}}1591533)). - Added [`GeckoRuntimeSettings#setLargeKeepaliveFactor`][124.3] to increase the keepalive timeout used for a connection ([bug 1591533]({{bugzilla}}1591533)). - Added [`PanZoomController.onDragEvent`][124.4] to support drag and drop. ([bug 1586471]({{bugzilla}}1586471)) - Added [`WebExtension.MetaData.incognito`][124.5] property. ([bug 1875229]({{bugzilla}}1875229)) [124.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setTrustedRecursiveResolverMode-int- [124.2]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setTrustedRecursiveResolverUri-java.lang.String- [124.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setLargeKeepaliveFactor-int- [124.4]: {{javadoc_uri}}/PanZoomController.html#onDragEvent(android.view.DragEvent) [124.5]: {{javadoc_uri}}/WebExtension.MetaData.html#incognito ## v123 - For Translations, added [`checkPairDownloadSize`][123.1] and [`TranslationsException.ERROR_MODEL_LANGUAGE_REQUIRED`][123.2] as an error state. - ⚠️ Deprecated [`GeckoSession.requestAnalysisCreationStatus`][119.2] by 124, please use [`GeckoSession.requestCreateAnalysis`][122.2] instead. - ⚠️ Removed deprecated [`GeckoSession.requestAnalysisCreationStatus`][119.2] - Added [`GeckoSession.sendPlacementAttributionEvent`][123.3] for sending placement attribution event for a given product recommendation. [123.1]: {{javadoc_uri}}/TranslationsController.RuntimeTranslation.html#checkPairDownloadSize(java.lang.String,java.lang.String) [123.2]: {{javadoc_uri}}/TranslationsController.TranslationsException.html#ERROR_MODEL_LANGUAGE_REQUIRED [123.3]: {{javadoc_uri}}/GeckoSession.html#sendPlacementAttributionEvent(String) ## v122 - ⚠️ Removed [`onGetNimbusFeature`][115.5], please use `ExperimentDelegate.onGetExperimentFeature` instead. - Added [`GeckoSession.reportBackInStock`][122.1] for reporting a Shopping product is back in stock.([bug 1858945]({{bugzilla}}1858945)) - Added [`GeckoSession.requestCreateAnalysis`][122.2] to return a `AnalysisStatusResponse` that contains a status and a progress field. ([bug 1866112]({{bugzilla}}1866112)) - Added support for controlling `privacy.globalprivacycontrol.enabled` and `privacy.globalprivacycontrol.pbmode.enabled` and `privacy.globalprivacycontrol.functionality.enabled` via [`GeckoRuntimeSettings.Builder.globalPrivacyControlEnabled`][122.3] - Added named translations exceptions via [`TranslationsException`][122.4]. - Added [`ERROR_UNSUPPORTED_ADDON_TYPE`][122.5] to `WebExtension.InstallException.ErrorCodes`. ([bug 1867873]({{bugzilla}}1867873)) - Added [`WebExtensionController.install`][122.6] requires `WebExtensionController.InstallationMethod`. - Added runtime options to set and get specific "never translate this site" preferences on [`RuntimeTranslation`][121.1]. - Added APIs for toggling `privacy.trackingprotection.emailtracking.pbmode.enabled`. ([bug 1866927]({{bugzilla}}1866927). [122.1]: {{javadoc_uri}}/GeckoSession.html#reportBackInStock(String) [122.2]: {{javadoc_uri}}/GeckoSession.html#requestCreateAnalysis(String) [122.3]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#globalPrivacyControlEnabled(boolean) [122.4]: {{javadoc_uri}}/TranslationsController.TranslationsException.html [122.5]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_UNSUPPORTED_ADDON_TYPE [122.6]: {{javadoc_uri}}/WebExtensionController.WebExtensionController.html#install(java.lang.String,java.lang.String,org.mozilla.geckoview.WebExtensionController.InstallationMethod) ## v121 - Added runtime controller functions. [`RuntimeTranslation`][121.1] has options for retrieving translation languages and managing language models. - Added support for controlling `cookiebanners.service.enableGlobalRules` and `cookiebanners.service.enableGlobalRules.subFrames` via [`GeckoSession.ContentDelegate.cookieBannerGlobalRulesEnabled`][121.2] and [`GeckoSession.ContentDelegate.cookieBannerGlobalRulesSubFramesEnabled`][121.3]. - Added [`GeckoSession.sendClickAttributionEvent`][121.4] for sending click attribution event for a given product recommendation. - Added [`GeckoSession.sendImpressionAttributionEvent`][121.5] for sending impression attribution event for a given product recommendation. - Added support for controlling `privacy.query_stripping.enabled` and `privacy.query_stripping.enabled.pbmode` via [`GeckoSession.ContentDelegate.queryParameterStrippingEnabled`][121.6] and [`GeckoSession.ContentDelegate.queryParameterStrippingPrivateBrowsingEnabled`][121.7]. - Added support for controlling `privacy.query_stripping.allow_list` and `privacy.query_stripping.strip_list` via [`GeckoSession.ContentDelegate.queryParameterStrippingAllowList`][121.8] and [`GeckoSession.ContentDelegate.queryParameterStrippingStripList`][121.9]. - Add [`WebExtensionController.AddonManagerDelegate.onReady`][121.10] ([bug 1859585]({{bugzilla}}1859585). - ⚠️ `WebExtensionController.install` method will not be implicitly awaiting for the installed extension to be fully started anymore, callers of the install method should now expect the `WebExtension.MetaData` properties `baseUrl` and `optionsPageUrl` to be not be defined yet until the `WebExtensionController.AddonManagerDelegate.onReady` delegated method has been called ([bug 1859585]({{bugzilla}}1859585). - Added additional support for translation settings such as: `getLanguageSetting`, `setLanguageSetting`, `getNeverTranslateSiteSetting`,`setNeverTranslateSiteSetting`, on the Translations Controller [121.11], and `getTranslationsOfferPopup`, `setTranslationsOfferPopup` on the Runtime Settings [121.12]. - Added `privacy.trackingprotection.emailtracking.enabled` to strict mode for email tracker blocking in GeckoView. Removed unnecessary string manipulation on STP Pref string. [121.13] ([bug 1856634]({{bugzilla}}1856634). [121.1]: {{javadoc_uri}}/TranslationsController.RuntimeTranslation.html [121.2]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#cookieBannerGlobalRulesEnabled(boolean) [121.3]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#cookieBannerGlobalRulesSubFramesEnabled(boolean) [121.4]: {{javadoc_uri}}/GeckoSession.html#sendClickAttributionEvent(String) [121.5]: {{javadoc_uri}}/GeckoSession.html#sendImpressionAttributionEvent(String) [121.6]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#queryParameterStrippingEnabled(boolean) [121.7]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#queryParameterStrippingPrivateBrowsingEnabled(boolean) [121.8]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#queryParameterStrippingAllowList(String) [121.9]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#queryParameterStrippingStripList(boolean) [121.10]: {{javadoc_uri}}/WebExtensionController.AddonManagerDelegate.html#onReady [121.11]: {{javadoc_uri}}/TranslationsController.html [121.12]: {{javadoc_uri}}/GeckoRuntimeSettings.html [121.13]: {{javadoc_uri}}/Contentblocking.AntiTracking.html#EMAIL ## v120 - Added [`disableExtensionProcessSpawning`][120.1] for disabling the extension process spawning. ([bug 1855405]({{bugzilla}}1855405)) - Added `DisabledFlags.SIGNATURE` for extensions disabled because they aren't correctly signed. ([bug 1847266]({{bugzilla}}1847266)) - Added `Builder` pattern constructors for [`ReviewAnalysis`][120.2] and [`Recommendation`][120.3] (part of [bug 1846341]({{bugzilla}}1846341)) - Added `DisabledFlags.APP_VERSION` for extensions disabled because they aren't compatible with the application version. ([bug 1847266]({{bugzilla}}1847266)) - Added more metadata to the [WebExtension][120.4] class. ([bug 1850674]({{bugzilla}}1850674), [bug 1858925]({{bugzilla}}1858925)) - Added session and translations controller. Includes [`TranslationsController`][120.5], [`TranslationsController.SessionTranslation`][120.6] (notably [translate][120.7]), and a [translations delegate][120.8]. [120.1]: {{javadoc_uri}}/WebExtensionController.html#disableExtensionProcessSpawning [120.2]: {{javadoc_uri}}/GeckoSession.html#ReviewAnalysis.Builder.html [120.3]: {{javadoc_uri}}/GeckoSession.html#Recommendation.Builder.html [120.4]: {{javadoc_uri}}/WebExtension.html) [120.5]: {{javadoc_uri}}/TranslationsController.html [120.6]: {{javadoc_uri}}/TranslationsController.SessionTranslation.html [120.7]: {{javadoc_uri}}/TranslationsController.SessionTranslation.html#translate(java.lang.String,java.lang.String,org.mozilla.geckoview.TranslationsController.SessionTranslation.TranslationOptions) [120.8]: {{javadoc_uri}}/TranslationsController.SessionTranslation.Delegate.html ## v119 - Added `remoteType` to GeckoView child crash intent. ([bug 1851518]({{bugzilla}}1851518)) [119.1]: {{javadoc_uri}}/GeckoSession.html#requestCreateAnalysis(String) [119.2]: {{javadoc_uri}}/GeckoSession.html#requestAnalysisCreationStatus(String) [119.3]: {{javadoc_uri}}/GeckoSession.html#pollForAnalysisCompleted(String) ## v118 - Added [`ExperimentDelegate`][118.1] to allow GeckoView to send and retrieve experiment information from an embedder. - Added [`ERROR_BLOCKLISTED`][118.2] to `WebExtension.InstallException.ErrorCodes`. ([bug 1845745]({{bugzilla}}1845745)) - Added [`ContentDelegate.onProductUrl`][118.3] to notify the app when on a supported product page. - Added [`GeckoSession.requestAnalysis`][118.4] for requesting product review analysis. - Added [`GeckoSession.requestRecommendations`][118.5] for requesting product recommendations given a specific product url. - Added [`ERROR_INCOMPATIBLE`][118.6] to `WebExtension.InstallException.ErrorCodes`. ([bug 1845749]({{bugzilla}}1845749)) - Added [`GeckoRuntimeSettings.Builder.extensionsWebAPIEnabled`][118.7]. ([bug 1847173]({{bugzilla}}1847173)) - Changed [`GeckoSession.AccountSelectorPrompt`][118.8]: added the Provider to which the Account belongs ([bug 1847059]({{bugzilla}}1847059)) - Added [`getExperimentDelegate`][118.9] and [`setExperimentDelegate`][118.10] to the GeckoSession allow GeckoView to get and set the experiment delegate for the session. Default is to use the runtime delegate. - ⚠️ Deprecated [`onGetNimbusFeature`][115.5] by 122, please use `ExperimentDelegate.onGetExperimentFeature` instead. - Added [`GeckoRuntimeSettings.Builder.extensionsProcessEnabled`][118.11] for setting whether extensions process is enabled. ([bug 1843926]({{bugzilla}}1843926)) - Added [`ExtensionProcessDelegate`][118.12] to allow GeckoView to notify disabling of the extension process spawning due to excessive crash/kill. ([bug 1819737]({{bugzilla}}1819737)) - Added [`enableExtensionProcessSpawning`][118.13] for enabling the extension process spawning - Add [`WebExtensionController.AddonManagerDelegate.onInstallationFailed`][118.14] ([bug 1848100]({{bugzilla}}1848100). - Add [`InstallException.extensionName`][118.15] which indicates the name of the extension that caused the exception. [118.1]: {{javadoc_uri}}/ExperimentDelegate.html [118.2]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_BLOCKLISTED [118.3]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onProductUrl(org.mozilla.geckoview.GeckoSession) [118.4]: {{javadoc_uri}}/GeckoSession.html#requestAnalysis(String) [118.5]: {{javadoc_uri}}/GeckoSession.html#requestRecommendations(String) [118.6]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_INCOMPATIBLE [118.7]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#extensionsWebAPIEnabled(boolean) [118.8]: {{javadoc_uri}}/GeckoSession.html#AccountSelectorPrompt [118.9]: {{javadoc_uri}}/GeckoSession.html#getExperimentDelegate() [118.10]: {{javadoc_uri}}/GeckoSession.html#setExperimentDelegate(org.mozilla.geckoview.ExperimentDelegate) [118.11]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#extensionsProcessEnabled(Boolean) [118.12]: {{javadoc_uri}}/WebExtensionController.ExtensionProcessDelegate.html [118.13]: {{javadoc_uri}}/WebExtensionController.html#enableExtensionProcessSpawning [118.14]: {{javadoc_uri}}/WebExtensionController.AddonManagerDelegate.html#onInstallationFailed [118.15]: {{javadoc_uri}}/WebExtension.InstallException.html#extensionName ## v116 - Added [`GeckoSession.didPrintPageContent`][116.1] to included extra print status for a standard print and new `GeckoPrintException.ERROR_NO_PRINT_DELEGATE` - Added [`PromptInstanceDelegate.onSelectIdentityCredentialProvider`][116.2] to allow the user to choose an Identity Credential provider (FedCM) to be used when authenticating. ([bug 1836356]({{bugzilla}}1836356)) - Changed [`Gecko.CrashHandler`] location to [`GeckoView.CrashHandler`][116.3] ([bug 1550206]({{bugzilla}}1550206)) - Added [`PromptInstanceDelegate.onSelectIdentityCredentialAccount`][116.4] to allow the user to choose an account on the Identity Credential Provider (FedCM) they previously chose to be used when authenticating. ([bug 1836363]({{bugzilla}}1836363)) - Added [`PromptInstanceDelegate.onShowPrivacyPolicyIdentityCredential`][116.5] to allow the user to indicate if agrees or not with the privacy policy of the Identity Credential provider. ([bug 1836358]({{bugzilla}}1836358)) [116.1]: {{javadoc_uri}}/GeckoSession.html#didPrintPageContent [116.2]:{{javadoc_uri}}/GeckoSession.PromptDelegate.html#onSelectIdentityCredentialProvider(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.IdentityCredential.ProviderSelectorPrompt) [116.3]:{{javadoc_uri}}/CrashHandler.html [116.4]:{{javadoc_uri}}/GeckoSession.PromptDelegate.html#onSelectIdentityCredentialAccount(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.IdentityCredential.AccountSelectorPrompt) [116.5]:{{javadoc_uri}}/GeckoSession.PromptDelegate.html#onShowPrivacyPolicyIdentityCredential(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.IdentityCredential.PrivacyPolicyPrompt) ## v115 - Changed [`SessionPdfFileSaver.createResponse`][115.1] to response of saving PDF to accept two additional arguments: `skipConfirmation` and `requestExternalApp`. - Added [`GeckoDisplay.NewSurfaceProvider`][115.2] interface, which allows Gecko to request a new rendering Surface from the application. ([bug 1824083]({{bugzilla}}1824083)) - Add [`onPrintWithStatus`][115.3] to retrieve additional printing status information. - Added new [`GeckoPrintException`][115.4] errors of `ERROR_NO_ACTIVITY_CONTEXT` and `ERROR_NO_ACTIVITY_CONTEXT_DELEGATE` - Added [`GeckoSession.ContentDelegate.onGetNimbusFeature`][115.5] - Added [`textContent`][115.6] to [`ContentDelegate.ContextElement`][65.21] and a new [`constructor`][115.7] to [`ContentDelegate.ContextElement`][65.21] - Changed [`SessionPdfFileSaver.createResponse`][115.8] to response of saving PDF to accept an url and return a [`GeckoResult`]. - ⚠️ Deprecated [`GeckoSession.PdfSaveResult`][111.7] [115.1]: {{javadoc_uri}}/SessionPdfFileSaver.html#createResponse(byte[], String, String, boolean, boolean) [115.2]: {{javadoc_uri}}/GeckoDisplay.NewSurfaceProvider.html [115.3]: {{javadoc_uri}}/GeckoSession.PrintDelegate.html#onPrintWithStatus [115.4]: {{javadoc_uri}}/GeckoSession.GeckoPrintException.html [115.5]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onGetNimbusFeature(org.mozilla.geckoview.GeckoSession) [115.6]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#textContent [115.7]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#(java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.String) [115.8]: {{javadoc_uri}}/SessionPdfFileSaver.html#createResponse(GeckoSession, String, String, String, boolean, boolean) ## v114 - Add [`SessionPdfFileSaver.createResponse`][114.1] to response of saving PDF. - Added [`requestExternalApp`][114.2] and [`skipConfirmation`][114.3] with builder fields on a WebResponse to request that a downloaded file be opened in an external application or to skip a confirmation, respectively. - ⚠️ Removed deprecated [`CookieBannerMode.COOKIE_BANNER_MODE_DETECT_ONLY`][111.1] [114.1]: {{javadoc_uri}}/SessionPdfFileSaver.html#createResponse(byte[], String, String) [114.2]: {{javadoc_uri}}/WebResponse.html#requestExternalApp [114.3]: {{javadoc_uri}}/WebResponse.html#skipConfirmation ## v113 - Add `DisplayMdoe` annotation to [`displayMode`][113.1], [`getDisplayMode`][113.2] and [`setDisplayMode`][113.3]. ([bug 1820567]({{bugzilla}}1820567)) - Add `UserAgentMode` annotation to [`userAgentMode`][113.4], [`getUserAgentMode`][113.5] and [`setUserAgentMode`][113.6]. ([bug 1820567]({{bugzilla}}1820567)) - Add `ViewportMode` annotation to [`viewportMode`][113.7], [`getViewportMode`][113.8] and [`setViewportMode`][113.9]. ([bug 1820567]({{bugzilla}}1820567)) - Add [`WebExtensionController.AddonManagerDelegate`][113.10] ([bug 1822763]({{bugzilla}}1822763), [bug 1826739]({{bugzilla}}1826739)) [113.1]: {{javadoc_uri}}/GeckoSessionSettings.Builder.html#displayMode(int) [113.2]: {{javadoc_uri}}/GeckoSessionSettings.html#getDisplayMode() [113.3]: {{javadoc_uri}}/GeckoSessionSettings.html#setDisplayMode(int) [113.4]: {{javadoc_uri}}/GeckoSessionSettings.Builder.html#userAgentMode(int) [113.5]: {{javadoc_uri}}/GeckoSessionSettings.html#getUserAgentMode() [113.6]: {{javadoc_uri}}/GeckoSessionSettings.html#setUserAgentMode(int) [113.7]: {{javadoc_uri}}/GeckoSessionSettings.Builder.html#userViewportMode(int) [113.8]: {{javadoc_uri}}/GeckoSessionSettings.html#getViewportMode() [113.9]: {{javadoc_uri}}/GeckoSessionSettings.html#setViewportMode(int) [113.10]: {{javadoc_uri}}/WebExtensionController.AddonManagerDelegate.html ## v112 - Added `GeckoSession.LOAD_FLAGS_BYPASS_LOAD_URI_DELEGATE`, see ([bug 1809269]({{bugzilla}}1809269)). - Added [`GeckoSession.hasCookieBannerRuleForBrowsingContextTree`][112.1] to expose Gecko API nsICookieBannerService::hasRuleForBrowsingContextTree see ([bug 1806740]({{bugzilla}}1806740)) - Removed deprecated [`Autofill.Node.getDimensions`][110.6] ([bug 1815830]({{bugzilla}}1815830)) [112.1]: {{javadoc_uri}}/GeckoSession.html#hasCookieBannerRuleForBrowsingContextTree() ## v111 - Removed deprecated [`SelectionActionDelegate.Selection.clientRect`][111.10], [`BasicSelectionActionDelegate.mTempMatrix`][111.11] and [`BasicSelectionActionDelegate.mTempRect`][111.12], ([bug 1801615]({{bugzilla}}1801615)) - Added [`GeckoSession.ContentDelegate.cookieBannerHandlingDetectOnlyMode`][111.2] see ([bug 1810742]({{bugzilla}}1810742)) - ⚠️ Deprecated [`CookieBannerMode.COOKIE_BANNER_MODE_DETECT_ONLY`][111.1] - Added [`GeckoView.ActivityContextDelegate`][111.3], `setActivityContextDelegate`, and `getActivityContextDelegate` to `GeckoView` - Added [`GeckoSession.PrintDelegate`][111.4], a [`PrintDocumentAdapter`][111.5], getters and setters for the `PrintDelegate`, and [`printPageContent`] to print [`session content`][111.6] - Added [`GeckoSession.PdfSaveResult`][111.7], a [`SessionPdfFileSaver`][111.8] and [`isPdfJs`][111.9], see ([bug 1810761]({{bugzilla}}1810761)) [111.1]: {{javadoc_uri}}/ContentBlocking.CookieBannerMode.html#COOKIE_BANNER_MODE_DETECT_ONLY [111.2]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#cookieBannerHandlingDetectOnlyMode(boolean) [111.3]: {{javadoc_uri}}/GeckoView.ActivityContextDelegate.html [111.4]: {{javadoc_uri}}/GeckoSession.PrintDelegate.html [111.5]: {{javadoc_uri}}/GeckoViewPrintDocumentAdapter.html [111.6]: {{javadoc_uri}}/GeckoSession.html#printPageContent-- [111.7]: {{javadoc_uri}}/GeckoSession.PdfSaveResult.html [111.8]: {{javadoc_uri}}/SessionPdfFileSaver.html [111.9]: {{javadoc_uri}}/GeckoSession.html#isPdfJs-- [111.10]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.Selection.html#clientRect [111.11]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#mTempMatrix [111.12]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#mTempRect ## v110 - Added [`GeckoSession.ContentDelegate.onCookieBannerDetected`][110.1] and [`GeckoSession.ContentDelegate.onCookieBannerHandled`][110.2] - Added [`CookieBannerMode.COOKIE_BANNER_MODE_DETECT_ONLY`][110.3], for detecting cookie banners but not handle them, see ([bug 1797581]({{bugzilla}}1806188)) - Added [`StorageController.setCookieBannerModeAndPersistInPrivateBrowsingForDomain`][110.4] see ([bug 1804747]({{bugzilla}}1804747)) - Added [`Autofill.Node.getScreenRect`][110.5] for fission compatible. - ⚠️ Deprecated [`Autofill.Node.getDimensions`][110.6]. ([bug 1803733]({{bugzilla}}1803733)) - Added [`ColorPrompt.predefinedValues`][110.7] to expose predefined values by [`datalist`][110.8] element in the color prompt. ([bug 1805616]({{bugzilla}}1805616)) [110.1]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onCookieBannerDetected(org.mozilla.geckoview.GeckoSession) [110.2]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onCookieBannerHandled(org.mozilla.geckoview.GeckoSession) [110.3]: {{javadoc_uri}}/ContentBlocking.CookieBannerMode.html#COOKIE_BANNER_MODE_DETECT_ONLY [110.4]: {{javadoc_uri}}/StorageController.html#setCookieBannerModeAndPersistInPrivateBrowsingForDomain(java.lang.String,int) [110.5]: {{javadoc_uri}}/Autofill.Node.html#getScreenRect() [110.6]: {{javadoc_uri}}/Autofill.Node.html#getDimensions() [110.7]: {{javadoc_uri}}/GeckoSession.PromptDelegate.ColorPrompt.html#predefinedValues [110.8]: https://developer.mozilla.org/en/docs/Web/HTML/Element/datalist ## v109 - Added [`SelectionActionDelegate.Selection.screenRect`][109.1] for fission compatible. - ⚠️ Deprecated [`SelectionActionDelegate.Selection.clientRect`][109.2], [`BasicSelectionActionDelegate.mTempMatrix`][109.3] and [`BasicSelectionActionDelegate.mTempRect`][109.4]. ([bug 1785759]({{bugzilla}}1785759)) - Added [`StorageController.setCookieBannerModeForDomain`][109.5], [`StorageController.getCookieBannerModeForDomain`][109.6] and [`StorageController.removeCookieBannerModeForDomain`][109.7] see ([bug 1797581]({{bugzilla}}1797581)) [109.1]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.Selection.html#screenRect [109.2]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.Selection.html#clientRect [109.3]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#mTempMatrix [109.4]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#mTempRect [109.5]: {{javadoc_uri}}/StorageController.html#setCookieBannerModeForDomain(java.lang.String,int,boolean) [109.6]: {{javadoc_uri}}/StorageController.html#getCookieBannerModeForDomain(java.lang.String,boolean) [109.7]: {{javadoc_uri}}/StorageController.html#removeCookieBannerModeForDomain(java.lang.String,boolean) ## v108 - Added [`ContentBlocking.CookieBannerMode`][108.1]; [`cookieBannerHandlingMode`][108.2] and [`cookieBannerHandlingModePrivateBrowsing`][108.3] to [`ContentBlocking.Settings.Builder`][81.1]; [`getCookieBannerMode`][108.4], [`setCookieBannerMode`][108.5], [`getCookieBannerModePrivateBrowsing`][108.6] and [`setCookieBannerModePrivateBrowsing`][108.7] to [`ContentBlocking.Settings`][81.2] ([bug 1790724]({{bugzilla}}1790724)) - Added [`GeckoSession.GeckoPrintException`][108.9] to improver error reporting while generating a PDF from website, ([bug 1798402]({{bugzilla}}1798402)). - Added [`GeckoSession.containsFormData`][108.10] that returns a `GeckoResult` for whether or not a session has form data, ([bug 1777506]({{bugzilla}}1777506)). [108.1]: {{javadoc_uri}}/ContentBlocking.CookieBannerMode.html [108.2]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#cookieBannerHandlingMode(int) [108.3]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#cookieBannerHandlingModePrivateBrowsing(int) [108.4]: {{javadoc_uri}}/ContentBlocking.Settings.html#getCookieBannerMode() [108.5]: {{javadoc_uri}}/ContentBlocking.Settings.html#setCookieBannerMode(int) [108.6]: {{javadoc_uri}}/ContentBlocking.Settings.html#getCookieBannerModePrivateBrowsing() [108.7]: {{javadoc_uri}}/ContentBlocking.Settings.html#setCookieBannerModePrivateBrowsing(int) [108.9]: {{javadoc_uri}}/GeckoSession.GeckoPrintException.html [108.10]: {{javadoc_uri}}/GeckoSession.html#containsFormData() ## v107 - Removed deprecated [`cookieLifetime`][103.2] - Removed deprecated `setPermission`, see deprecation note in [v90](#v90) ## v106 - Added [`SelectionActionDelegate.onShowClipboardPermissionRequest`][106.1], [`SelectionActionDelegate.onDismissClipboardPermissionRequest`][106.2], [`BasicSelectionActionDelegate.onShowClipboardPermissionRequest`][106.3], [`BasicSelectionActionDelegate.onDismissCancelClipboardPermissionRequest`][106.4] and [`SelectionActionDelegate.ClipboardPermission`][106.5] to handle permission request for reading clipboard data by [`clipboard.readText`][106.6]. ([bug 1776829]({{bugzilla}}1776829)) [106.1]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.html#onShowClipboardPermissionRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.SelectionActionDelegate.ClipboardPermission) [106.2]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.html#onDismissClipboardPermissionRequest(org.mozilla.geckoview.GeckoSession) [106.3]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#onShowClipboardPermissionRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.SelectionActionDelegate.ClipboardPermission) [106.4]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#onDismissClipboardPermission(org.mozilla.geckoview.GeckoSession) [106.5]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.ClipboardPermission.html [106.6]: https://developer.mozilla.org/en-US/docs/Web/API/Clipboard/readText ## v104 - Removed deprecated Autofill.Delegate `onAutofill`, Autofill.Node `fillViewStructure`, `getFocused`, `getId`, `getValue`, `getVisible`, Autofill.NodeData `Autofill.Notify`, Autofill.Session `surfaceChanged`. ([bug 1781180]({{bugzilla}}1781180)) - Removed deprecated `GeckoDisplay.surfaceChanged` functions [[1]][101.4] [[2]][101.5] - Removed deprecated [`GeckoSession.autofill`][102.18]. ([bug 1781180]({{bugzilla}}1781180)) - Removed deprecated [`onLocationChange(2)`][102.3] ([bug 1781180]({{bugzilla}}1781180)) ## v103 - Added [`GeckoSession.saveAsPdf`][103.1] that returns a `GeckoResult` that contains a PDF of the current session's page. - Added missing `@Deprecated` tag for `setPermission`, see deprecation note in [v90](#v90). - ⚠️ Deprecated [`cookieLifetime`][103.2], this feature is not available anymore. [103.1]: {{javadoc_uri}}/GeckoSession.html#saveAsPdf() [103.2]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html#cookieLifetime(int) ## v102 - Added [`DateTimePrompt.stepValue`][102.1] to export [`step`][102.2] attribute of input element. ([bug 1499635]({{bugzilla}}1499635)) - Deprecated [`onLocationChange(2)`][102.3], please use [`onLocationChange(3)`][102.4]. - Added [`GeckoSession.setPriorityHint`][102.5] function to set the session to either high priority or default. - [`WebRequestError.ERROR_HTTPS_ONLY`][102.6] now has error category `ERROR_CATEGORY_NETWORK` rather than `ERROR_CATEGORY_SECURITY`. - ⚠️ The Autofill.Delegate API now receives a [`AutofillNode`][102.7] object instead of the entire [`Node`][102.8] structure. The `onAutofill` delegate method is now split into several methods: [`onNodeAdd`][102.9], [`onNodeBlur`][102.10], [`onNodeFocus`][102.11], [`onNodeRemove`][102.12], [`onNodeUpdate`][102.13], [`onSessionCancel`][102.14], [`onSessionCommit`][102.15], [`onSessionStart`][102.16]. - Added [`PromptInstanceDelegate.onPromptUpdate`][102.17] to allow GeckoView to update current prompts. ([bug 1758800]({{bugzilla}}1758800)) - Deprecated [`GeckoSession.autofill`][102.18], use [`Autofill.Session.autofill`][102.19] instead. ([bug 1770010]({{bugzilla}}1770010)) - Added [`WebRequestError.ERROR_BAD_HSTS_CERT`][102.20] error code to notify the app of a connection to a site that does not allow error overrides. ([bug 1721220]({{bugzilla}}1721220)) [102.1]: {{javadoc_uri}}/GeckoSession.PromptDelegate.DateTimePrompt.html#stepValue [102.2]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/date#step [102.3]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String) [102.4]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String,java.util.List) [102.5]: {{javadoc_uri}}/GeckoSession.html#setPriorityHint(int) [102.6]: {{javadoc_uri}}/WebRequestError.html#ERROR_HTTPS_ONLY [102.7]: {{javadoc_uri}}/Autofill.AutofillNode.html [102.8]: {{javadoc_uri}}/Autofill.Node.html [102.9]: {{javadoc_uri}}/Autofill.Delegate.html#onNodeAdd(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.Autofill.Node,org.mozilla.geckoview.Autofill.NodeData) [102.10]: {{javadoc_uri}}/Autofill.Delegate.html#onNodeBlur(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.Autofill.Node,org.mozilla.geckoview.Autofill.NodeData) [102.11]: {{javadoc_uri}}/Autofill.Delegate.html#onNodeFocus(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.Autofill.Node,org.mozilla.geckoview.Autofill.NodeData) [102.12]: {{javadoc_uri}}/Autofill.Delegate.html#onNodeRemove(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.Autofill.Node,org.mozilla.geckoview.Autofill.NodeData) [102.13]: {{javadoc_uri}}/Autofill.Delegate.html#onNodeUpdate(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.Autofill.Node,org.mozilla.geckoview.Autofill.NodeData) [102.14]: {{javadoc_uri}}/Autofill.Delegate.html#onSessionCancel(org.mozilla.geckoview.GeckoSession) [102.15]: {{javadoc_uri}}/Autofill.Delegate.html#onSessionCommit(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.Autofill.Node,org.mozilla.geckoview.Autofill.NodeData) [102.16]: {{javadoc_uri}}/Autofill.Delegate.html#onSessionStart(org.mozilla.geckoview.GeckoSession) [102.17]: {{javadoc_uri}}/GeckoSession.PromptDelegate.PromptInstanceDelegate.html#onPromptUpdate(org.mozilla.geckoview.GeckoSession.PromptDelegate.BasePrompt) [102.18]: {{javadoc_uri}}/GeckoSession.html#autofill(android.util.SparseArray) [102.19]: {{javadoc_uri}}/Autofill.Session.html#autofill(android.util.SparseArray) [102.20]: {{javadoc_uri}}/WebRequestError.html#ERROR_BAD_HSTS_CERT ## v101 - Added [`GeckoDisplay.surfaceChanged`][101.1] function taking new type [`GeckoDisplay.SurfaceInfo`][101.2]. This allows the caller to provide a [`SurfaceControl`][101.3] object, which must be set on SDK level 29 and above when rendering in to a `SurfaceView`. ([bug 1762424]({{bugzilla}}1762424)) - ⚠️ Deprecated old `GeckoDisplay.surfaceChanged` functions [[1]][101.4] [[2]][101.5]. - Add [`WebExtensionController.optionalPrompt`][101.6] to allow handling of optional permission requests from extensions. [101.1]: {{javadoc_uri}}/GeckoDisplay.html#surfaceChanged(org.mozilla.geckoview.GeckoDisplay.SurfaceInfo) [101.2]: {{javadoc_uri}}/GeckoDisplay.SurfaceInfo.html [101.3]: https://developer.android.com/reference/android/view/SurfaceControl [101.4]: {{javadoc_uri}}/GeckoDisplay.html#surfaceChanged(android.view.Surface,int,int) [101.5]: {{javadoc_uri}}/GeckoDisplay.html#surfaceChanged(android.view.Surface,int,int,int,int) [101.6]: {{javadoc_uri}}/WebExtensionController.html#optionalPrompt(org.mozilla.geckoview.WebExtension.Message,org.mozilla.geckoview.WebExtension) ## v100 - ⚠️ Changed [`GeckoSession.isOpen`][100.1] to `@UiThread`. - [`WebNotification`][100.2] now implements [`Parcelable`][100.3] to support persisting notifications and responding to them while the browser is not running. - Removed deprecated `GeckoRuntime.EXTRA_CRASH_FATAL` - Removed deprecated `MediaSource.rawId` [100.1]: {{javadoc_uri}}/GeckoSession.html#isOpen() [100.2]: {{javadoc_uri}}/WebNotification.html [100.3]: https://developer.android.com/reference/android/os/Parcelable ## v99 - Removed deprecated `GeckoRuntimeSettings.Builder.enterpiseRootsEnabled`. ([bug 1754244]({{bugzilla}}1754244)) ## v98 - Add [`WebRequest.beConservative`][98.1] to allow critical infrastructure to avoid using bleeding-edge network features. ([bug 1750231]({{bugzilla}}1750231)) [98.1]: {{javadoc_uri}}/WebRequest.html#beConservative ## v97 - ⚠️ Deprecated [`MediaSource.rawId`][97.1], which now provides the same string as [`id`][97.2]. ([bug 1744346]({{bugzilla}}1744346)) - Added [`EXTRA_CRASH_PROCESS_TYPE`][97.3] field to `ACTION_CRASHED` intents, and corresponding [`CRASHED_PROCESS_TYPE_*`][97.4] constants, indicating which type of process a crash occured in. ([bug 1743454]({{bugzilla}}1743454)) - ⚠️ Deprecated [`EXTRA_CRASH_FATAL`][97.5]. Use `EXTRA_CRASH_PROCESS_TYPE` instead. ([bug 1743454]({{bugzilla}}1743454)) - Added [`OrientationController`][97.6] to allow GeckoView to handle orientation locking. ([bug 1697647]({{bugzilla}}1697647)) - Added [GeckoSession.goBack][97.7] and [GeckoSession.goForward][97.8] with a `userInteraction` parameter. Updated the default goBack/goForward behaviour to also be considered as a user interaction. ([bug 1644595]({{bugzilla}}1644595)) [97.1]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.MediaSource.html#rawId [97.2]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.MediaSource.html#id [97.3]: {{javadoc_uri}}/GeckoRuntime.html#EXTRA_CRASH_PROCESS_TYPE [97.4]: {{javadoc_uri}}/GeckoRuntime.html#CRASHED_PROCESS_TYPE_MAIN [97.5]: {{javadoc_uri}}/GeckoRuntime.html#EXTRA_CRASH_FATAL [97.6]: {{javadoc_uri}}/OrientationController.html [97.7]: {{javadoc_uri}}/GeckoSession.html#goBack(boolean) [97.8]: {{javadoc_uri}}/GeckoSession.html#goForward(boolean) ## v96 - Added [`onLoginFetch`][96.1] which allows apps to provide all saved logins to GeckoView. ([bug 1733423]({{bugzilla}}1733423)) - Added [`GeckoResult.finally_`][96.2] to unconditionally run an action after the GeckoResult has been completed. ([bug 1736433]({{bugzilla}}1736433)) - Added [`ERROR_INVALID_DOMAIN`][96.3] to `WebExtension.InstallException.ErrorCodes`. ([bug 1740634]({{bugzilla}}1740634)) - Added [`Selection.pasteAsPlainText`][96.4] to paste HTML content as plain text. ([bug 1740414]({{bugzilla}}1740414)) - Removed deprecated Content Blocking APIs. ([bug 1743706]({{bugzilla}}1743706)) [96.1]: {{javadoc_uri}}/Autocomplete.StorageDelegate.html#onLoginFetch() [96.2]: {{javadoc_uri}}/GeckoResult.html#finally_(java.lang.Runnable) [96.3]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_INVALID_DOMAIN [96.4]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.Selection.html#pasteAsPlainText() ## v95 - Added [`GeckoSession.ContentDelegate.onPointerIconChange()`][95.1] to notify the application of changing pointer icon. If the application wants to handle pointer icon, it should override this. ([bug 1672609]({{bugzilla}}1672609)) - Deprecated [`ContentBlockingController`][95.2], use [`StorageController`][95.3] instead. A [`PERMISSION_TRACKING`][95.4] permission is now present in [`onLocationChange`][95.5] for every page load, which can be used to set tracking protection exceptions. ([bug 1714945]({{bugzilla}}1714945)) - Added [`setPrivateBrowsingPermanentPermission`][95.6], which allows apps to set permanent permissions in private browsing (e.g. to set permanent tracking protection permissions in private browsing). ([bug 1714945]({{bugzilla}}1714945)) - Deprecated [`GeckoRuntimeSettings.Builder.enterpiseRootsEnabled`][95.7] due to typo. ([bug 1708815]({{bugzilla}}1708815)) - Added [`GeckoRuntimeSettings.Builder.enterpriseRootsEnabled`][95.8] to replace [`GeckoRuntimeSettings.Builder.enterpiseRootsEnabled`][95.7]. ([bug 1708815]({{bugzilla}}1708815)) - Added [`GeckoSession.ContentDelegate.onPreviewImage`][95.9] to notify the application of a preview image URL. ([bug 1732219]({{bugzilla}}1732219)) [95.1]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onPointerIconChange(org.mozilla.geckoview.GeckoSession,android.view.PointerIcon) [95.2]: {{javadoc_uri}}/ContentBlockingController.html [95.3]: {{javadoc_uri}}/StorageController.java [95.4]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_TRACKING [95.5]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String,java.util.List) [95.6]: {{javadoc_uri}}/StorageController.html#setPrivateBrowsingPermanentPermission(org.mozilla.geckoview.GeckoSession.PermissionDelegate.ContentPermission,int) [95.7]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#enterpiseRootsEnabled(boolean) [95.8]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#enterpriseRootsEnabled(boolean) [95.9]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onPreviewImage(org.mozilla.geckoview.GeckoSession,java.lang.String) ## v94 - Extended [`Autocomplete`][78.7] API to support credit card saving. ([bug 1703976]({{bugzilla}}1703976)) ## v93 - Removed deprecated [`Autocomplete.LoginStorageDelegate`][78.8]. ([bug 1725469]({{bugzilla}}1725469)) - Removed deprecated [`GeckoRuntime.getProfileDir`][90.5]. ([bug 1725469]({{bugzilla}}1725469)) - Added [`PromptInstanceDelegate`][93.1] to allow GeckoView to dismiss stale prompts. ([bug 1710668]({{bugzilla}}1710668)) - Added [`WebRequestError.ERROR_HTTPS_ONLY`][93.2] error code to allow GeckoView display custom HTTPS-only error pages and bypass them. ([bug 1697866]({{bugzilla}}1697866)) [93.1]: {{javadoc_uri}}/GeckoSession.PromptDelegate.PromptInstanceDelegate.html [93.2]: {{javadoc_uri}}/WebRequestError.html#ERROR_HTTPS_ONLY ## v92 - Added [`PermissionDelegate.PERMISSION_STORAGE_ACCESS`][92.1] to control the allowing of third-party frames to access first-party cookies and storage. ([bug 1543720]({{bugzilla}}1543720)) - Added [`ContentDelegate.onShowDynamicToolbar`][92.2] to notify the app that it must fully-expand its dynamic toolbar ([bug 1690296]({{bugzilla}}1690296)) - Removed deprecated `GeckoResult.ALLOW` and `GeckoResult.DENY`. Use [`GeckoResult.allow`][89.8] and [`GeckoResult.deny`][89.9] instead. [92.1]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_STORAGE_ACCESS [92.2]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onShowDynamicToolbar(org.mozilla.geckoview.GeckoSession) ## v91 - Extended [`Autocomplete`][78.7] API to support addresses. ([bug 1699794]({{bugzilla}}1699794)). - Added [`clearDataFromBaseDomain`][91.1] to [`StorageController`][90.2] for clearing site data by base domain. This includes data of associated subdomains and data partitioned via [`State Partitioning`][91.3]. - Removed deprecated `MediaElement` API. [91.1]: {{javadoc_uri}}/StorageController.html#clearDataFromBaseDomain(java.lang.String,long) [91.2]: {{javadoc_uri}}/StorageController.html [91.3]: https://developer.mozilla.org/en-US/docs/Web/Privacy/State_Partitioning ## v90 - Added [`WebNotification.silent`][90.1] and [`WebNotification.vibrate`][90.2] support. See also [Web/API/Notification/silent][90.3] and [Web/API/Notification/vibrate][90.4]. ([bug 1696145]({{bugzilla}}1696145)) - ⚠️ Deprecated [`GeckoRuntime.getProfileDir`][90.5], the API is being kept for compatibility but it always returns null. - Added [`forceEnableAccessibility`][90.6] runtime setting to enable accessibility during testing. ([bug 1701269]({{bugzilla}}1701269)) - Removed deprecated [`GeckoView.onTouchEventForResult`][88.4]. ([bug 1706403]({{bugzilla}}1706403)) - ⚠️ Updated [`onContentPermissionRequest`][90.7] to use [`ContentPermission`][90.8]; added [`setPermission`][90.9] to [`StorageController`][90.10] for modifying existing permissions, and allowed Gecko to handle persisting permissions. - ⚠️ Added a deprecation schedule to most existing content blocking exception functionality; other than [`addException`][90.11], content blocking exceptions should be treated as content permissions going forward. [90.1]: {{javadoc_uri}}/WebNotification.html#silent [90.2]: {{javadoc_uri}}/WebNotification.html#vibrate [90.3]: https://developer.mozilla.org/en-US/docs/Web/API/Notification/silent [90.4]: https://developer.mozilla.org/en-US/docs/Web/API/Notification/vibrate [90.5]: {{javadoc_uri}}/GeckoRuntime.html#getProfileDir() [90.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setForceEnableAccessibility(boolean) [90.7]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#onContentPermissionRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PermissionDelegate.ContentPermission) [90.8]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.ContentPermission.html [90.9]: {{javadoc_uri}}/StorageController.html#setPermission(org.mozilla.geckoview.GeckoSession.PermissionDelegate.ContentPermission,int) [90.10]: {{javadoc_uri}}/StorageController.html [90.11]: {{javadoc_uri}}/ContentBlockingController.html#addException(org.mozilla.geckoview.GeckoSession) ## v89 - Added [`ContentPermission`][89.1], which is used to report what permissions content is loaded with in `onLocationChange`. - Added [`StorageController.getPermissions`][89.2] and [`StorageController.getAllPermissions`][89.3], allowing inspection of what permissions have been set for a given URI and for all URIs. - ⚠️ Deprecated [`NavigationDelegate.onLocationChange`][89.4], to be removed in v92. The new `onLocationChange` callback simply adds permissions information, migration of existing functionality should only require updating the function signature. - Added [`GeckoRuntimeSettings.setEnterpriseRootsEnabled`][89.5] which allows GeckoView to add third party certificate roots from the Android OS CA store. ([bug 1678191]({{bugzilla}}1678191)). - ⚠️ [`GeckoSession.load`][89.6] now throws `IllegalArgumentException` if the session has no [`GeckoSession.NavigationDelegate`][89.7] and the request's `data` URI is too long. If a `GeckoSession` *does* have a `GeckoSession.NavigationDelegate` and `GeckoSession.load` is called with a top-level `data` URI that is too long, [`NavigationDelgate.onLoadError`][89.8] will be called with a [`WebRequestError`][89.9] containing error code [`WebRequestError.ERROR_DATA_URI_TOO_LONG`][89.10]. ([bug 1668952]({{bugzilla}}1668952)) - Extended [`Autocomplete`][78.7] API to support credit cards. ([bug 1691819]({{bugzilla}}1691819)). - ⚠️ Deprecated [`Autocomplete.LoginStorageDelegate`][78.8] with the intention of removing it in GeckoView v93. Please use [`Autocomplete.StorageDelegate`][89.11] instead. ([bug 1691819]({{bugzilla}}1691819)). - Added [`ALLOWED_TRACKING_CONTENT`][89.12] to content blocking API to indicate when unsafe content is allowed by a shim. ([bug 1661330]({{bugzilla}}1661330)) - ⚠️ Added [`setCookieBehaviorPrivateMode`][89.13] to control cookie behavior for private browsing mode independently of normal browsing mode. To maintain current behavior, set this to the same value as [`setCookieBehavior`][89.14] is set to. [89.1]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.ContentPermission.html [89.2]: {{javadoc_uri}}/StorageController.html#getPermissions(java.lang.String) [89.3]: {{javadoc_uri}}/StorageController.html#getAllPermissions() [89.4]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onLocationChange(org.mozilla.geckoview.GeckoSession,java.lang.String) [89.5]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setEnterpriseRootsEnabled(boolean) [89.6]: {{javadoc_uri}}/GeckoSession.html#load(org.mozilla.geckoview.GeckoSession.Loader) [89.7]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html [89.8]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onLoadError(org.mozilla.geckoview.GeckoSession,java.lang.String,org.mozilla.geckoview.WebRequestError) [89.9]: {{javadoc_uri}}/WebRequestError.html [89.10]: {{javadoc_uri}}/WebRequestError.html#ERROR_DATA_URI_TOO_LONG [89.11]: {{javadoc_uri}}/Autocomplete.StorageDelegate.html [89.12]: {{javadoc_uri}}/ContentBlockingController.Event.html#ALLOWED_TRACKING_CONTENT [89.13]: {{javadoc_uri}}/ContentBlocking.Settings.html#setCookieBehaviorPrivateMode(int) [89.14]: {{javadoc_uri}}/ContentBlocking.Settings.html#setCookieBehavior(int) ## v88 - Added [`WebExtension.Download#update`][88.1] that can be used to implement the WebExtension `downloads` API. This method is used to communicate updates in the download status to the Web Extension - Added [`PanZoomController.onTouchEventForDetailResult`][88.2] and [`GeckoView.onTouchEventForDetailResult`][88.3] to tell information that the website doesn't expect browser apps to react the event, also and deprecated [`PanZoomController.onTouchEventForResult`][88.4] and [`GeckoView.onTouchEventForResult`][88.5]. With these new methods browser apps can differentiate cases where the browser can do something the browser's specific behavior in response to the event (e.g. pull-to-refresh) and cases where the browser should not react to the event because the event was consumed in the web site (e.g. in canvas like web apps). ([bug 1678505]({{bugzilla}}1678505)). - ⚠️ Deprecate the [`MediaElement`][65.11] API to be removed in v91. Please use [`MediaSession`][81.6] for media events and control. ([bug 1693584]({{bugzilla}}1693584)). - ⚠️ Deprecate [`GeckoResult.ALLOW`][89.6] and [`GeckoResult.DENY`][89.7] in favor of [`GeckoResult.allow`][89.8] and [`GeckoResult.deny`][89.9]. ([bug 1697270]({{bugzilla}}1697270)). - ⚠️ Update [`SessionState`][88.10] to handle null states/strings more gracefully. ([bug 1685486]({{bugzilla}}1685486)). [88.1]: {{javadoc_uri}}/WebExtension.Download.html#update(org.mozilla.geckoview.WebExtension.Download.Info) [88.2]: {{javadoc_uri}}/PanZoomController.html#onTouchEventForDetailResult [88.3]: {{javadoc_uri}}/GeckoView.html#onTouchEventForDetailResult [88.4]: {{javadoc_uri}}/PanZoomController.html#onTouchEventForResult [88.5]: {{javadoc_uri}}/GeckoView.html#onTouchEventForResult [88.6]: {{javadoc_uri}}/GeckoResult.html#ALLOW [88.7]: {{javadoc_uri}}/GeckoResult.html#DENY [88.8]: {{javadoc_uri}}/GeckoResult.html#allow() [88.9]: {{javadoc_uri}}/GeckoResult.html#deny() [88.10]: {{javadoc_uri}}/GeckoSession.SessionState.html ## v87 - ⚠️ Added [`WebExtension.DownloadInitData`][87.1] class that can be used to implement the WebExtension `downloads` API. This class represents initial state of a download. - Added [`WebExtension.Download.Info`][87.2] interface that can be used to implement the WebExtension `downloads` API. This interface allows communicating download's state to Web Extension. - [`Image#getBitmap`][87.3] now throws [`ImageProcessingException`][87.4] if the image cannot be processed. ([bug 1689745]({{bugzilla}}1689745)) - Added support for HTTPS-only mode to [`GeckoRuntimeSettings`][87.5] via [`setAllowInsecureConnections`][87.6]. - Removed `JSONException` throws from [`SessionState.fromString`][87.7], fixed annotations, and clarified null-handling a bit. [87.1]: {{javadoc_uri}}/WebExtension.DownloadInitData.html [87.2]: {{javadoc_uri}}/WebExtension.Download.Info.html [87.3]: {{javadoc_uri}}/Image.html#getBitmap(int) [87.4]: {{javadoc_uri}}/Image.ImageProcessingException.html [87.5]: {{javadoc_uri}}/GeckoRuntimeSettings.html [87.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setAllowInsecureConnections(int) [87.7]: {{javadoc_uri}}/GeckoSession.SessionState.html#fromString(java.lang.String) ## v86 - Removed deprecated `ContentDelegate#onExternalResponse(GeckoSession, WebResponseInfo)`. Use [`ContentDelegate#onExternalResponse(GeckoSession, WebResponse)`][82.2] instead. ([bug 1665157]({{bugzilla}}1665157)) - Added [`WebExtension.DownloadDelegate`][86.1] and that can be used to implement the WebExtension `downloads` API. ([bug 1656336]({{bugzilla}}1656336)) - Added [`WebRequest.Builder#body(@Nullable String)`][86.2] which converts a string to direct byte buffer. - Removed deprecated `REPLACED_UNSAFE_CONTENT`. ([bug 1667471]({{bugzilla}}1667471)) - Removed deprecated [`GeckoSession#loadUri`][83.6] variants in favor of [`GeckoSession#load`][83.7]. See docs for [`Loader`][83.8]. ([bug 1667471]({{bugzilla}}1667471)) - Added [`GeckoResult#map`][86.3] to synchronously map a GeckoResult value. - Added [`PanZoomController#INPUT_RESULT_IGNORED`][86.4]. ([bug 1687430]({{bugzilla}}1687430)) [86.1]: {{javadoc_uri}}/WebExtension.DownloadDelegate.html [86.2]: {{javadoc_uri}}/WebRequest.Builder#body(java.lang.String) [86.3]: {{javadoc_uri}}/GeckoResult.html#map(org.mozilla.geckoview.GeckoResult.OnValueMapper) [86.4]: {{javadoc_uri}}/PanZoomController.html#INPUT_RESULT_IGNORED ## v85 - Added [`WebExtension.BrowsingDataDelegate`][85.1] that can be used to implement the WebExtension `browsingData` API. [85.1]: {{javadoc_uri}}/WebExtension.BrowsingDataDelegate.html ## v84 - ⚠️ Removed deprecated `GeckoRuntimeSettings.Builder.useMultiprocess` and [`GeckoRuntimeSettings.getUseMultiprocess`]. Single-process GeckoView is no longer supported. ([bug 1650118]({{bugzilla}}1650118)) - Deprecated members now have an additional [`@DeprecationSchedule`][84.1] annotation which includes the `version` that we expect to remove the member and an `id` that can be used to group annotation notices in tooling. ([bug 1671460]({{bugzilla}}1671460)) - ⚠️ Removed deprecated `ContentBlockingController.ExceptionList` and `ContentBlockingController.restoreExceptionList`. ([bug 1674500]({{bugzilla}}1674500)) [84.1]: {{javadoc_uri}}/DeprecationSchedule.html ## v83 - Added [`WebExtension.MetaData.temporary`][83.1] which exposes whether an extension has been installed temporarily, e.g. when using web-ext. ([bug 1624410]({{bugzilla}}1624410)) - ⚠️ Removing unsupported `MediaSession.Delegate.onPictureInPicture` for now. Also, [`MediaSession.Delegate.onMetadata`][83.2] is no longer dispatched for plain media elements. ([bug 1658937]({{bugzilla}}1658937)) - Replaced android.util.ArrayMap with java.util.TreeMap in [`WebMessage`][65.13] to enable case-insensitive handling of the HTTP headers. ([bug 1666013]({{bugzilla}}1666013)) - Added [`ContentBlocking.SafeBrowsingProvider`][83.3] to configure Safe Browsing providers. ([bug 1660241]({{bugzilla}}1660241)) - Added [`GeckoRuntime.ActivityDelegate`][83.4] which allows applications to handle starting external Activities on behalf of GeckoView. Currently this is used to integrate FIDO support for WebAuthn. - Added [`GeckoWebExecutor#FETCH_FLAG_PRIVATE`][83.5]. This new flag allows for private browsing downloads using WebExecutor. ([bug 1665426]({{bugzilla}}1665426)) - ⚠️ Deprecated [`GeckoSession#loadUri`][83.6] variants in favor of [`GeckoSession#load`][83.7]. See docs for [`Loader`][83.8]. ([bug 1667471]({{bugzilla}}1667471)) - Added [`Loader#headerFilter`][83.9] to override the default header filtering behavior. ([bug 1667471]({{bugzilla}}1667471)) [83.1]: {{javadoc_uri}}/WebExtension.MetaData.html#temporary [83.2]: {{javadoc_uri}}/MediaSession.Delegate.html#onMetadata(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.MediaSession,org.mozilla.geckoview.MediaSession.Metadata) [83.3]: {{javadoc_uri}}/ContentBlocking.SafeBrowsingProvider.html [83.4]: {{javadoc_uri}}/GeckoRuntime.ActivityDelegate.html [83.5]: {{javadoc_uri}}/GeckoWebExecutor.html#FETCH_FLAG_PRIVATE [83.6]: {{javadoc_uri}}/GeckoSession.html#loadUri(java.lang.String,org.mozilla.geckoview.GeckoSession,int,java.util.Map) [83.7]: {{javadoc_uri}}/GeckoSession.html#load(org.mozilla.geckoview.GeckoSession.Loader) [83.8]: {{javadoc_uri}}/GeckoSession.Loader.html [83.9]: {{javadoc_uri}}/GeckoSession.Loader.html#headerFilter(int) ## v82 - ⚠️ [`WebNotification.source`][79.2] is now `@Nullable` to account for WebExtension notifications which don't have a `source` field. - ⚠️ Deprecated [`ContentDelegate#onExternalResponse(GeckoSession, WebResponseInfo)`][82.1] with the intention of removing them in GeckoView v85. ([bug 1530022]({{bugzilla}}1530022)) - Added [`ContentDelegate#onExternalResponse(GeckoSession, WebResponse)`][82.2] to eliminate the need to make a second request for downloads and ensure more efficient and reliable downloads in a single request. The second parameter is now a [`WebResponse`][65.15] ([bug 1530022]({{bugzilla}}1530022)) - Added [`Image`][82.3] support for size-dependent bitmap retrieval from image resources. ([bug 1658456]({{bugzilla}}1658456)) - ⚠️ Use [`Image`][82.3] for [`MediaSession`][81.6] artwork and [`WebExtension`][69.5] icon support. ([bug 1662508]({{bugzilla}}1662508)) - Added [`RepostConfirmPrompt`][82.4] to prompt the user for cofirmation before resending POST requests. ([bug 1659073]({{bugzilla}}1659073)) - Removed `Parcelable` support in `GeckoSession`. Use [`ProgressDelegate#onSessionStateChange`][68.29] and [`ProgressDelegate#restoreState`][82.5] instead. ([bug 1650108]({{bugzilla}}1650108)) - ⚠️ Use AndroidX instead of the Android support library. For the public API this only changes the thread and nullable annotation types. - Added [`REPLACED_TRACKING_CONTENT`][82.6] to content blocking API to indicate when unsafe content is shimmed. ([bug 1663756]({{bugzilla}}1663756)) [82.1]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onExternalResponse(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.WebResponseInfo) [82.2]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onExternalResponse(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoResult) [82.3]: {{javadoc_uri}}/Image.html [82.4]: {{javadoc_uri}}/GeckoSession.PromptDelegate.RepostConfirmPrompt.html [82.5]: {{javadoc_uri}}/GeckoSession.html#restoreState(org.mozilla.geckoview.GeckoSession.SessionState) [82.6]: {{javadoc_uri}}/ContentBlockingController.Event.html#REPLACED_TRACKING_CONTENT ## v81 - Added `cookiePurging` to [`ContentBlocking.Settings.Builder`][81.1] and `getCookiePurging` and `setCookiePurging` to [`ContentBlocking.Settings`][81.2]. - Added [`GeckoSession.ContentDelegate.onPaintStatusReset()`][81.3] callback which notifies when valid content is no longer being rendered. - Made [`GeckoSession.ContentDelegate.onFirstContentfulPaint()`][81.4] additionally be called for the first contentful paint following a `onPaintStatusReset()` event, rather than just the first contentful paint of the session. - Removed deprecated `GeckoRuntime.registerWebExtension`. Use [`WebExtensionController.install`][73.1] instead. ⚠️ - Changed [`GeckoView.onTouchEventForResult`][81.5] to return a `GeckoResult`, as it now makes a round-trip to Gecko. The result will be more accurate now, since how content treats the event is now considered. - Added [`MediaSession`][81.6] API for session-based media events and control. [81.1]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html [81.2]: {{javadoc_uri}}/ContentBlocking.Settings.html [81.3]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onPaintStatusReset(org.mozilla.geckoview.GeckoSession) [81.4]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onFirstContentfulPaint(org.mozilla.geckoview.GeckoSession) [81.5]: {{javadoc_uri}}/GeckoView.html#onTouchEventForResult(android.view.MotionEvent) [81.6]: {{javadoc_uri}}/MediaSession.html ## v80 - Removed `GeckoSession.hashCode` and `GeckoSession.equals` overrides in favor of the default implementations. ([bug 1647883]({{bugzilla}}1647883)) - Added `strictSocialTrackingProtection` to [`ContentBlocking.Settings.Builder`][80.1] and `getStrictSocialTrackingProtection` to [`ContentBlocking.Settings`][80.2]. [80.1]: {{javadoc_uri}}/ContentBlocking.Settings.Builder.html [80.2]: {{javadoc_uri}}/ContentBlocking.Settings.html ## v79 - Added `runtime.openOptionsPage` support. For `options_ui.open_in_new_tab == false`, [`TabDelegate.onOpenOptionsPage`][79.1] is called. ([bug 1618058]({{bugzilla}}1619766)) - Added [`WebNotification.source`][79.2], which is the URL of the page or Service Worker that created the notification. - Removed deprecated `WebExtensionController.setTabDelegate` and `WebExtensionController.getTabDelegate` APIs ([bug 1618987]({{bugzilla}}1618987)). - ⚠️ [`RuntimeTelemetry#getSnapshots`][68.10] is removed after deprecation. Use Glean to handle Gecko telemetry. ([bug 1644447]({{bugzilla}}1644447)) - Added [`ensureBuiltIn`][79.3] that ensures that a built-in extension is installed without re-installing. ([bug 1635564]({{bugzilla}}1635564)) - Added [`ProfilerController`][79.4], accessible via [`GeckoRuntime.getProfilerController`][79.5] to allow adding gecko profiler markers. ([bug 1624993]({{bugzilla}}1624993)) - ⚠️ Deprecated `Parcelable` support in `GeckoSession` with the intention of removing in GeckoView v82. ([bug 1649529]({{bugzilla}}1649529)) - ⚠️ Deprecated [`GeckoRuntimeSettings.Builder.useMultiprocess`][79.6] and [`GeckoRuntimeSettings.getUseMultiprocess`][79.7] with the intention of removing them in GeckoView v82. ([bug 1649530]({{bugzilla}}1649530)) [79.1]: {{javadoc_uri}}/WebExtension.TabDelegate.html#onOpenOptionsPage(org.mozilla.geckoview.WebExtension) [79.2]: {{javadoc_uri}}/WebNotification.html#source [79.3]: {{javadoc_uri}}/WebExtensionController.html#ensureBuiltIn(java.lang.String,java.lang.String) [79.4]: {{javadoc_uri}}/ProfilerController.html [79.5]: {{javadoc_uri}}/GeckoRuntime.html#getProfilerController() [79.6]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#useMultiprocess(boolean) [79.7]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getUseMultiprocess() ## v78 - Added [`WebExtensionController.installBuiltIn`][78.1] that allows installing an extension that is bundled with the APK. This method is meant as a replacement for [`GeckoRuntime.registerWebExtension`][67.15], ⚠️ which is now deprecated and will be removed in GeckoView 81. - Added [`CookieBehavior.ACCEPT_FIRST_PARTY_AND_ISOLATE_OTHERS`][78.2] to allow enabling dynamic first party isolation; this will block tracking cookies and isolate all other third party cookies by keying them based on the first party from which they are accessed. - Added `cookieStoreId` field to [`WebExtension.CreateTabDetails`][78.3]. This adds the optional ability to create a tab with a given cookie store ID for its [`contextual identity`][78.4]. ([bug 1622500]({{bugzilla}}1622500)) - Added [`NavigationDelegate.onSubframeLoadRequest`][78.5] to allow intercepting non-top-level navigations. - Added [`BeforeUnloadPrompt`][78.6] to respond to prompts from onbeforeunload. - ⚠️ Refactored `LoginStorage` to the [`Autocomplete`][78.7] API to support login form autocomplete delegation. Refactored `LoginStorage.Delegate` to [`Autocomplete.LoginStorageDelegate`][78.8]. Refactored `GeckoSession.PromptDelegate.onLoginStoragePrompt` to [`GeckoSession.PromptDelegate.onLoginSave`][78.9]. Added [`GeckoSession.PromptDelegate.onLoginSelect`][78.10]. ([bug 1618058]({{bugzilla}}1618058)) - Added [`GeckoRuntimeSettings#setLoginAutofillEnabled`][78.11] to control whether login forms should be automatically filled in suitable situations. [78.1]: {{javadoc_uri}}/WebExtensionController.html#installBuiltIn(java.lang.String) [78.2]: {{javadoc_uri}}/ContentBlocking.CookieBehavior.html#ACCEPT_FIRST_PARTY_AND_ISOLATE_OTHERS [78.3]: {{javadoc_uri}}/WebExtension.CreateTabDetails.html [78.4]: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/contextualIdentities [78.5]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onSubframeLoadRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.NavigationDelegate.LoadRequest) [78.6]: {{javadoc_uri}}/GeckoSession.PromptDelegate.BeforeUnloadPrompt.html [78.7]: {{javadoc_uri}}/Autocomplete.html [78.8]: {{javadoc_uri}}/Autocomplete.LoginStorageDelegate.html [78.9]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onLoginSave(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.AutocompleteRequest) [78.10]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onLoginSelect(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.AutocompleteRequest) [78.11]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setLoginAutofillEnabled(boolean) ## v77 - Added [`GeckoRuntime.appendAppNotesToCrashReport`][77.1] For adding app notes to the crash report. ([bug 1626979]({{bugzilla}}1626979)) - ⚠️ Remove the `DynamicToolbarAnimator` API along with accesors on `GeckoView` and `GeckoSession`. ([bug 1627716]({{bugzilla}}1627716)) [77.1]: {{javadoc_uri}}/GeckoRuntime.html#appendAppNotesToCrashReport(java.lang.String) ## v76 - Added [`GeckoSession.PermissionDelegate.PERMISSION_MEDIA_KEY_SYSTEM_ACCESS`][76.1] to control EME media key access. - [`RuntimeTelemetry#getSnapshots`][68.10] is deprecated and will be removed in 79. Use Glean to handle Gecko telemetry. ([bug 1620395]({{bugzilla}}1620395)) - Added `LoadRequest.isDirectNavigation` to know when calls to [`onLoadRequest`][76.3] originate from a direct navigation made by the app itself. ([bug 1624675]({{bugzilla}}1624675)) [76.1]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_MEDIA_KEY_SYSTEM_ACCESS [76.2]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.LoadRequest.html#isDirectNavigation [76.3]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.html#onLoadRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.NavigationDelegate.LoadRequest) ## v75 - ⚠️ Remove `GeckoRuntimeSettings.Builder#useContentProcessHint`. The content process is now preloaded by default if [`GeckoRuntimeSettings.Builder#useMultiprocess`][75.1] is enabled. - ⚠️ Move `GeckoSessionSettings.Builder#useMultiprocess` to [`GeckoRuntimeSettings.Builder#useMultiprocess`][75.1]. Multiprocess state is no longer determined per session. - Added [`DebuggerDelegate#onExtensionListUpdated`][75.2] to notify that a temporary extension has been installed by the debugger. ([bug 1614295]({{bugzilla}}1614295)) - ⚠️ Removed [`GeckoRuntimeSettings.setAutoplayDefault`][75.3], use [`GeckoSession.PermissionDelegate#PERMISSION_AUTOPLAY_AUDIBLE`][73.12] and [`GeckoSession.PermissionDelegate#PERMISSION_AUTOPLAY_INAUDIBLE`][73.13] to control autoplay. ([bug 1614894]({{bugzilla}}1614894)) - Added [`GeckoSession.reload(int flags)`][75.4] That takes a [load flag][75.5] parameter. - ⚠️ Moved [`ActionDelegate`][75.6] and [`MessageDelegate`][75.7] to [`SessionController`][75.8]. ([bug 1616625]({{bugzilla}}1616625)) - Added [`SessionTabDelegate`][75.9] to [`SessionController`][75.8] and [`TabDelegate`][75.10] to [`WebExtension`][69.5] which receive respectively calls for the session and the runtime. `TabDelegate` is also now per-`WebExtension` object instead of being global. The existing global [`TabDelegate`][75.11] is now deprecated and will be removed in GeckoView 77. ([bug 1616625]({{bugzilla}}1616625)) - Added [`SessionTabDelegate#onUpdateTab`][75.12] which is called whenever an extension calls `tabs.update` on the corresponding `GeckoSession`. [`TabDelegate#onCreateTab`][75.13] now takes a [`CreateTabDetails`][75.14] object which contains additional information about the newly created tab (including the `url` which used to be passed in directly). ([bug 1616625]({{bugzilla}}1616625)) - Added [`GeckoRuntimeSettings.setWebManifestEnabled`][75.15], [`GeckoRuntimeSettings.webManifest`][75.16], and [`GeckoRuntimeSettings.getWebManifestEnabled`][75.17] ([bug 1614894]({{bugzilla}}1603673)), to enable or check Web Manifest support. - Added [`GeckoDisplay.safeAreaInsetsChanged`][75.18] to notify the content of [safe area insets][75.19]. ([bug 1503656]({{bugzilla}}1503656)) - Added [`GeckoResult#cancel()`][75.22], [`GeckoResult#setCancellationDelegate()`][75.22], and [`GeckoResult.CancellationDelegate`][75.23]. This adds the optional ability to cancel an operation behind a pending `GeckoResult`. - Added [`baseUrl`][75.24] to [`WebExtension.MetaData`][75.25] to expose the base URL for all WebExtension pages for a given extension. ([bug 1560048]({{bugzilla}}1560048)) - Added [`allowedInPrivateBrowsing`][75.26] and [`setAllowedInPrivateBrowsing`][75.27] to control whether an extension can run in private browsing or not. Extensions installed with [`registerWebExtension`][67.15] will always be allowed to run in private browsing. ([bug 1599139]({{bugzilla}}1599139)) [75.1]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#useMultiprocess(boolean) [75.2]: {{javadoc_uri}}/WebExtensionController.DebuggerDelegate.html#onExtensionListUpdated() [75.3]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#autoplayDefault(boolean) [75.4]: {{javadoc_uri}}/GeckoSession.html#reload(int) [75.5]: {{javadoc_uri}}/GeckoSession.html#LOAD_FLAGS_NONE [75.6]: {{javadoc_uri}}/WebExtension.ActionDelegate.html [75.7]: {{javadoc_uri}}/WebExtension.MessageDelegate.html [75.8]: {{javadoc_uri}}/WebExtension.SessionController.html [75.9]: {{javadoc_uri}}/WebExtension.SessionTabDelegate.html [75.10]: {{javadoc_uri}}/WebExtension.TabDelegate.html [75.11]: {{javadoc_uri}}/WebExtensionRuntime.TabDelegate.html [75.12]: {{javadoc_uri}}/WebExtension.SessionTabDelegate.html#onUpdateTab(org.mozilla.geckoview.WebExtension,org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.WebExtension.UpdateTabDetails) [75.13]: {{javadoc_uri}}/WebExtension.TabDelegate.html#onNewTab(org.mozilla.geckoview.WebExtension,org.mozilla.geckoview.WebExtension.CreateTabDetails) [75.14]: {{javadoc_uri}}/WebExtension.CreateTabDetails.html [75.15]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#setWebManifestEnabled(boolean) [75.16]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#webManifest(boolean) [75.17]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#getWebManifestEnabled() [75.18]: {{javadoc_uri}}/GeckoDisplay.html#safeAreaInsetsChanged(int,int,int,int) [75.19]: https://developer.mozilla.org/en-US/docs/Web/CSS/env [75.20]: {{javadoc_uri}}/WebExtension.InstallException.ErrorCodes.html#ERROR_POSTPONED [75.21]: {{javadoc_uri}}/GeckoResult.html#cancel() [75.22]: {{javadoc_uri}}/GeckoResult.html#setCancellationDelegate(CancellationDelegate) [75.23]: {{javadoc_uri}}/GeckoResult.CancellationDelegate.html [75.24]: {{javadoc_uri}}/WebExtension.MetaData.html#baseUrl [75.25]: {{javadoc_uri}}/WebExtension.MetaData.html [75.26]: {{javadoc_uri}}/WebExtension.MetaData.html#allowedInPrivateBrowsing [75.27]: {{javadoc_uri}}/WebExtensionController.html#setAllowedInPrivateBrowsing(org.mozilla.geckoview.WebExtension,boolean) ## v74 - Added [`WebExtensionController.enable`][74.1] and [`disable`][74.2] to enable and disable extensions. ([bug 1599585]({{bugzilla}}1599585)) - ⚠️ Added [`GeckoSession.ProgressDelegate.SecurityInformation#certificate`][74.3], which is the full server certificate in use, if any. The other certificate-related fields were removed. ([bug 1508730]({{bugzilla}}1508730)) - Added [`WebResponse#isSecure`][74.4], which indicates whether or not the response was delivered over a secure connection. ([bug 1508730]({{bugzilla}}1508730)) - Added [`WebResponse#certificate`][74.5], which is the server certificate used for the response, if any. ([bug 1508730]({{bugzilla}}1508730)) - Added [`WebRequestError#certificate`][74.6], which is the server certificate used in the failed request, if any. ([bug 1508730]({{bugzilla}}1508730)) - ⚠️ Updated [`ContentBlockingController`][74.7] to use new representation for content blocking exceptions and to add better support for removing exceptions. This deprecates [`ExceptionList`][74.8] and [`restoreExceptionList`][74.9] with the intent to remove them in 76. ([bug 1587552]({{bugzilla}}1587552)) - Added [`GeckoSession.ContentDelegate.onMetaViewportFitChange`][74.10]. This exposes `viewport-fit` value that is CSS Round Display Level 1. ([bug 1574307]({{bugzilla}}1574307)) - Extended [`LoginStorage.Delegate`][74.11] with [`onLoginUsed`][74.12] to report when existing login entries are used for autofill. ([bug 1610353]({{bugzilla}}1610353)) - Added [`WebExtensionController#setTabActive`][74.13], which is used to notify extensions about tab changes ([bug 1597793]({{bugzilla}}1597793)) - Added [`WebExtension.metaData.optionsUrl`][74.14] and [`WebExtension.metaData.openOptionsPageInTab`][74.15], which is the addon metadata necessary to show their option pages. ([bug 1598792]({{bugzilla}}1598792)) - Added [`WebExtensionController.update`][74.16] to update extensions. ([bug 1599581]({{bugzilla}}1599581)) - ⚠️ Replaced `subscription` argument in [`WebPushDelegate.onSubscriptionChanged`][74.17] from a [`WebPushSubscription`][74.18] to the [`String`][74.19] `scope`. [74.1]: {{javadoc_uri}}/WebExtensionController.html#enable(org.mozilla.geckoview.WebExtension,int) [74.2]: {{javadoc_uri}}/WebExtensionController.html#disable(org.mozilla.geckoview.WebExtension,int) [74.3]: {{javadoc_uri}}/GeckoSession.ProgressDelegate.SecurityInformation.html#certificate [74.4]: {{javadoc_uri}}/WebResponse.html#isSecure [74.5]: {{javadoc_uri}}/WebResponse.html#certificate [74.6]: {{javadoc_uri}}/WebRequestError.html#certificate [74.7]: {{javadoc_uri}}/ContentBlockingController.html [74.8]: {{javadoc_uri}}/ContentBlockingController.ExceptionList.html [74.9]: {{javadoc_uri}}/ContentBlockingController.html#restoreExceptionList(org.mozilla.geckoview.ContentBlockingController.ExceptionList) [74.10]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onMetaViewportFitChange(org.mozilla.geckoview.GeckoSession,java.lang.String) [74.11]: {{javadoc_uri}}/LoginStorage.Delegate.html [74.12]: {{javadoc_uri}}/LoginStorage.Delegate.html#onLoginUsed(org.mozilla.geckoview.LoginStorage.LoginEntry,int) [74.13]: {{javadoc_uri}}/WebExtensionController.html#setTabActive [74.14]: {{javadoc_uri}}/WebExtension.MetaData.html#optionsUrl [74.15]: {{javadoc_uri}}/WebExtension.MetaData.html#openOptionsPageInTab [74.16]: {{javadoc_uri}}/WebExtensionController.html#update(org.mozilla.geckoview.WebExtension,int) [74.17]: {{javadoc_uri}}/WebPushController.html#onSubscriptionChange(org.mozilla.geckoview.WebPushSubscription,byte[]) [74.18]: {{javadoc_uri}}/WebPushSubscription.html [74.19]: https://developer.android.com/reference/java/lang/String ## v73 - Added [`WebExtensionController.install`][73.1] and [`uninstall`][73.2] to manage installed extensions - ⚠️ Renamed `ScreenLength.VIEWPORT_WIDTH`, `ScreenLength.VIEWPORT_HEIGHT`, `ScreenLength.fromViewportWidth` and `ScreenLength.fromViewportHeight` to [`ScreenLength.VISUAL_VIEWPORT_WIDTH`][73.3], [`ScreenLength.VISUAL_VIEWPORT_HEIGHT`][73.4], [`ScreenLength.fromVisualViewportWidth`][73.5] and [`ScreenLength.fromVisualViewportHeight`][73.6] respectively. - Added the [`LoginStorage`][73.7] API. Apps may handle login fetch requests now by attaching a [`LoginStorage.Delegate`][73.8] via [`GeckoRuntime#setLoginStorageDelegate`][73.9] ([bug 1602881]({{bugzilla}}1602881)) - ⚠️ [`WebExtension`][69.5]'s constructor now requires a `WebExtensionController` instance. - Added [`GeckoResult.allOf`][73.10] for consuming a list of results. - Added [`WebExtensionController.list`][73.11] to list all installed extensions. - Added [`GeckoSession.PermissionDelegate#PERMISSION_AUTOPLAY_AUDIBLE`][73.12] and [`GeckoSession.PermissionDelegate#PERMISSION_AUTOPLAY_INAUDIBLE`][73.13]. These control autoplay permissions for audible and inaudible videos. ([bug 1577596]({{bugzilla}}1577596)) - Added [`LoginStorage.Delegate.onLoginSave`][73.14] for login storage save requests and [`GeckoSession.PromptDelegate.onLoginStoragePrompt`][73.15] for login storage prompts. ([bug 1599873]({{bugzilla}}1599873)) [73.1]: {{javadoc_uri}}/WebExtensionController.html#install(java.lang.String) [73.2]: {{javadoc_uri}}/WebExtensionController.html#uninstall(org.mozilla.geckoview.WebExtension) [73.3]: {{javadoc_uri}}/ScreenLength.html#VISUAL_VIEWPORT_WIDTH [73.4]: {{javadoc_uri}}/ScreenLength.html#VISUAL_VIEWPORT_HEIGHT [73.5]: {{javadoc_uri}}/ScreenLength.html#fromVisualViewportWidth(double) [73.6]: {{javadoc_uri}}/ScreenLength.html#fromVisualViewportHeight(double) [73.7]: {{javadoc_uri}}/LoginStorage.html [73.8]: {{javadoc_uri}}/LoginStorage.Delegate.html [73.9]: {{javadoc_uri}}/GeckoRuntime.html#setLoginStorageDelegate(org.mozilla.geckoview.LoginStorage.Delegate) [73.10]: {{javadoc_uri}}/GeckoResult.html#allOf(java.util.List) [73.11]: {{javadoc_uri}}/WebExtensionController.html#list() [73.12]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_AUTOPLAY_AUDIBLE [73.13]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_AUTOPLAY_INAUDIBLE [73.14]: {{javadoc_uri}}/LoginStorage.Delegate.html#onLoginSave(org.mozilla.geckoview.LoginStorage.LoginEntry) [73.15]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onLoginStoragePrompt(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.LoginStoragePrompt) ## v72 - Added [`GeckoSession.NavigationDelegate.LoadRequest#hasUserGesture`][72.1]. This indicates if a load was requested while a user gesture was active (e.g., a tap). ([bug 1555337]({{bugzilla}}1555337)) - ⚠️ Refactored `AutofillElement` and `AutofillSupport` into the [`Autofill`][72.2] API. ([bug 1591462]({{bugzilla}}1591462)) - Make `read()` in the `InputStream` returned from [`WebResponse#body`][72.3] timeout according to [`WebResponse#setReadTimeoutMillis()`][72.4]. The default timeout value is reflected in [`WebResponse#DEFAULT_READ_TIMEOUT_MS`][72.5], currently 30s. ([bug 1595145]({{bugzilla}}1595145)) - ⚠️ Removed `GeckoResponse` ([bug 1581161]({{bugzilla}}1581161)) - ⚠️ Removed `actions` and `response` arguments from [`SelectionActionDelegate.onShowActionRequest`][72.6] and [`BasicSelectionActionDelegate.onShowActionRequest`][72.7] ([bug 1581161]({{bugzilla}}1581161)) - Added text selection action methods to [`SelectionActionDelegate.Selection`][72.8] ([bug 1581161]({{bugzilla}}1581161)) - Added [`BasicSelectionActionDelegate.getSelection`][72.9] ([bug 1581161]({{bugzilla}}1581161)) - Changed [`BasicSelectionActionDelegate.clearSelection`][72.10] to public. ([bug 1581161]({{bugzilla}}1581161)) - Added `Autofill` commit support. ([bug 1577005]({{bugzilla}}1577005)) - Added [`GeckoView.setViewBackend`][72.11] to set whether GeckoView should be backed by a [`TextureView`][72.12] or a [`SurfaceView`][72.13]. ([bug 1530402]({{bugzilla}}1530402)) - Added support for Browser and Page Action from the WebExtension API. See [`WebExtension.Action`][72.14]. ([bug 1530402]({{bugzilla}}1530402)) - ⚠️ Split [`ContentBlockingController.Event.LOADED_TRACKING_CONTENT`][72.15] into [`ContentBlockingController.Event.LOADED_LEVEL_1_TRACKING_CONTENT`][72.16] and [`ContentBlockingController.Event.LOADED_LEVEL_2_TRACKING_CONTENT`][72.17]. - Replaced `subscription` argument in [`WebPushDelegate.onPushEvent`][72.18] from a [`WebPushSubscription`][72.19] to the [`String`][72.20] `scope`. - ⚠️ Renamed `WebExtension.ActionIcon` to [`Icon`][72.21]. - Added [`GeckoWebExecutor#FETCH_FLAGS_STREAM_FAILURE_TEST`][72.22], which is a new flag used to immediately fail when reading a `WebResponse` body. ([bug 1594905]({{bugzilla}}1594905)) - Changed [`CrashReporter#sendCrashReport(Context, File, JSONObject)`][72.23] to accept a JSON object instead of a Map. Said object also includes the application name that was previously passed as the fourth argument to the method, which was thus removed. - Added WebXR device access permission support, [`PERMISSION_PERSISTENT_XR`][72.24]. ([bug 1599927]({{bugzilla}}1599927)) [72.1]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.LoadRequest#hasUserGesture [72.2]: {{javadoc_uri}}/Autofill.html [72.3]: {{javadoc_uri}}/WebResponse.html#body [72.4]: {{javadoc_uri}}/WebResponse.html#setReadTimeoutMillis(long) [72.5]: {{javadoc_uri}}/WebResponse.html#DEFAULT_READ_TIMEOUT_MS [72.6]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.html#onShowActionRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.SelectionActionDelegate.Selection) [72.7]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#onShowActionRequest(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.SelectionActionDelegate.Selection) [72.8]: {{javadoc_uri}}/GeckoSession.SelectionActionDelegate.Selection.html [72.9]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#getSelection [72.10]: {{javadoc_uri}}/BasicSelectionActionDelegate.html#clearSelection [72.11]: {{javadoc_uri}}/GeckoView.html#setViewBackend(int) [72.12]: https://developer.android.com/reference/android/view/TextureView [72.13]: https://developer.android.com/reference/android/view/SurfaceView [72.14]: {{javadoc_uri}}/WebExtension.Action.html [72.15]: {{javadoc_uri}}/ContentBlockingController.Event.html#LOADED_TRACKING_CONTENT [72.16]: {{javadoc_uri}}/ContentBlockingController.Event.html#LOADED_LEVEL_1_TRACKING_CONTENT [72.17]: {{javadoc_uri}}/ContentBlockingController.Event.html#LOADED_LEVEL_2_TRACKING_CONTENT [72.18]: {{javadoc_uri}}/WebPushController.html#onPushEvent(org.mozilla.geckoview.WebPushSubscription,byte[]) [72.19]: {{javadoc_uri}}/WebPushSubscription.html [72.20]: https://developer.android.com/reference/java/lang/String [72.21]: {{javadoc_uri}}/WebExtension.Icon.html [72.22]: {{javadoc_uri}}/GeckoWebExecutor.html#FETCH_FLAGS_STREAM_FAILURE_TEST [72.23]: {{javadoc_uri}}/CrashReporter.html#sendCrashReport(android.content.Context,java.io.File,org.json.JSONObject) [72.24]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_PERSISTENT_XR ## v71 - Added a content blocking flag for blocked social cookies to [`ContentBlocking`][70.17]. ([bug 1584479]({{bugzilla}}1584479)) - Added [`onBooleanScalar`][71.1], [`onLongScalar`][71.2], [`onStringScalar`][71.3] to [`RuntimeTelemetry.Delegate`][70.12] to support scalars in streaming telemetry. ⚠️ As part of this change, `onTelemetryReceived` has been renamed to [`onHistogram`][71.4], and [`Metric`][71.5] now takes a type parameter. ([bug 1576730]({{bugzilla}}1576730)) - Added overloads of [`GeckoSession.loadUri`][71.6] that accept a map of additional HTTP request headers. ([bug 1567549]({{bugzilla}}1567549)) - Added support for exposing the content blocking log in [`ContentBlockingController`][71.7]. ([bug 1580201]({{bugzilla}}1580201)) - ⚠️ Added `nativeApp` to [`WebExtension.MessageDelegate.onMessage`][71.8] which exposes the native application identifier that was used to send the message. ([bug 1546445]({{bugzilla}}1546445)) - Added [`GeckoRuntime.ServiceWorkerDelegate`][71.9] set via [`setServiceWorkerDelegate`][71.10] to support [`ServiceWorkerClients.openWindow`][71.11] ([bug 1511033]({{bugzilla}}1511033)) - Added [`GeckoRuntimeSettings.Builder#aboutConfigEnabled`][71.12] to control whether or not `about:config` should be available. ([bug 1540065]({{bugzilla}}1540065)) - Added [`GeckoSession.ContentDelegate.onFirstContentfulPaint`][71.13] ([bug 1578947]({{bugzilla}}1578947)) - Added `setEnhancedTrackingProtectionLevel` to [`ContentBlocking.Settings`][71.14]. ([bug 1580854]({{bugzilla}}1580854)) - ⚠️ Added [`GeckoView.onTouchEventForResult`][71.15] and modified [`PanZoomController.onTouchEvent`][71.16] to return how the touch event was handled. This allows apps to know if an event is handled by touch event listeners in web content. The methods in `PanZoomController` now return `int` instead of `boolean`. - Added [`GeckoSession.purgeHistory`][71.17] allowing apps to clear a session's history. ([bug 1583265]({{bugzilla}}1583265)) - Added [`GeckoRuntimeSettings.Builder#forceUserScalableEnabled`][71.18] to control whether or not to force user scalable zooming. ([bug 1540615]({{bugzilla}}1540615)) - ⚠️ Moved Autofill related methods from `SessionTextInput` and `GeckoSession.TextInputDelegate` into `GeckoSession` and `AutofillDelegate`. - Added [`GeckoSession.getAutofillElements()`][71.19], which is a new method for getting an autofill virtual structure without using `ViewStructure`. It relies on a new class, [`AutofillElement`][71.20], for representing the virtual tree. - Added [`GeckoView.setAutofillEnabled`][71.21] for controlling whether or not the `GeckoView` instance participates in Android autofill. When enabled, this connects an `AutofillDelegate` to the session it holds. - Changed [`AutofillElement.children`][71.20] interface to `Collection` to provide an efficient way to pre-allocate memory when filling `ViewStructure`. - Added [`GeckoSession.PromptDelegate.onSharePrompt`][71.22] to support the WebShare API. ([bug 1402369]({{bugzilla}}1402369)) - Added [`GeckoDisplay.screenshot`][71.23] allowing apps finer grain control over screenshots. ([bug 1577192]({{bugzilla}}1577192)) - Added `GeckoView.setDynamicToolbarMaxHeight` to make ICB size static, ICB doesn't include the dynamic toolbar region. ([bug 1586144]({{bugzilla}}1586144)) [71.1]: {{javadoc_uri}}/RuntimeTelemetry.Delegate.html#onBooleanScalar(org.mozilla.geckoview.RuntimeTelemetry.Metric) [71.2]: {{javadoc_uri}}/RuntimeTelemetry.Delegate.html#onLongScalar(org.mozilla.geckoview.RuntimeTelemetry.Metric) [71.3]: {{javadoc_uri}}/RuntimeTelemetry.Delegate.html#onStringScalar(org.mozilla.geckoview.RuntimeTelemetry.Metric) [71.4]: {{javadoc_uri}}/RuntimeTelemetry.Delegate.html#onHistogram(org.mozilla.geckoview.RuntimeTelemetry.Metric) [71.5]: {{javadoc_uri}}/RuntimeTelemetry.Metric.html [71.6]: {{javadoc_uri}}/GeckoSession.html#loadUri(java.lang.String,java.io.File,java.util.Map) [71.7]: {{javadoc_uri}}/ContentBlockingController.html [71.8]: {{javadoc_uri}}/WebExtension.MessageDelegate.html#onMessage(java.lang.String,java.lang.Object,org.mozilla.geckoview.WebExtension.MessageSender) [71.9]: {{javadoc_uri}}/GeckoRuntime.ServiceWorkerDelegate.html [71.10]: {{javadoc_uri}}/GeckoRuntime#setServiceWorkerDelegate(org.mozilla.geckoview.GeckoRuntime.ServiceWorkerDelegate) [71.11]: https://developer.mozilla.org/en-US/docs/Web/API/Clients/openWindow [71.12]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#aboutConfigEnabled(boolean) [71.13]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onFirstContentfulPaint(org.mozilla.geckoview.GeckoSession) [71.15]: {{javadoc_uri}}/GeckoView.html#onTouchEventForResult(android.view.MotionEvent) [71.16]: {{javadoc_uri}}/PanZoomController.html#onTouchEvent(android.view.MotionEvent) [71.17]: {{javadoc_uri}}/GeckoSession.html#purgeHistory() [71.18]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#forceUserScalableEnabled(boolean) [71.19]: {{javadoc_uri}}/GeckoSession.html#getAutofillElements() [71.20]: {{javadoc_uri}}/AutofillElement.html [71.21]: {{javadoc_uri}}/GeckoView.html#setAutofillEnabled(boolean) [71.22]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onSharePrompt(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.PromptDelegate.SharePrompt) [71.23]: {{javadoc_uri}}/GeckoDisplay.html#screenshot() ## v70 - Added API for session context assignment [`GeckoSessionSettings.Builder.contextId`][70.1] and deletion of data related to a session context [`StorageController.clearDataForSessionContext`][70.2]. ([bug 1501108]({{bugzilla}}1501108)) - Removed `setSession(session, runtime)` from [`GeckoView`][70.5]. With this change, `GeckoView` will no longer manage opening/closing of the [`GeckoSession`][70.6] and instead leave that up to the app. It's also now allowed to call [`setSession`][70.10] with a closed `GeckoSession`. ([bug 1510314]({{bugzilla}}1510314)) - Added an overload of [`GeckoSession.loadUri()`][70.8] that accepts a referring [`GeckoSession`][70.6]. This should be used when the URI we're loading originates from another page. A common example of this would be long pressing a link and then opening that in a new `GeckoSession`. ([bug 1561079]({{bugzilla}}1561079)) - Added capture parameter to [`onFilePrompt`][70.9] and corresponding [`CAPTURE_TYPE_*`][70.7] constants. ([bug 1553603]({{bugzilla}}1553603)) - Removed the obsolete `success` parameter from [`CrashReporter#sendCrashReport(Context, File, File, String)`][70.3] and [`CrashReporter#sendCrashReport(Context, File, Map, String)`][70.4]. ([bug 1570789]({{bugzilla}}1570789)) - Add `GeckoSession.LOAD_FLAGS_REPLACE_HISTORY`. ([bug 1571088]({{bugzilla}}1571088)) - Complete rewrite of [`PromptDelegate`][70.11]. ([bug 1499394]({{bugzilla}}1499394)) - Added [`RuntimeTelemetry.Delegate`][70.12] that receives streaming telemetry data from GeckoView. ([bug 1566367]({{bugzilla}}1566367)) - Updated [`ContentBlocking`][70.13] to better report blocked and allowed ETP events. ([bug 1567268]({{bugzilla}}1567268)) - Added API for controlling Gecko logging [`GeckoRuntimeSettings.debugLogging`][70.14] ([bug 1573304]({{bugzilla}}1573304)) - Added [`WebNotification`][70.15] and [`WebNotificationDelegate`][70.16] for handling Web Notifications. ([bug 1533057]({{bugzilla}}1533057)) - Added Social Tracking Protection support to [`ContentBlocking`][70.17]. ([bug 1568295]({{bugzilla}}1568295)) - Added [`WebExtensionController`][70.18] and [`WebExtensionController.TabDelegate`][70.19] to handle [`browser.tabs.create`][70.20] calls by WebExtensions. ([bug 1539144]({{bugzilla}}1539144)) - Added [`onCloseTab`][70.21] to [`WebExtensionController.TabDelegate`][70.19] to handle [`browser.tabs.remove`][70.22] calls by WebExtensions. ([bug 1565782]({{bugzilla}}1565782)) - Added onSlowScript to [`ContentDelegate`][70.23] which allows handling of slow and hung scripts. ([bug 1621094]({{bugzilla}}1621094)) - Added support for Web Push via [`WebPushController`][70.24], [`WebPushDelegate`][70.25], and [`WebPushSubscription`][70.26]. - Added [`ContentBlockingController`][70.27], accessible via [`GeckoRuntime.getContentBlockingController`][70.28] to allow modification and inspection of a content blocking exception list. [70.1]: {{javadoc_uri}}/GeckoSessionSettings.Builder.html#contextId(java.lang.String) [70.2]: {{javadoc_uri}}/StorageController.html#clearDataForSessionContext(java.lang.String) [70.3]: {{javadoc_uri}}/CrashReporter.html#sendCrashReport(android.content.Context,java.io.File,java.io.File,java.lang.String) [70.4]: {{javadoc_uri}}/CrashReporter.html#sendCrashReport(android.content.Context,java.io.File,java.util.Map,java.lang.String) [70.5]: {{javadoc_uri}}/GeckoView.html [70.6]: {{javadoc_uri}}/GeckoSession.html [70.7]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#CAPTURE_TYPE_NONE [70.8]: {{javadoc_uri}}/GeckoSession.html#loadUri(java.lang.String,org.mozilla.geckoview.GeckoSession,int) [70.9]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html#onFilePrompt(org.mozilla.geckoview.GeckoSession,java.lang.String,int,java.lang.String[],int,org.mozilla.geckoview.GeckoSession.PromptDelegate.FileCallback) [70.10]: {{javadoc_uri}}/GeckoView.html#setSession(org.mozilla.geckoview.GeckoSession) [70.11]: {{javadoc_uri}}/GeckoSession.PromptDelegate.html [70.12]: {{javadoc_uri}}/RuntimeTelemetry.Delegate.html [70.13]: {{javadoc_uri}}/ContentBlocking.html [70.14]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#debugLogging(boolean) [70.15]: {{javadoc_uri}}/WebNotification.html [70.16]: {{javadoc_uri}}/WebNotificationDelegate.html [70.17]: {{javadoc_uri}}/ContentBlocking.html [70.18]: {{javadoc_uri}}/WebExtensionController.html [70.19]: {{javadoc_uri}}/WebExtensionController.TabDelegate.html [70.20]: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/create [70.21]: {{javadoc_uri}}/WebExtensionController.TabDelegate.html#onCloseTab(org.mozilla.geckoview.WebExtension,org.mozilla.geckoview.GeckoSession) [70.22]: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/tabs/remove [70.23]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html [70.24]: {{javadoc_uri}}/WebPushController.html [70.25]: {{javadoc_uri}}/WebPushDelegate.html [70.26]: {{javadoc_uri}}/WebPushSubscription.html [70.27]: {{javadoc_uri}}/ContentBlockingController.html [70.28]: {{javadoc_uri}}/GeckoRuntime.html#getContentBlockingController() ## v69 - Modified behavior of [`setAutomaticFontSizeAdjustment`][69.1] so that it no longer has any effect on [`setFontInflationEnabled`][69.2] - Add [GeckoSession.LOAD_FLAGS_FORCE_ALLOW_DATA_URI][69.14] - Added [`GeckoResult.accept`][69.3] for consuming a result without transforming it. - [`GeckoSession.setMessageDelegate`][69.13] callers must now specify the [`WebExtension`][69.5] that the [`MessageDelegate`][69.4] will receive messages from. - Created [`onKill`][69.7] to [`ContentDelegate`][69.11] to differentiate from crashes. [69.1]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setAutomaticFontSizeAdjustment(boolean) [69.2]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setFontInflationEnabled(boolean) [69.3]: {{javadoc_uri}}/GeckoResult.html#accept(org.mozilla.geckoview.GeckoResult.Consumer) [69.4]: {{javadoc_uri}}/WebExtension.MessageDelegate.html [69.5]: {{javadoc_uri}}/WebExtension.html [69.7]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onKill(org.mozilla.geckoview.GeckoSession) [69.11]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html [69.13]: {{javadoc_uri}}/GeckoSession.html#setMessageDelegate(org.mozilla.geckoview.WebExtension,org.mozilla.geckoview.WebExtension.MessageDelegate,java.lang.String) [69.14]: {{javadoc_uri}}/GeckoSession.html#LOAD_FLAGS_FORCE_ALLOW_DATA_URI ## v68 - Added [`GeckoRuntime#configurationChanged`][68.1] to notify the device configuration has changed. - Added [`onSessionStateChange`][68.29] to [`ProgressDelegate`][68.2] and removed `saveState`. - Added [`ContentBlocking#AT_CRYPTOMINING`][68.3] for cryptocurrency miner blocking. - Added [`ContentBlocking#AT_DEFAULT`][68.4], [`ContentBlocking#AT_STRICT`][68.5], [`ContentBlocking#CB_DEFAULT`][68.6] and [`ContentBlocking#CB_STRICT`][68.7] for clearer app default selections. - Added [`GeckoSession.SessionState.fromString`][68.8]. This can be used to deserialize a `GeckoSession.SessionState` instance previously serialized to a `String` via `GeckoSession.SessionState.toString`. - Added [`GeckoRuntimeSettings#setPreferredColorScheme`][68.9] to override the default color theme for web content ("light" or "dark"). - Added [`@NonNull`][66.1] or [`@Nullable`][66.2] to all fields. - [`RuntimeTelemetry#getSnapshots`][68.10] returns a [`JSONObject`][68.30] now. - Removed all `org.mozilla.gecko` references in the API. - Added [`ContentBlocking#AT_FINGERPRINTING`][68.11] to block fingerprinting trackers. - Added [`HistoryItem`][68.31] and [`HistoryList`][68.32] interfaces and [`onHistoryStateChange`][68.34] to [`HistoryDelegate`][68.12] and added [`gotoHistoryIndex`][68.33] to [`GeckoSession`][68.13]. - [`GeckoView`][70.5] will not create a [`GeckoSession`][65.9] anymore when attached to a window without a session. - Added [`GeckoRuntimeSettings.Builder#configFilePath`][68.16] to set a path to a configuration file from which GeckoView will read configuration options such as Gecko process arguments, environment variables, and preferences. - Added [`unregisterWebExtension`][68.17] to unregister a web extension. - Added messaging support for WebExtension. [`setMessageDelegate`][68.18] allows embedders to listen to messages coming from a WebExtension. [`Port`][68.19] allows bidirectional communication between the embedder and the WebExtension. - Expose the following prefs in [`GeckoRuntimeSettings`][67.3]: [`setAutoZoomEnabled`][68.20], [`setDoubleTapZoomingEnabled`][68.21], [`setGlMsaaLevel`][68.22]. - Added new constant for requesting external storage Android permissions, [`PERMISSION_PERSISTENT_STORAGE`][68.35] - Added `setVerticalClipping` to [`GeckoDisplay`][68.24] and [`GeckoView`][68.23] to tell Gecko how much of its vertical space is clipped. - Added [`StorageController`][68.25] API for clearing data. - Added [`onRecordingStatusChanged`][68.26] to [`MediaDelegate`][68.27] to handle events related to the status of recording devices. - Removed redundant constants in [`MediaSource`][68.28] [68.1]: {{javadoc_uri}}/GeckoRuntime.html#configurationChanged(android.content.res.Configuration) [68.2]: {{javadoc_uri}}/GeckoSession.ProgressDelegate.html [68.3]: {{javadoc_uri}}/ContentBlocking.html#AT_CRYPTOMINING [68.4]: {{javadoc_uri}}/ContentBlocking.html#AT_DEFAULT [68.5]: {{javadoc_uri}}/ContentBlocking.html#AT_STRICT [68.6]: {{javadoc_uri}}/ContentBlocking.html#CB_DEFAULT [68.7]: {{javadoc_uri}}/ContentBlocking.html#CB_STRICT [68.8]: {{javadoc_uri}}/GeckoSession.SessionState.html#fromString(java.lang.String) [68.9]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setPreferredColorScheme(int) [68.10]: {{javadoc_uri}}/RuntimeTelemetry.html#getSnapshots(boolean) [68.11]: {{javadoc_uri}}/ContentBlocking.html#AT_FINGERPRINTING [68.12]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.html [68.13]: {{javadoc_uri}}/GeckoSession.html [68.16]: {{javadoc_uri}}/GeckoRuntimeSettings.Builder.html#configFilePath(java.lang.String) [68.17]: {{javadoc_uri}}/GeckoRuntime.html#unregisterWebExtension(org.mozilla.geckoview.WebExtension) [68.18]: {{javadoc_uri}}/WebExtension.html#setMessageDelegate(org.mozilla.geckoview.WebExtension.MessageDelegate,java.lang.String) [68.19]: {{javadoc_uri}}/WebExtension.Port.html [68.20]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setAutoZoomEnabled(boolean) [68.21]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setDoubleTapZoomingEnabled(boolean) [68.22]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setGlMsaaLevel(int) [68.23]: {{javadoc_uri}}/GeckoView.html#setVerticalClipping(int) [68.24]: {{javadoc_uri}}/GeckoDisplay.html#setVerticalClipping(int) [68.25]: {{javadoc_uri}}/StorageController.html [68.26]: {{javadoc_uri}}/GeckoSession.MediaDelegate.html#onRecordingStatusChanged(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.MediaDelegate.RecordingDevice[]) [68.27]: {{javadoc_uri}}/GeckoSession.MediaDelegate.html [68.28]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.MediaSource.html [68.29]: {{javadoc_uri}}/GeckoSession.ProgressDelegate.html#onSessionStateChange(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.SessionState) [68.30]: https://developer.android.com/reference/org/json/JSONObject [68.31]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.HistoryItem.html [68.32]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.HistoryList.html [68.33]: {{javadoc_uri}}/GeckoSession.html#gotoHistoryIndex(int) [68.34]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.html#onHistoryStateChange(org.mozilla.geckoview.GeckoSession,org.mozilla.geckoview.GeckoSession.HistoryDelegate.HistoryList) [68.35]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#PERMISSION_PERSISTENT_STORAGE ## v67 - Added [`setAutomaticFontSizeAdjustment`][67.23] to [`GeckoRuntimeSettings`][67.3] for automatically adjusting font size settings depending on the OS-level font size setting. - Added [`setFontSizeFactor`][67.4] to [`GeckoRuntimeSettings`][67.3] for setting a font size scaling factor, and for enabling font inflation for non-mobile-friendly pages. - Updated video autoplay API to reflect changes in Gecko. Instead of being a per-video permission in the [`PermissionDelegate`][67.5], it is a [runtime setting][67.6] that either allows or blocks autoplay videos. - Change [`ContentBlocking.AT_AD`][67.7] and [`ContentBlocking.SB_ALL`][67.8] values to mirror the actual constants they encompass. - Added nested [`ContentBlocking`][67.9] runtime settings. - Added [`RuntimeSettings`][67.10] base class to support nested settings. - Added [`baseUri`][67.11] to [`ContentDelegate.ContextElement`][65.21] and changed [`linkUri`][67.12] to absolute form. - Added [`scrollBy`][67.13] and [`scrollTo`][67.14] to [`PanZoomController`][65.4]. - Added [`GeckoSession.getDefaultUserAgent`][67.1] to expose the build-time default user agent synchronously. - Changed [`WebResponse.body`][67.24] from a [`ByteBuffer`][67.25] to an [`InputStream`][67.26]. Apps that want access to the entire response body will now need to read the stream themselves. - Added [`GeckoWebExecutor.FETCH_FLAGS_NO_REDIRECTS`][67.27], which will cause [`GeckoWebExecutor.fetch()`][67.28] to not automatically follow [HTTP redirects][67.29] (e.g., 302). - Moved [`GeckoVRManager`][67.2] into the org.mozilla.geckoview package. - Initial WebExtension support. [`GeckoRuntime#registerWebExtension`][67.15] allows embedders to register a local web extension. - Added API to [`GeckoView`][70.5] to take screenshot of the visible page. Calling [`capturePixels`][67.16] returns a [`GeckoResult`][65.25] that completes to a [`Bitmap`][67.17] of the current [`Surface`][67.18] contents, or an [`IllegalStateException`][67.19] if the [`GeckoSession`][65.9] is not ready to render content. - Added API to capture a screenshot to [`GeckoDisplay`][67.20]. [`capturePixels`][67.21] returns a [`GeckoResult`][65.25] that completes to a [`Bitmap`][67.16] of the current [`Surface`][67.17] contents, or an [`IllegalStateException`][67.18] if the [`GeckoSession`][65.9] is not ready to render content. - Add missing [`@Nullable`][66.2] annotation to return value for [`GeckoSession.PromptDelegate.ChoiceCallback.onPopupResult()`][67.30] - Added `default` implementations for all non-functional `interface`s. - Added [`ContentDelegate.onWebAppManifest`][67.22], which will deliver the contents of a parsed and validated Web App Manifest on pages that contain one. [67.1]: {{javadoc_uri}}/GeckoSession.html#getDefaultUserAgent() [67.2]: {{javadoc_uri}}/GeckoVRManager.html [67.3]: {{javadoc_uri}}/GeckoRuntimeSettings.html [67.4]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setFontSizeFactor(float) [67.5]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html [67.6]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setAutoplayDefault(int) [67.7]: {{javadoc_uri}}/ContentBlocking.html#AT_AD [67.8]: {{javadoc_uri}}/ContentBlocking.html#SB_ALL [67.9]: {{javadoc_uri}}/ContentBlocking.html [67.10]: {{javadoc_uri}}/RuntimeSettings.html [67.11]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#baseUri [67.12]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html#linkUri [67.13]: {{javadoc_uri}}/PanZoomController.html#scrollBy(org.mozilla.geckoview.ScreenLength,org.mozilla.geckoview.ScreenLength) [67.14]: {{javadoc_uri}}/PanZoomController.html#scrollTo(org.mozilla.geckoview.ScreenLength,org.mozilla.geckoview.ScreenLength) [67.15]: {{javadoc_uri}}/GeckoRuntime.html#registerWebExtension(org.mozilla.geckoview.WebExtension) [67.16]: {{javadoc_uri}}/GeckoView.html#capturePixels() [67.17]: https://developer.android.com/reference/android/graphics/Bitmap [67.18]: https://developer.android.com/reference/android/view/Surface [67.19]: https://developer.android.com/reference/java/lang/IllegalStateException [67.20]: {{javadoc_uri}}/GeckoDisplay.html [67.21]: {{javadoc_uri}}/GeckoDisplay.html#capturePixels() [67.22]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onWebAppManifest(org.mozilla.geckoview.GeckoSession,org.json.JSONObject) [67.23]: {{javadoc_uri}}/GeckoRuntimeSettings.html#setAutomaticFontSizeAdjustment(boolean) [67.24]: {{javadoc_uri}}/WebResponse.html#body [67.25]: https://developer.android.com/reference/java/nio/ByteBuffer [67.26]: https://developer.android.com/reference/java/io/InputStream [67.27]: {{javadoc_uri}}/GeckoWebExecutor.html#FETCH_FLAGS_NO_REDIRECTS [67.28]: {{javadoc_uri}}/GeckoWebExecutor.html#fetch(org.mozilla.geckoview.WebRequest,int) [67.29]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Redirections [67.30]: {{javadoc_uri}}/GeckoSession.PromptDelegate.ChoiceCallback.html ## v66 - Removed redundant field `trackingMode` from [`SecurityInformation`][66.6]. Use `TrackingProtectionDelegate.onTrackerBlocked` for notification of blocked elements during page load. - Added [`@NonNull`][66.1] or [`@Nullable`][66.2] to all APIs. - Added methods for each setting in [`GeckoSessionSettings`][66.3] - Added [`GeckoSessionSettings`][66.4] for enabling desktop viewport. Desktop viewport is no longer set by [`USER_AGENT_MODE_DESKTOP`][66.5] and must be set separately. - Added [`@UiThread`][65.6] to [`GeckoSession.releaseSession`][66.7] and [`GeckoSession.setSession`][66.8] [66.1]: https://developer.android.com/reference/android/support/annotation/NonNull [66.2]: https://developer.android.com/reference/android/support/annotation/Nullable [66.3]: {{javadoc_uri}}/GeckoSessionSettings.html [66.4]: {{javadoc_uri}}/GeckoSessionSettings.html [66.5]: {{javadoc_uri}}/GeckoSessionSettings.html#USER_AGENT_MODE_DESKTOP [66.6]: {{javadoc_uri}}/GeckoSession.ProgressDelegate.SecurityInformation.html [66.7]: {{javadoc_uri}}/GeckoView.html#releaseSession() [66.8]: {{javadoc_uri}}/GeckoView.html#setSession(org.mozilla.geckoview.GeckoSession) ## v65 - Added experimental ad-blocking category to `GeckoSession.TrackingProtectionDelegate`. - Moved [`CompositorController`][65.1], [`DynamicToolbarAnimator`][65.2], [`OverscrollEdgeEffect`][65.3], [`PanZoomController`][65.4] from `org.mozilla.gecko.gfx` to [`org.mozilla.geckoview`][65.5] - Added [`@UiThread`][65.6], [`@AnyThread`][65.7] annotations to all APIs - Changed `GeckoRuntimeSettings#getLocale` to [`getLocales`][65.8] and related APIs. - Merged `org.mozilla.gecko.gfx.LayerSession` into [`GeckoSession`][65.9] - Added [`GeckoSession.MediaDelegate`][65.10] and [`MediaElement`][65.11]. This allow monitoring and control of web media elements (play, pause, seek, etc). - Removed unused `access` parameter from [`GeckoSession.PermissionDelegate#onContentPermissionRequest`][65.12] - Added [`WebMessage`][65.13], [`WebRequest`][65.14], [`WebResponse`][65.15], and [`GeckoWebExecutor`][65.16]. This exposes Gecko networking to apps. It includes speculative connections, name resolution, and a Fetch-like HTTP API. - Added [`GeckoSession.HistoryDelegate`][65.17]. This allows apps to implement their own history storage system and provide visited link status. - Added [`ContentDelegate#onFirstComposite`][65.18] to get first composite callback after a compositor start. - Changed `LoadRequest.isUserTriggered` to [`isRedirect`][65.19]. - Added [`GeckoSession.LOAD_FLAGS_BYPASS_CLASSIFIER`][65.20] to bypass the URI classifier. - Added a `protected` empty constructor to all field-only classes so that apps can mock these classes in tests. - Added [`ContentDelegate.ContextElement`][65.21] to extend the information passed to [`ContentDelegate#onContextMenu`][65.22]. Extended information includes the element's title and alt attributes. - Changed [`ContentDelegate.ContextElement`][65.21] `TYPE_` constants to public access. - Changed [`ContentDelegate.ContextElement`][65.21], [`GeckoSession.FinderResult`][65.23] to non-final class. - Update [`CrashReporter#sendCrashReport`][65.24] to return the crash ID as a [`GeckoResult`][65.25]. - Add FirefoxRelay field-detection hinting to Autocomplete interface [65.1]: {{javadoc_uri}}/CompositorController.html [65.2]: {{javadoc_uri}}/DynamicToolbarAnimator.html [65.3]: {{javadoc_uri}}/OverscrollEdgeEffect.html [65.4]: {{javadoc_uri}}/PanZoomController.html [65.5]: {{javadoc_uri}}/package-summary.html [65.6]: https://developer.android.com/reference/android/support/annotation/UiThread [65.7]: https://developer.android.com/reference/android/support/annotation/AnyThread [65.8]: {{javadoc_uri}}/GeckoRuntimeSettings.html#getLocales() [65.9]: {{javadoc_uri}}/GeckoSession.html [65.10]: {{javadoc_uri}}/GeckoSession.MediaDelegate.html [65.11]: {{javadoc_uri}}/MediaElement.html [65.12]: {{javadoc_uri}}/GeckoSession.PermissionDelegate.html#onContentPermissionRequest(org.mozilla.geckoview.GeckoSession,java.lang.String,int,org.mozilla.geckoview.GeckoSession.PermissionDelegate.Callback) [65.13]: {{javadoc_uri}}/WebMessage.html [65.14]: {{javadoc_uri}}/WebRequest.html [65.15]: {{javadoc_uri}}/WebResponse.html [65.16]: {{javadoc_uri}}/GeckoWebExecutor.html [65.17]: {{javadoc_uri}}/GeckoSession.HistoryDelegate.html [65.18]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onFirstComposite(org.mozilla.geckoview.GeckoSession) [65.19]: {{javadoc_uri}}/GeckoSession.NavigationDelegate.LoadRequest.html#isRedirect [65.20]: {{javadoc_uri}}/GeckoSession.html#LOAD_FLAGS_BYPASS_CLASSIFIER [65.21]: {{javadoc_uri}}/GeckoSession.ContentDelegate.ContextElement.html [65.22]: {{javadoc_uri}}/GeckoSession.ContentDelegate.html#onContextMenu(org.mozilla.geckoview.GeckoSession,int,int,org.mozilla.geckoview.GeckoSession.ContentDelegate.ContextElement) [65.23]: {{javadoc_uri}}/GeckoSession.FinderResult.html [65.24]: {{javadoc_uri}}/CrashReporter.html#sendCrashReport(android.content.Context,android.os.Bundle,java.lang.String) [65.25]: {{javadoc_uri}}/GeckoResult.html [api-version]: c87f638c6c41018ef267c4136185d8d9c48bbdd7