Frontend інженерія
Розмір тексту: 16

УРОК 2 ІЗ 76

Діагностика проблем через гіпотези

120 хв читання та практикиТвій наступний крок

M00-L02. Діагностика проблем через гіпотези

ID: M00-L02. Час: 2 години, включно з 45 хв самостійного розслідування. Передумова: M00-L01; знайомство з функціями й Promise на практиці. Результат: ти зможеш записати reproduction, відділити спостереження від припущення, перевірити дві гіпотези й скласти timeline неправильних результатів пошуку.

1. Симптом ще не є причиною

Агент вводить network, потім змінює пошук на network access. У полі лишається другий текст, а список раптом показує результати першого. Колега каже: «Це React знову неправильно рендерить». Інший пропонує debounce. Третій радить нову бібліотеку запитів. Усі три репліки можуть містити корисну ідею, але жодна ще не встановлює причину.

Перший інженерний крок — описати суперечність: при активному запиті network access список містить результати для network. Це спостереження. «Старий запит завершився пізніше» — гіпотеза. «Додати debounce» — пропозиція зміни. Якщо змішати ці три речі, можна отримати випадкове покращення без розуміння механізму.

Той самий підхід працює для твоїх пріоритетів. «Верстка зламалася» перетворюється на «на viewport 360 CSS px довгий заголовок виштовхує кнопку за праву межу». «Сторінка повільна» перетворюється на конкретну дію й вимірювану затримку. «Погана архітектура» потребує названого наслідку: яку зміну складно виконати, яка залежність заважає, що доводиться дублювати.

2. Модель розслідування

Reproduction — умови й кроки, з якими інша людина може отримати той самий симптом. Гіпотеза — можливе пояснення з прогнозом. Контрольована зміна — зміна одного чинника для перевірки цього прогнозу.

Це робоча евристика, а не гарантія, що будь-який дефект зникає після одного циклу. У production часто спершу потрібно зменшити вплив, а потім продовжувати дослідження. Повний incident процес буде в M15.

Приклад reproduction:

Середовище: локальний навчальний transport, один список.
Дані: query A -> ["Заявка A"], query B -> ["Заявка B"].
Кроки:
1. Почати пошук A.
2. До завершення A почати B.
3. Завершити B.
4. Завершити A.
Очікування: список залишається результатом B.
Факт: після кроку 4 знову видно результат A.

Не додавай «через неправильний useEffect» до фактичного результату. Це ще не перевірено. Корисне розслідування дозволяє побачити, де саме дані стають неправильними.

3. Від запиту до видимого результату

Для пошуку достатньо простого ланцюга:

Намір користувача -> старт операції -> відповідь
-> рішення застосувати дані -> стан -> UI

Старт операції, її завершення й застосування даних — різні події. Правильна відповідь сервера ще може бути застосована в невідповідний момент. Правильний state також не гарантує, що конкретний компонент читає потрібне джерело. Тому ми спостерігаємо межі ланцюга, а не ставимо всі логи в одному render.

Порівняй гіпотези:

ГіпотезаПрогнозЩо могло б її спростувати
API повертає неправильні даніPayload B містить результати APayload B відповідає B, помилка з'являється пізніше
Старий результат перезаписує новийПісля ui-write B є ui-write AДані A після B взагалі не застосовуються
UI читає інший stateАктуальний state правильний, output неправильнийНеправильний результат уже є в state

Запис «певно, щось із кешем» слабкий: незрозуміло, яке спостереження змінить твою думку. Сильніший: «якщо два різні query використовують один cache key, повтор B поверне payload A без нового запиту». Ми поки не реалізуємо кеш; тут важлива форма прогнозу.

4. Контрольований приклад без реального API

Середовище: сучасний браузер, JavaScript у DevTools Console. У фрагменті немає React, HTTP чи DOM. view моделює дані для UI, а ui-write означає запис цієї моделі. Це не доказ реального render або paint. Таке спрощення дозволяє перевірити порядок подій без нових залежностей.

