1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85
|
// Copyright 2025 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_AUTOFILL_CORE_BROWSER_FILLING_FIELD_FILLING_UTIL_H_
#define COMPONENTS_AUTOFILL_CORE_BROWSER_FILLING_FIELD_FILLING_UTIL_H_
#include <optional>
#include <string>
#include "base/containers/span.h"
#include "components/autofill/core/browser/data_quality/addresses/address_normalizer.h"
#include "components/autofill/core/common/form_field_data.h"
namespace autofill {
// This file contains functions that are generically usefull for filling or
// functions that are used by multiple filling subdirectories.
// Searches for an exact match for `value` in `field_options` and returns it
// if found, or std::nullopt otherwise. Optionally, the caller may pass
// `best_match_index` which will be set to the index of the best match.
// A nullopt value means that no value for filling was found.
std::optional<std::u16string> GetSelectControlValue(
const std::u16string& value,
base::span<const SelectOption> field_options,
std::string* failure_to_fill,
size_t* best_match_index = nullptr);
// Like GetSelectControlValue, but searches within the field values and options
// for `value`. For example, "NC - North Carolina" would match "north carolina".
// A nullopt value means that no value for filling was found.
std::optional<std::u16string> GetSelectControlValueSubstringMatch(
const std::u16string& value,
bool ignore_whitespace,
base::span<const SelectOption> field_options,
std::string* failure_to_fill);
// Like GetSelectControlValue, but searches within the field values and options
// for `value`. First it tokenizes the options, then tries to match against
// tokens. For example, "NC - North Carolina" would match "nc" but not "ca".
// A nullopt value means that no value for filling was found.
std::optional<std::u16string> GetSelectControlValueTokenMatch(
const std::u16string& value,
base::span<const SelectOption> field_options,
std::string* failure_to_fill);
// Gets the numeric `value` to fill into `field`.
// A nullopt value means that no value for filling was found.
std::optional<std::u16string> GetNumericSelectControlValue(
int value,
base::span<const SelectOption> field_options,
std::string* failure_to_fill);
// Returns an obfuscated version of `value`.
std::u16string GetObfuscatedValue(const std::u16string& value);
// Gets the country value to fill in a select control.
// Returns an empty string if no value for filling was found.
std::u16string GetCountrySelectControlValue(
const std::u16string& value,
base::span<const SelectOption> field_options,
std::string* failure_to_fill = nullptr);
// Returns appropriate state value that matches `field`.
// The canonical state is checked if it fits in the field and at last the
// abbreviations are tried. Does not return a state if neither |state_value| nor
// the canonical state name nor its abbreviation fit into the field.
std::u16string GetStateTextForInput(const std::u16string& state_value,
const std::string& country_code,
uint64_t field_max_length,
std::string* failure_to_fill);
// Gets the state value to fill in a select control.
// Returns an empty string if no value for filling was found.
std::u16string GetStateSelectControlValue(
const std::u16string& value,
base::span<const SelectOption> field_options,
const std::string& country_code,
AddressNormalizer* address_normalizer,
std::string* failure_to_fill);
} // namespace autofill
#endif // COMPONENTS_AUTOFILL_CORE_BROWSER_FILLING_FIELD_FILLING_UTIL_H_
|