Короткий ответ

Сценарии, сайты, permissions, данные, интерфейс, авторизация, ошибки, публикация и критерии приёмки. Разбираем практический порядок работ, риски, стоимость и то, как принять результат без новых проблем.

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

Шаблон ТЗ для расширения

  1. цель и пользователь;
  2. поддерживаемые сайты и URL;
  3. сценарий по шагам;
  4. какие элементы страницы читаются/изменяются;
  5. API и авторизация;
  6. что хранится локально и на сервере;
  7. ошибки и fallback;
  8. permissions;
  9. браузеры и минимальные версии;
  10. публикация/внутренняя установка;
  11. критерии приёмки.

Пример критерия приёмки

оХорошо
«Работает быстро»результат появляется не дольше 2 сек при API<500 мс
«Парсит таблицу»
полей из строк и экспортирует CSV UTF-8
«Авторизуется в CRM»OAuth token обновляется, logout очищает локальное состояние
«Поддерживает сайт»matches перечислены, ошибки DOM обработаны

Пример описания сообщения между content и service worker

JAVASCRIPT
// content.js
chrome.runtime.sendMessage({
  type: 'SAVE_ITEM',
  payload: { id: '123', title: 'Example' }
});

// background.js
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  if (message.type === 'SAVE_ITEM') {
    // validate payload, call API/storage
  }
});

Как проверить результат

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

Связанные материалы