function createSearchHarness() {
  let nextId = 0;
  let activeQuery = "";
  let view = { query: "", items: [] };
  const pending = new Map();
  const events = [];

  function search(query) {
    const id = ++nextId;
    activeQuery = query;
    events.push({ step: "start", id, query });

    const result = new Promise((resolve) => {
      pending.set(id, resolve);
    });

    result.then((items) => {
      events.push({ step: "handler", id, query });
      view = { query, items };
      events.push({ step: "ui-write", id, query });
    });

    return id;
  }

  function complete(id, items) {
    const resolve = pending.get(id);
    if (!resolve) throw new Error(`Немає pending операції ${id}`);
    pending.delete(id);
    events.push({ step: "response", id });
    resolve(items);
  }

  return {
    search,
    complete,
    read: () => ({ activeQuery, view, events: events.slice() }),
  };
}

const harness = createSearchHarness();
const a = harness.search("network");
const b = harness.search("network access");
harness.complete(b, ["Результат B"]);
harness.complete(a, ["Результат A"]);
// Наступний вираз виконай окремо, після завершення цієї команди:
// harness.read()

Очікуваний симптом після виконання handlers: activeQuery дорівнює network access, але view.query — network. Кожен handler безумовно записує свої дані. Порядок старту не використовується для рішення, чий результат актуальний.

then handlers виконуються асинхронно, тому читання view одразу в тому самому синхронному фрагменті не показує завершений результат. Документація Promise пояснює цей контракт; tasks і microtasks детально розбираємо в M01-L04. Для цього уроку достатньо виконати harness.read() наступною командою Console. MDN: Promise.

Ти не зобов'язаний запускати код для читання уроку: timeline можна вивести вручну. Якщо використовуєш ручний аналіз, так і познач у доказі. Обсяг авторського запуску harness описано в кінці уроку; він не замінює твоєї спроби.

5. Що спостерігати й чого не доводить лог

Дай кожній операції ID. Query сам по собі не завжди достатній: користувач може ввести A, потім B, потім знову A. Дві операції з однаковим query можуть мати різні дані або час актуальності.

Для невеликої вправи записуй примітивні значення: ID, query, етап, довжину результату. Не виводь токени чи реальні дані користувачів. У цьому прикладі дані синтетичні. У браузерному debugger breakpoint дозволяє зупинити виконання й подивитися значення, а logpoint — записати спостереження без паузи та зміни source. Chrome DevTools: breakpoints.

Breakpoint змінює час виконання. Якщо race зникає лише під час пауз, перевір порядок за logpoints або контрольованим transport. Лог «отримали B» не доводить, що список досі показує B: після нього могла відбутися інша зміна. Потрібен timeline до кінцевого output.

Перенесення на layout і performance

Для overflow запиши viewport, конкретний текст і елемент, що виходить за межі. Потім сформулюй альтернативи: завеликий fixed width; мінімальний розмір дочірнього елемента; текст без допустимого переносу. Зміни один чинник і перевір, чи прогноз справдився. overflow: hidden може сховати симптом разом із потрібною дією; це не доказ усунення причини.

Для продуктивності спочатку назви дію й умови: введення фільтра, dataset, browser, профіль CPU/network. Пропозиція «додати memoization» стає гіпотезою лише після прогнозу: яке обчислення зникне з повторної взаємодії й де це буде видно. Один суб'єктивно швидкий запуск не встановлює ефекту. Метод вимірювання поглиблюється в M11.

6. Самостійне розслідування — 45 хвилин

Вхід: createSearchHarness вище. Задача: розслідувати три операції A → B → A з різними результатами. Завершення: друга операція, третя, перша. Перша A повертає старий A, третя A — новий A.

Обмеження: не переписуй код до запису прогнозу; нові бібліотеки не потрібні. Працюй у Console або зроби явний ручний timeline. Не стверджуй, що перевірив реальний сервер.

Артефакт: m00-l02-investigation.md: reproduction, таблиця двох гіпотез, timeline з ID, пропозиція локальної зміни та контрольні сценарії. Кодова зміна бажана, але пояснений proposal дозволений, якщо середовища немає.

Час: 10 хв reproduction/прогноз, 15 хв спостереження, 10 хв зміна або proposal, 10 хв перевірка й висновок.

Критерії приймання:

  • Query й ID операції не змішані; обидві A можна відрізнити.
  • Є очікувана кінцева поведінка: результат третьої операції лишається актуальним.
  • Для двох гіпотез є прогноз і умова спростування.
  • Timeline відділяє response, handler і ui-write.
  • Перевірка охоплює змінений порядок, звичайний порядок і одну операцію.
  • Висновок називає межу: harness не має loading/error, реального API чи lifecycle компонента.

