From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- .../extensions/formautofill/docs/heuristics.rst | 36 ++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 browser/extensions/formautofill/docs/heuristics.rst (limited to 'browser/extensions/formautofill/docs/heuristics.rst') diff --git a/browser/extensions/formautofill/docs/heuristics.rst b/browser/extensions/formautofill/docs/heuristics.rst new file mode 100644 index 0000000000..cf6e49da39 --- /dev/null +++ b/browser/extensions/formautofill/docs/heuristics.rst @@ -0,0 +1,36 @@ +Form Autofill Heuristics +======================== + +Form Autofill Heuristics module is for detecting the field type based on `autocomplete attribute `_, `the regular expressions `_ and the customized logic in each parser. + +Debugging +--------- + +The pref ``extensions.formautofill.heuristics.enabled`` is "true" in default. Set it to "false" could be useful to verify the result of autocomplete attribute. + +Dependent APIs +-------------- + +``element.getAutocompleteInfo()`` provides the parsed result of ``autocomplete`` attribute which includes the field name and section information defined in `autofill spec `_ + +Regular Expressions +------------------- + +This section is about how the regular expression is applied during parsing fields. All regular expressions are in `heuristicsRegexp.js `_. + +Parser Implementations +---------------------- + +The parsers are for detecting the field type more accurately based on the near context of a field. Each parser uses ``FieldScanner`` to traverse the interested fields with the result from the regular expressions and adjust each field type when it matches to a grammar. + +* _parsePhoneFields + + * related type: ``tel``, ``tel-*`` + +* _parseAddressFields + + * related type: ``address-line[1-3]`` + +* _parseCreditCardExpirationDateFields + + * related type: ``cc-exp``, ``cc-exp-month``, ``cc-exp-year`` -- cgit v1.2.3