Работа с автозаполнением браузера

Автозаполнение браузера в сочетании с маскирующим вводом создает одну из наиболее нестабильных зон при работе с Cleave.js. Основная причина заключается в том, что механизм автозаполнения изменяет значение DOM-элемента напрямую, минуя привычные события пользовательского ввода и внутренние хуки форматирования.

Cleave.js, в свою очередь, рассчитан на перехват input-событий и немедленное преобразование значения в форматированный вид. При автозаполнении эти два механизма часто вступают в конфликт:

  • браузер вставляет уже готовое значение;
  • Cleave.js пытается применить маску повторно;
  • происходит двойное форматирование или скачкообразное изменение курсора;
  • события onValueChanged могут срабатывать с неконсистентными данными.

Особенно заметно это при работе с полями:

  • номера банковских карт;
  • телефоны;
  • даты;
  • коды подтверждения.

Момент инициализации Cleave.js относительно autofill

Ключевая проблема автозаполнения — неопределенный момент его срабатывания. Браузер может заполнить поле:

  • до загрузки скриптов;
  • сразу после установки autocomplete;
  • после фокусировки;
  • при восстановлении сессии страницы.

Если Cleave.js инициализируется слишком рано, он может получить пустое значение и не обработать уже вставленные данные.

Типичный проблемный сценарий:

const input = document.querySelector('#card');

const cleave = new Cleave(input, {
  creditCard: true,
  onValueChanged: function (e) {
    console.log(e.target.value);
  }
});

Если браузер вставляет значение после этого, Cleave.js может не корректно применить форматирование, либо применить его дважды.

Отложенная инициализация как базовый механизм синхронизации

Одним из устойчивых подходов является отложенная инициализация после событий, связанных с автозаполнением.

На практике используются следующие сигналы:

  • focus
  • DOMContentLoaded
  • load
  • requestAnimationFrame
  • setTimeout с минимальной задержкой

Пример отложенной инициализации:

const input = document.querySelector('#phone');

function initMask() {
  new Cleave(input, {
    phone: true,
    phoneRegionCode: 'KZ'
  });
}

window.addEventListener('load', () => {
  setTimeout(initMask, 50);
});

Такая задержка позволяет браузеру завершить возможное автозаполнение до вмешательства Cleave.js.

Работа с событием input и принудительная синхронизация состояния

Автозаполнение не всегда вызывает полный набор событий, ожидаемых библиотекой. Поэтому требуется дополнительная синхронизация через input.

Распространенная стратегия:

const input = document.querySelector('#date');

const cleave = new Cleave(input, {
  date: true,
  datePattern: ['d', 'm', 'Y']
});

input.addEventListener('input', () => {
  cleave.setRawValue(input.value);
});

Однако такой подход требует осторожности. В некоторых браузерах input.value уже содержит форматированное значение, и повторное применение setRawValue приводит к накоплению артефактов.

Проблема двойного форматирования при autofill

Наиболее частый дефект выглядит следующим образом:

  1. браузер вставляет 4111111111111111;
  2. Cleave.js форматирует → 4111 1111 1111 1111;
  3. событие input повторно триггерит форматирование;
  4. результат становится некорректным или курсор скачет.

Для предотвращения этого используется проверка состояния изменения:

let isAutofill = false;

input.addEventListener('animationstart', (e) => {
  if (e.animationName === 'onAutoFillStart') {
    isAutofill = true;
  }
});

input.addEventListener('input', () => {
  if (isAutofill) {
    isAutofill = false;
    return;
  }
});

Этот паттерн основан на CSS-анимациях, которые многие браузеры используют для сигнализации autofill.

Использование CSS-хаков для детекции автозаполнения

Некоторые браузеры (особенно Chromium) применяют псевдокласс :-webkit-autofill. Он позволяет косвенно отследить момент заполнения.

@keyframes autofillStart {
  from {}
  to {}
}

input:-webkit-autofill {
  animation-name: autofillStart;
  animation-duration: 0.01s;
}
input.addEventListener('animationstart', (e) => {
  if (e.animationName === 'autofillStart') {
    // автозаполнение произошло
  }
});

Данный метод используется как триггер для повторной инициализации Cleave.js или для временного отключения форматирования.

Временное отключение форматирования при автозаполнении

В некоторых случаях целесообразно отключать маску на короткий промежуток времени.