Підказки

  1. Не запитуй лише «query зараз A?». Дві різні операції можуть мати таке саме query.
  2. Актуальність можна пов'язати з номером останньої розпочатої операції.
  3. Перевір актуальність перед ui-write; transport і отримання даних можуть відбутися незалежно від цього рішення.

Розбір після самостійної спроби

Зберігай latestId. Після const id = ++nextId запиши latestId = id. Перед зміною view перевір id !== latestId; якщо так — запиши ignored і заверш handler. Третя A має ID 3, перша — ID 1, тому повторення тексту більше не маскує різницю.

Для трьох уже розпочатих операцій latestId = 3. Коли handlers виконуються в заданому порядку, рішення виглядає так:

Порядок завершенняОперація й результатПеревірка актуальностіДія з view
1B, ID 22 ≠ 3Ігнорувати
2Нова A, ID 33 = 3Записати «новий A»
3Стара A, ID 11 ≠ 3Ігнорувати; залишити «новий A»

Текст query в останньому рядку знову A, але право змінити view має лише ID 3. Саме цього не можна довести порівнянням query без номера операції.

// Додати в стан createSearchHarness:
let latestId = 0;

// Усередині search одразу після створення id:
latestId = id;

// Усередині result.then перед записом view:
if (id !== latestId) {
  events.push({ step: "ignored", id, query });
  return;
}

Це патч до повного фрагмента, а не окремий виконуваний файл. Він забезпечує вузьку гарантію для нашого сценарію: застарілий успішний результат не переписує актуальну модель. Обробку error і завершення loading треба захищати тим самим правилом у повнішій реалізації. Lifecycle, cancellation і кеш матимуть додаткові обмеження.

Debounce може зменшити кількість запитів, але не задає порядок завершення вже розпочатих. Cancellation може зменшити зайву роботу, але не варто приписувати йому гарантію скасування серверної операції. У цьому harness найменша обґрунтована зміна — правило актуальності; інші механізми розглядаємо в M01/M07.

Сильний висновок для співбесіди: «Payload був правильним. Проблема виникала в рішенні застосувати відповідь: старий handler теж записував state. Я встановив це timeline з ID і додав перевірку актуальності. У навчальному прикладі error і unmount не моделювалися». Це пояснення спирається на спостереження та має чесну межу.

7. Активне відтворення

  1. Чим відрізняються симптом, гіпотеза й пропозиція зміни?
  2. Яка умова може спростувати гіпотезу про неправильний payload?
  3. Чому query не завжди достатній як ідентифікатор операції?
  4. Чому breakpoint може вплинути на reproduction асинхронного дефекту?
  5. Що перевірка harness не доводить про реальний UI?

Зміна умови: остання операція завершується помилкою, а стара — успішно. Запиши очікуваний UI й місця, де потрібна перевірка актуальності; повний error handler зараз не обов'язковий.

Джерела й межі

Перевірено 2026-10-10. Основне читання: Chrome DevTools — Pause your code with breakpoints, секції conditional breakpoints і logpoints; MDN — Promise, Description і Chained Promises. Не потрібно читати весь reference.

Harness і метод розслідування створено для курсу. API не вимагають React версії. Код редакторськи перевірено, але не запускався; точні timestamp і реальна продуктивність не вимірювалися.

Повторний аудит — 2026-10-11

В аудиті 2026-10-11 виконано harness та patch: навмисний stale write відтворено, single/A-B/A-B-A сценарії з різним порядком завершення проходять. Перевірено лише модель у Node, без DOM, loading/error чи реального API. Деталі й відтворювані перевірки — у звіті аудиту.

СПРОБУЙ ВЛАСНОРУЧ

Від читання — до результату.

Зміни код і запусти в браузері. Це відкрите демо: запуск коду не завершує урок автоматично.

Завантажуємо вправи…

ЗНАННЯ СТАЮТЬ НАВИЧКОЮ ЧЕРЕЗ ПРАКТИКУ

Готовий закріпити результат?

Прочитай матеріал і виконай завдання з уроку. Після цього відзнач свій маленький успіх.

Увійти, щоб пройти тести й зберегти прогрес