summaryrefslogtreecommitdiff
path: root/core/java/android/webkit/WebSettings.java
Commit message (Collapse)AuthorAgeFilesLines
* Update WebSettings useragent docs.Torne (Richard Coles)2022-03-031-1/+4
| | | | | | | | | | | Update the WebSettings.setUserAgentString API docs to explicitly specify the effect it has on user agent client hints and related JS APIs. This is not a behaviour change for WebView, just making the docs describe what already happens. Test: make offline-sdk-docs Change-Id: I2db282efc4ee42b931824175abe627e871c4a86c
* WebView: Revise setAlgorithmicDarkeningAllowed JavadocMichael Bai2022-03-021-1/+56
| | | | | | | | | | Revise the javadoc according to API council's feedback in http://b/216369031 Bug: 214741472 Test: m offline-sdk-docs Change-Id: I7eac1511ea522fba193afaad1113ae22286cebdf
* WebView: Rename to set/isAlgorithmicDarkeningAllowedMichael Bai2022-01-261-5/+5
| | | | | | | | | | | | | Rename set/getAllowAlgorithmicDarkening to set/isAlgorithmicDarkeningAllowed according to API council's feedback in http://b/216369031 Javadoc change will be in a separated patch. Bug: 214741472 Test: m, m api-stubs-docs-non-updatable-update-current-api CTS-Coverage-Bug: 214742132 Change-Id: I959508a5b8e18e054d62cd092140aeeaf7f92231
* WebView: Add set/getAlgorithmicDarkening APIsMichael Bai2022-01-211-0/+70
| | | | | | | | | | | | | | | | This patch also deprecates the force dark mode API. WebView can't add CTS test right now because the API's implementation is in Chromium, WebView needs to first define the API in framework, then land the change and drop the APK, afterward, CTS test will be added. Add compat-framework support for this evolution behavior. Bug: 214741472 Test: m, m offline-sdk-docs CTS-Coverage-Bug: 214742132 Change-Id: I5d254deb1f27655ea909fceaa5b09a081d71c763
* Remove WebView AppCache APIs.Torne (Richard Coles)2021-09-141-3/+12
| | | | | | | | | These are no-ops since WebView 95; remove them from the SDK to make it clear to apps that they're nonfunctional. Bug: 199287927 Test: atest CtsWebkitTestCases Change-Id: I498aff6f8a0c2901504d777f597dbf77f982cd3a
* Suppress all hidden abstract methods in constructable classes.Aurimas Liutikas2020-11-111-0/+12
| | | | | | | | | | | | | Having a hidden abstract method for a class that can be extended means that public implementors cannot implement these hidden methods posing a risk that custom implementations will not have required abstract methods resulting in an exception. Bug: 151134792 Test: make update-api Change-Id: I758d12465fabc671be19bedeeceb16885de23c87 Exempt-From-Owner-Approval: large scale suppression of existing issues, no-op in terms of behavior
* Update deprecation note for Application Cache.Torne (Richard Coles)2020-05-181-0/+2
| | | | | | | | | Update the deprecation note for WebSettings.setAppCacheEnabled and related to mention the public blog post about the feature being removed. Fixes: 156409857 Test: m offline-sdk-docs Change-Id: I0481937d665f3f16b61b921aa19e306ba8bb16e0
* Deprecate WebSettings.setAppCacheEnabled and related.Torne (Richard Coles)2020-05-121-1/+7
| | | | | | | | | Chrome will be removing the Application Cache API in future; deprecate the APIs in WebView which allow Android apps to enable it. Test: make offline-sdk-docs Fixes: 156266477 Change-Id: I0feff5289706b5f7985013a18d9cf0e3e6b3ba78
* Android WebView: Deprecate unsafe file urls APIsHazem Ashmawy2020-03-051-30/+45
| | | | | | | | | | | | | Deprecate unsafe: - WebSettings#setAllowUniversalAccessFromFileURLs - WebSettings#setAllowFileAccessFromFileURLs - CookieManager#setAcceptFileSchemeCookies And direct the users to use WebViewAssetLoader instead. Bug: 148841999 Test: m offline-sdk-docs -j20 Change-Id: I607d1343cb2aa5baead49ceff6dbac4a4474009c
* WebView: Update setAllowFileAccess doc to reflect new default valueHazem Ashmawy2020-02-261-4/+16
| | | | | | | | | | | Update setAllowFileAccess java docs to reflect that it's now disabled by default after merging crrev.com/c/2056824. Also add a note to use androidx WebViewAssetLoader instead. Bug: 148840827 Test: m offline-sdk-docs -j20 Change-Id: I15866ab63818771fd91f40828846d6b4c39d278e (cherry picked from commit 47a4c2da51e9ffc3cdc71951c7aa927b492e0797)
* Use new UnsupportedAppUsage annotation.Artur Satayev2019-12-181-1/+1
| | | | | | | | Existing annotations in libcore/ and frameworks/ will deleted after the migration. This also means that any java library that compiles @UnsupportedAppUsage requires a direct dependency on "unsupportedappusage" java_library. Bug: 145132366 Test: m && diff unsupportedappusage_index.csv Change-Id: I5be7335b23a92b8ac80d2fd890198273b66ad644
* WebView: note deprecation of onscreen zoom controls.Torne (Richard Coles)2019-10-251-1/+6
| | | | | | | | | | | Inform developers that having onscreen zoom controls is deprecated and that it's therefore not recommended to enable them in WebView, with reference to ZoomButtonsController (which is what WebView uses to implement them). Bug: 141732094 Test: make ds-docs Change-Id: I134551b87d3a93072e28aef56667507214b3e9c4
* [WebView] Minor javadoc fix for WebSettings.Anna Malova2019-09-251-22/+23
| | | | | | | | No change to logic. Test: N/A Bug:132394762 Change-Id: I957b0d8a03cd937b38611e32f6c012b01a6ad7da
* Update WebSettings.setSaveFormData deprecated docTao Bai2019-07-091-1/+3
| | | | | | Bug:69150750 Test: passed sdk build. Change-Id: Ia33ef5eda9956bf60dabc51a592ff6e9ec697b4a
* [wv-docs] Document force dark default, and behaviour of FORCE_DARK_AUTOTobias Sargeant2019-03-201-4/+9
| | | | | | | | | | This adds a reference to the View method that controls framework force dark, which impacts how FORCE_DARK_AUTO is interpreted. It also documents that FORCE_DARK_AUTO is the default. Test: documentation only change Fixes: 128704481 Change-Id: I88e7996362da5b092b269c313e37ef9253b12872
* [webview] Rename force dark WebView settings.Tobias Sargeant2019-03-111-9/+9
| | | | | | | | | Per API council request, remove setForceDarkMode -> setForceDark to align with other framework naming. Bug: 120599879 Test: None Change-Id: I3f4ed00303d7e4b7d0651a384324a8b265663290
* [webview] Add a force dark WebSettingTobias Sargeant2018-12-061-0/+53
| | | | | | | | | | | | Force dark mode is a tristate: - never invert colours for webview content - always invert colours - follow the parent view behaviour Test: CTS test, after WebView implementation. Bug: 120599879 Change-Id: Ib11358bc3a3cbc5e55c0ec184084c7d205acf60c
* Add @UnsupportedAppUsage annotationsMathew Inwood2018-08-161-0/+6
| | | | | | | | | | | | | | | | For packages: android.webkit This is an automatically generated CL. See go/UnsupportedAppUsage for more details. Exempted-From-Owner-Approval: Mechanical changes to the codebase which have been approved by Android API council and announced on android-eng@ Bug: 110868826 Test: m Change-Id: I41643e1e47391a12b0aed3058b3d9987a8e6ee2f
* Clarify WebView's lack of plugin support.Torne (Richard Coles)2018-06-281-2/+6
| | | | | | | | Update docs to clarify that plugins are in fact not supported from K onward and that enabling them doesn't do anything. Test: m offline-sdk-docs Change-Id: I8678ea716be0adc4cd3a6fae1b4776e312ec29e0
* Merge "WebView: document Safe Browsing as 'on' by default"TreeHugger Robot2018-01-251-8/+8
|\
| * WebView: document Safe Browsing as 'on' by defaultNate Fischer2018-01-181-8/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | WebView Safe Browsing will be on by default. While previously it was opt-in (applications needed to enable via manifest or API), now it is an opt-out feature. This CL updates documentation to mention that the feature is on by default and provides steps for applications to opt-out if necessary. This also makes the case of "Safe Browsing" consistent across documentation. Bug: 69579509 Test: make docs (manually verify) Change-Id: I77683a684cd79d2e3cd313ddbff8c52fe510b72b
* | WebView: fix docs for setAllow*AccessFromFileUrlsNate Fischer2018-01-231-9/+9
|/ | | | | | | | | | | | | | | | | | | | | | | | No change to behavior, only docs change. The docs for setAllow(File|Universal)AccessFromFileUrls were previously wrong. They implied that: * Default value is 'false' when SDK_INT > Jellybean * APIs were added in Jellybean (so they can't be called pre-Jellybean) * Therefore, setAllow*AccessFromFileUrls(false) is always a NOOP Actually, WebView examines targetSdk, not SDK_INT. So apps should call setAllow*AccessFromFileUrls(false) when targeting ICE_CREAM_SANDWICH_MR1 and below. The docs previously had mixed use of ICE_CREAM_SANDWICH and ICE_CREAM_SANDWICH_MR1. This corrects the docs to use the right one (ICE_CREAM_SANDWICH_MR1). Lastly, this fixes a minor grammar mistake (misplaced comma). Test: make docs (manually verify) Change-Id: I206dff54a8c342ae7b47bd40d69d0b01dbad3cc6
* Add more IntDef prefixes for auto-documenting.Jeff Sharkey2017-12-131-8/+13
| | | | | | | Test: builds, boots Bug: 70177949 Exempt-From-Owner-Approval: annotation-only changes Change-Id: I76dde6054e06f52240bd4b1a0f196dcb74623608
* WebView: misc docs changes for WebSettingsNate Fischer2017-11-171-15/+15
| | | | | | | | | | | | | No change to logic, only docs changes. This is mostly just formatting changes to documentation. Changes fall into a few categories: * Linkify ({@link}) or codify ({@code}) * Spelling errors Test: make docs (looks better) Change-Id: Ibcd762ab06e51451a53bbce5860cc137bee22ccf
* Merge "WebView: add @Nullable and @NonNull annotations"TreeHugger Robot2017-09-261-1/+2
|\
| * WebView: add @Nullable and @NonNull annotationsNate Fischer2017-09-211-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This adds @Nullable and @NonNull annotations where the docs previously stated this. This change should be safe, since we already disallowed null values for the @NonNull parameters via documentation. I verified that documentation changes for APIs which previously did not mention null-ness in @param or @return Javadocs (if the API already mentioned it in these spots, then DroidDoc prefers the hand-written description). This also fixes various lint errors. Bug: 65465498 Test: make update-api and manually verify docs Change-Id: I4751508d0e72be8ddfc3d6b601db8c307c9df60e
* | Merge "WebView: remove "</p>" tags from docs"Nate Fischer2017-09-141-2/+0
|\ \ | |/ |/|
| * WebView: remove "</p>" tags from docsNate Fischer2017-09-111-2/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Docs change only, no change to logic. This removes closing "</p>" tags from WebView API docs, as per API guidelines. This also adds a trailing newline to a <pre> block for consistency. Other than the modified <pre> block, this has no reader-visible change, it merely complies with best practices from Android API guidelines. Bug: 65381884 Test: make docs (and manually compare before/after for differences) Change-Id: I2f911a43b88a8897d9d1b5c7945360580491883d
* | WebView: wrap Java literals with {@code}Nate Fischer2017-09-051-60/+60
|/ | | | | | | | | | | | | | | | Docs change only. This wraps some Java literals (true, false, null) with {@code} blocks, as per Android API guidelines. This also addresses other presubmit errors: * fix lines that have become too long * fix broken import order and unused imports Bug: 65213517 Test: make docs (and manually verify things look better) Change-Id: Idc7fe28d40bea7bd1edcad539b75fa9c689b8d46
* WebView: update SafeBrowsing documentationNate Fischer2017-07-271-7/+5
| | | | | | | | | | | | No change in logic, only docs changes: * Docs about Safe Browsing feature as a whole. * Expand the docs for initSafeBrowsing/shutdownSafeBrowsing Bug: 63660204 Bug: 62192626 Test: make update-api and manually check javadocs Change-Id: I6526a0f1ce1327f6eff416c27ded89866587f173
* Add an API to enable disable safebrowsing in WebViewSelim Gurun2017-04-071-0/+30
| | | | | | | | | | WebView safebrowsing can be opted in using a manifest value. However, we also need to control individual WebViews. Bug:37158813 Test: See change I71e813bccc2fab73d100384661128c7311dd396c Change-Id: I647dc304787d6406691b5cbadf1c9a4f13ac5604
* Disable WebView autocomplete feature.Selim Gurun2017-04-041-1/+10
| | | | | | | | | | Platform is now providing autofill feature. Disable WebView's simple form data save feature for platform O and above. Test: Removing the functionality and the test Bug: 36869838 Change-Id: If6b9fc12edbe4146fca99d9c6ef8fde36d61f852
* Add missing @Deprecated annotations.Aurimas Liutikas2016-05-241-0/+4
| | | | | | | Add missing @Deprecated annotations for methods with @deprecated tag in javadoc. Change-Id: I35b78ccb97832d86b914c21a300444ba29e33844
* [WebView] Update ServiceWorker related documentation.Tim Volodine2016-05-031-3/+8
| | | | | | | Add some clarifying documentation and usage example. BUG: 28296205 Change-Id: Ib1695822e3d361b17fc4d8a9a3f24a14e34f40ec
* API Review: Add @IntDef and other annotations to Menu Item flags.Hui Shu2016-04-211-3/+23
| | | | | BUG: 28296254 Change-Id: I11f77ae36b24f97948f55887d2ba111220afcf80
* Deprecate setGeolocationDatabasePath because it is no-op since KitKatHui Shu2016-01-071-6/+3
| | | | | | | Also updated the documentation of setGeolocationEnabled. BUG: crbug.com/507505 Change-Id: I5f4bb38189338f58dcd4c1ba0310493aeac5cbd2
* Add the APIs for customizing WebView action mode menu actionsHui Shu2015-10-221-0/+46
| | | | | | | | | | We will allow apps to disable Share, Web Search, and text processing related menu actions. The default actions like cut, copy, paste cannot be disabled. BUG: 22772178 Change-Id: I8429454f71f74a99298f412862cd32d8fba93784
* Enhance documentation of WebSettings.WebSettings methodMikhail Naganov2015-07-071-0/+6
| | | | | | | | | Add a note about WebView reloading the page if the UA string is change during loading. See crbug.com/315891. Bug: 22325430 Change-Id: I04f5ab703fd2dcedf0709e4aa1d17b1204df355b
* Address API council feedback for setOffscreenPreRaster.Hui Shu2015-05-131-3/+5
| | | | | BUG: 21043955 Change-Id: I6481f5f84c9e00c16caeb2d9e175aa869600c715
* am 1009c8de: am 92ae292e: Merge "docs: Add text to JavaDocs regarding ↵Joe Fernandez2015-04-231-2/+6
|\ | | | | | | | | | | | | browser file access vulnerability" into lmp-mr1-ub-docs * commit '1009c8de23920c4a368edf7f1e2ecde63e40ec82': docs: Add text to JavaDocs regarding browser file access vulnerability
| * docs: Add text to JavaDocs regarding browser file access vulnerabilityJoe Fernandez2015-04-221-2/+6
| | | | | | | | | | | | b/17420682 Change-Id: Ic03b51778280570be65ae933fd906b140acdf023
* | Merge "Add API for WebView OffscreenPreRaster setting."Hui Shu2015-03-131-0/+21
|\ \
| * | Add API for WebView OffscreenPreRaster setting.Hui Shu2015-03-121-0/+21
| |/ | | | | | | | | BUG: 19592029 Change-Id: Ic903b823e5f7830e2cf2d4f3dd9a5458334648a3
* / Fix typo in WebSettings javadoc.Torne (Richard Coles)2015-03-061-2/+2
|/ | | | | | | We accidentally repeated the same enum value twice; fixed to mention the three values correctly. Change-Id: Iba6a7edd8e1a5b429728056a8f56634427758c73
* [WebView] Allow the WebView to be compiled against the system SDK.Ignacio Solla2014-11-121-292/+108
| | | | | BUG:18152150 Change-Id: Ifd6dcac17663631058d895c61bb6e8018c5aeecc
* Remove the default WebView text encoding resource entirely.Marcin Kosiba2014-10-101-1/+2
| | | | | | | | | | Having the default text encoding in config.xml makes it seem like it's something that could be changed, but upon further inspection we can't see any good reason for anyone to ever want to change it from UTF-8. BUG: 17634120 Change-Id: I10a09ab1d65590c29efb10222abfa08ca52b5c84
* Put in real "code" (aka marketing) name.Dianne Hackborn2014-10-071-2/+2
| | | | Change-Id: Idb3976edfae37293ed75cb5b869b4b42d8042bbe
* Tag hole-punching api with @SystemApi.Yuncheol Heo2014-07-101-0/+3
| | | | Change-Id: I50c27c32abd7e6d2404c451fb53cfb1379b88e00
* Add Third Party Cookie APIHector Dearman2014-06-251-0/+18
| | | | | Bug: 11678084 Change-Id: Ieb74fb6caae3d5a18dbfe748be47ebebad003cf7
* Add API definition for ↵Yuncheol Heo2014-05-231-0/+32
| | | | | | | | | | WebSettings.setVideoOverlayForEmbeddedEncryptedVideoEnabled. Introduces an API to control the hole-punching for the embedded encrypted media. Bug: 14598993 Change-Id: I6b473e5b38b0bcc243f43dfeba0c2037fcd37af5