Cleave.js не предоставляет прямого флага disable/enable, поэтому применяется пересоздание экземпляра:

let cleaveInstance = null;

function enableMask() {
  cleaveInstance = new Cleave(input, {
    numericOnly: true,
    blocks: [4, 4, 4, 4]
  });
}

function disableMask() {
  if (cleaveInstance) {
    cleaveInstance.destroy();
    cleaveInstance = null;
  }
}

Сценарий:

  • при обнаружении autofill → уничтожить экземпляр;
  • после стабилизации DOM → создать заново.

Работа с rawValue и восстановление исходных данных

Одной из ключевых особенностей Cleave.js является разделение:

  • форматированного значения (value);
  • исходного значения (rawValue).

Автозаполнение часто вставляет уже “сырой” текст, но Cleave.js интерпретирует его как форматированный.

Правильная синхронизация:

const cleave = new Cleave(input, {
  numeral: true
});

setTimeout(() => {
  const value = input.value;
  cleave.setRawValue(value);
}, 0);

Использование setTimeout с нулевой задержкой позволяет дождаться завершения внутреннего обновления DOM после autofill.

Особенности autocomplete-атрибутов

Браузеры по-разному интерпретируют autocomplete, и это влияет на момент и тип заполнения.

Примеры:

<input id="card" autocomplete="cc-number">
<input id="phone" autocomplete="tel">
<input id="date" autocomplete="bday">

Для Cleave.js важно учитывать:

  • cc-number почти всегда вызывает мгновенное заполнение;
  • tel может заполняться частично;
  • off не гарантирует отключение autofill.

Практика показывает, что autocomplete="off" часто игнорируется современными браузерами.

Проблема восстановления курсора после autofill

После автозаполнения Cleave.js может некорректно вычислить позицию курсора.

Причина:

  • браузер устанавливает selectionStart/selectionEnd;
  • Cleave.js пересчитывает формат;
  • курсор остаётся в старой позиции.

Решение — принудительное восстановление позиции:

input.addEventListener('input', () => {
  requestAnimationFrame(() => {
    const pos = input.value.length;
    input.setSelectionRange(pos, pos);
  });
});

MutationObserver как инструмент отслеживания изменений autofill

Автозаполнение не всегда генерирует события. В таких случаях используется наблюдение за DOM:

const observer = new MutationObserver(() => {
  if (input.value && cleaveInstance) {
    cleaveInstance.setRawValue(input.value);
  }
});

observer.observe(input, {
  attributes: true,
  childList: false,
  subtree: false
});

Хотя MutationObserver не всегда ловит изменения value, в сочетании с input-событиями он повышает устойчивость.

Работа с множественными полями и массовым autofill

Автозаполнение часто заполняет сразу набор полей (карта, дата, CVV). Это создаёт каскадное срабатывание Cleave.js на нескольких инстансах одновременно.

Проблемы:

  • конкуренция за repaint;
  • скачки фокуса;
  • нестабильное форматирование при одновременной инициализации.

Решение — централизованная инициализация:

const inputs = document.querySelectorAll('.cleave');

window.addEventListener('load', () => {
  setTimeout(() => {
    inputs.forEach((el) => {
      new Cleave(el, {
        numericOnly: true
      });
    });
  }, 100);
});

Защита от перезаписи значений password manager’ами

Менеджеры паролей действуют аналогично autofill, но часто:

  • вставляют значения с задержкой;
  • триггерят скрытые события;
  • обновляют поля после пользовательского взаимодействия.

Для Cleave.js это особенно критично в полях CVV или OTP.

Типовой подход:

  • временно отключать маску при фокусе;
  • повторно включать после blur;
  • либо использовать setRawValue после изменения.
input.addEventListener('focus', () => {
  disableMask();
});

input.addEventListener('blur', () => {
  setTimeout(enableMask, 100);
});

Консистентная стратегия взаимодействия с autofill

Устойчивое поведение достигается не одной настройкой, а комбинацией механизмов:

  • отложенная инициализация Cleave.js;
  • обработка input событий с проверкой источника;
  • использование setRawValue после autofill;
  • контроль курсора через requestAnimationFrame;
  • временное отключение маски при массовых вставках;
  • CSS-хуки для обнаружения autofill.

Такой набор компенсирует отсутствие единого стандарта поведения браузеров и обеспечивает стабильную работу масок ввода в условиях непредсказуемого автозаполнения.

Оглавление