УРОК 2 ІЗ 78
Робоче середовище і запуск прикладів
00.02. Робоче середовище: від файлу до зрозумілого результату
До змісту курсу · Назад: 00.01. Як навчатися · Далі: 00.03. Вхідна діагностика
Орієнтир часу: 1–3 години з ручним розбором і вправами. Якщо Node вже є і ти впевнено працюєш із терміналом, сама підготовка займе лише невелику частину цього часу. Не потрібно витрачати решту на інструменти: використай її на пояснення алгоритму.
Яке середовище нам потрібне
Для перших задач вистачить редактора тексту, файлу JavaScript і способу виконати його. У цьому уроці основний варіант — Node.js у терміналі. Альтернатива — консоль інструментів розробника в браузері. Обидва дозволяють зосередитися на функціях, масивах, умовах і циклах.
Твій досвід із React, Vue чи Nuxt тут допоможе читати JavaScript. Водночас алгоритм зручніше спочатку відокремити від життєвого циклу компонента: передати дані у функцію, отримати результат і пояснити кожен крок. Коли пізніше використаємо алгоритм у фронтенд сценарії, у нас уже буде зрозуміле ядро обчислення.
Власні реалізації можна писати в окремих файлах поруч із навчальними прикладами або в персональній папці практики. Зберігай початковий приклад доступним для порівняння. Назва на кшталт find-max-attempt-01.mjs дає більше інформації, ніж temp.mjs. Коротка нотатка про задум допоможе повернутися до вправи через тиждень.
Після уроку ти зможеш:
- запустити навчальний файл і пояснити роль його шляху;
- розрізняти значення, яке функція повертає, і текст, який вона друкує;
- перенести простий приклад у браузерну консоль;
- вручну простежити пошук максимуму, включно з від’ємними числами;
- сформулювати припущення, які роблять приклад коректним.
Спочатку перевір наявний Node
Відкрий термінал у корені цього репозиторію — папці, де лежить README.md. Для запуску наших файлів достатньо вже встановленого підтримуваного LTS-випуску Node.js. Конкретний актуальний випуск змінюється; за потреби перевір його на офіційній сторінці завантаження Node.js. Спочатку просто виконай:
node --version
Якщо команда показала версію, Node знайдено. Повідомлення command not found означає, що оболонка не знаходить команду за поточними налаштуваннями. Це ще нічого не говорить про твоє розуміння JavaScript. Можна скористатися браузерним варіантом нижче та повернутися до локального Node пізніше. Якщо встановлення потрібне, обери звичний для тебе спосіб з офіційної документації; для уроку не потрібно перебудовувати робоче середовище всіх проєктів.
Тепер запусти готовий приклад із кореня репозиторію:
node examples/00-start/hello-algorithms.mjs
Загальна форма команди — node шлях/до/файлу. Node виконує вказаний файл; такий спосіб запуску описано в офіційній інструкції Node.js. Шлях тут відносний: він рахується від поточної папки термінала. Назва відкритого файлу в редакторі не змінює поточну папку термінала автоматично.
Очікуваний вивід прикладу:
Mixed values: 9
Negative values: -3
One value: 0
Empty input: undefined
Ці рядки — демонстрації кількох викликів. Побачити їх корисно для перевірки запуску, але далі потрібно пояснити, звідки кожне значення взялося. Не позначай тему засвоєною лише через збіг виводу.
Навіщо розширення .mjs
Файли .mjs Node.js розглядає як ECMAScript modules. Цей явний маркер дозволяє нашим JavaScript-прикладам мати однаковий формат без налаштування package.json. Правила визначення модулів описані в документації Node.js про ESM. У вступному прикладі імпорти ще не потрібні, але формат знадобиться для організації наступних прикладів.
Слово module означає контекст організації коду. Воно не робить функцію асинхронною, не запускає сервер і не створює інтерфейс. Наш файл просто оголошує функцію, викликає її з кількома аргументами та друкує повернуті значення. Коли виконання закінчується, цей навчальний процес не має подальшої роботи.
Якщо ти звик до TypeScript, читати звичайний JavaScript цілком достатньо. Пізніше можемо додавати анотації для пояснення контрактів. Наприклад, number[] підказує очікуваний тип елементів, але сам по собі не гарантує, що числа скінченні або що в масиві немає пропущених позицій. Статична анотація та перевірка даних під час виконання виконують різні ролі.
Для цього уроку запускаємо саме .mjs із JavaScript-синтаксисом. Якщо вставити TypeScript-анотацію values: number[] у цей файл, це вже не буде коректним JavaScript. Потребу в окремому TypeScript-середовищі обговорюватимемо, якщо воно допоможе конкретній темі. Обов’язкових пакетів для старту немає.
Перша функція: що саме вона обіцяє
Відкрий готовий приклад. Він містить таку функцію:
function findMax(values) {
if (values.length === 0) {
return undefined;
}
let max = values[0];
for (let index = 1; index < values.length; index += 1) {
const current = values[index];
if (current > max) {
max = current;
}
}
return max;
}
Її контракт:
| Частина | Домовленість |
|---|---|
| Вхід | Щільний масив скінченних чисел JavaScript |
| Непорожній вхід | Повернути найбільший елемент |
| Порожній вхід | Повернути undefined |
| Зміна даних | Не змінювати переданий масив |
| Інші значення | У цьому прикладі не підтримуються й не перевіряються |
Щільний масив тут означає, що кожна позиція від 0 до length - 1 містить число. Наприклад, [3, 8] підходить, а масив із пропущеною позицією [3, , 8] не відповідає контракту. Скінченні числа виключають NaN, Infinity та -Infinity. Рядки на кшталт "8" теж не входять до умов, навіть якщо JavaScript іноді виконує перетворення типів.
Ці обмеження дозволяють розібрати саме пошук максимуму. Для даних без гарантій у реальному застосунку потрібна окрема валідація або інший явно визначений контракт. Функція не стає універсальною через те, що її можна викликати з будь-яким значенням.
Для порожнього набору ми обрали undefined, бо серед переданих елементів немає кандидата на максимум. Це рішення API нашої функції. Інша задача могла б вимагати виняток або спеціальний об’єкт результату. Умова має бути визначена до реалізації, щоб той, хто викликає функцію, міг правильно обробити відповідь.
Чому максимум починається з першого елемента
Інтуїція проста: поки ми бачили лише одне число, воно і є найбільшим серед побачених. Далі беремо наступне та порівнюємо з поточним кандидатом. Якщо нове більше — замінюємо кандидата. Якщо менше або дорівнює — залишаємо поточного.
Масив [4, -2, 9, 3] вручну:
| Момент | index | current | max до порівняння | Результат порівняння | max після |
|---|---|---|---|---|---|
| Ініціалізація | — | — | — | Перший елемент стає кандидатом | 4 |
| Другий елемент | 1 | -2 | 4 | -2 > 4 — ні | 4 |
| Третій елемент | 2 | 9 | 4 | 9 > 4 — так | 9 |
| Четвертий елемент | 3 | 3 | 9 | 3 > 9 — ні | 9 |
| Завершення | — | — | 9 | Повернути кандидата | 9 |
Важлива властивість: після кожного обробленого елемента max містить найбільше число серед уже переглянутих. Перед першим проходом циклу вже переглянуто перший елемент. Тому index починається з 1, а не з 0.
Індекси: 0 1 2 3
Значення: [4, -2, 9, 3]
-------|------
До обробки 9 вже враховано [4, -2]; max = 4.
Після обробки 9 враховано [4, -2, 9]; max = 9.
Чому не почати з max = 0? Для [-8, -3, -12] жодне число не перевищить нуль, і функція поверне число, якого у вході взагалі немає. Початкове значення має відповідати змісту змінної: кандидат повинен бути елементом переданого непорожнього масиву.
Чому не почати одразу з values[0] без перевірки порожнього входу? Технічно читання відсутнього елемента дало б undefined. Проте явна перевірка показує задум: порожній випадок обробляється окремо, а після неї алгоритм працює з гарантовано наявним першим числом. Це полегшує пояснення кожного подальшого кроку.
Для масиву з одного числа цикл не зробить жодного порівняння. Для чотирьох чисел порівнянь усередині if буде три. Поки ми рахуємо конкретні дії на конкретних входах. Формальний опис росту обсягу роботи з’явиться в модулі про складність.
return і console.log відповідають на різні потреби
return передає значення з функції її виклику та завершує виконання цієї функції. Це значення можна зберегти, передати далі або використати в умові. Деталі оператора є в довідці MDN про return.
const largest = findMax([4, 9, 3]);
const hasExpensiveItem = largest !== undefined && largest > 100;
console.log(largest); // Друкує 9.
console.log показує інформацію в консолі. Сам факт друку не передає надруковане число користувачу функції. Порівняй:
function showMax(values) {
console.log(findMax(values));
}
const result = showMax([4, 9, 3]);
console.log(result);
Перший виклик надрукує 9. Другий надрукує undefined, бо showMax закінчується без return зі значенням. Помилка часто непомітна, якщо дивитися лише на красивий вивід. Завжди запитуй: яке значення отримує код, що викликав функцію?
findMax у нашому прикладі є чистою функцією за заявленого контракту: результат залежить від переданих чисел, функція не змінює їх і не друкує нічого сама. Демонстраційні console.log розташовані окремо, після оголошення. Весь файл має видимий ефект друку; чистота тут описує саме функцію.
Це зручно і для інтерфейсів. Значення, повернуте функцією, можна використати у звичайній підготовці даних або передати до компонента. Текст, виведений у консоль, не є значенням для рендерингу. Це загальний зв’язок між обчисленням і його використанням; поведінку оновлень конкретного фреймворку він не описує.
Альтернатива: браузерна консоль
Відкрий DevTools у звичному браузері та вкладку Console. Для вправи достатньо вставити оголошення findMax з уроку, а потім окремо викликати:
findMax([4, -2, 9, 3]);
findMax([]);
Консоль зазвичай показує значення виконаного виразу. Тому число може бути видимим навіть без console.log. У файлі, який запускає Node, сам вираз findMax([4, 9, 3]); не друкує результат — для нашої демонстрації й додано явний вивід.
Після оголошення функції консоль може показати undefined. Це не відповідь findMax на твій майбутній вхід: ти щойно виконав оголошення, а не виклик. Розділяй моменти «описати функцію» і «виконати функцію з аргументом».
Пізніше в модульних прикладах зустрінеться export function .... export використовують у JavaScript-модулях; звичайне вставлення такого рядка в консоль не є надійним способом запустити модуль і може дати синтаксичну помилку. Для консольної вправи копіюй саму функцію без export. Для модульної роботи використовуй файл .mjs. Контекст оператора пояснено в довідці MDN про export.
Не переносимо сюди код, що читає локальні файли або використовує специфічні API Node. Наша поточна функція працює зі звичайним масивом та мовними конструкціями, тому придатна для обох середовищ без змін у самому алгоритмі.
Коли запуск не вдався
Перед зміною алгоритму визнач, на якому етапі сталася проблема:
| Спостереження | Що перевірити спочатку |
|---|---|
node не знайдено | Доступність Node у поточній оболонці; за потреби браузерний варіант |
| Node не знаходить файл | Поточну папку та точне написання відносного шляху |
SyntaxError | Рядок, указаний у повідомленні; дужки, лапки, випадково вставлений TypeScript |
| Файл завершився без виводу | Чи є виклик функції та явний console.log |
Число надруковане, змінна містить undefined | Чи повертає потрібна функція значення через return |
| Неправильний максимум для від’ємних чисел | Початкове значення кандидата та контракт |
Не потрібно відразу міняти залежності, створювати новий проєкт чи переписувати весь файл. Знайди найменшу перевірку, яка пояснить спостереження. Для проблеми шляху корисно порівняти поточну папку з очікуваною; для неправильного числа — виконати ручну трасу на трьох елементах.
Якщо просиш допомогу, додай точну команду, поточну папку, повідомлення помилки та маленький вхід, на якому видно проблему. Для логічної помилки додай очікуваний і фактичний результат. Це зробить розбір предметним і збереже більше часу для самої теми.
Практика
Вправа 1. Передбач вивід
До запуску запиши результати findMax([-10, -4, -8]), findMax([7]), findMax([2, 2, 2]), findMax([]). Для першого входу зроби таблицю змін max. Потім, якщо середовище готове, звір передбачення з виконанням.
Результати: -4, 7, 2, undefined. Для першого входу початковий кандидат -10; після -4 він стає -4; після -8 залишається -4. Однакові значення не змінюють результат: умова current > max хибна, але кандидат уже дорівнює найбільшому значенню.
Вправа 2. Зміни задачу на мінімум
Створи findMin(values) із тим самим контрактом для входу та порожнього випадку. Спочатку опиши зміст кандидата, потім зміни код. Поясни, як від’ємні числа допомагають перевірити рішення.
Що має бути істинним про кандидата після кожного нового числа, якщо шукаємо найменше серед уже переглянутих?
</details> <details> <summary>Підказка 2: початок і заміна</summary>Перший елемент залишається початковим кандидатом. Подумай, яке порівняння підкаже замінити його меншим числом.
</details> <details> <summary>Підказка 3: структура реалізації</summary>Збережи раннє повернення для порожнього масиву й обхід із позиції 1. Перейменуй max на min та зміни умову оновлення на current < min.
function findMin(values) {
if (values.length === 0) {
return undefined;
}
let min = values[0];
for (let index = 1; index < values.length; index += 1) {
const current = values[index];
if (current < min) {
min = current;
}
}
return min;
}
Кандидат містить найменше число серед уже переглянутих. На [-8, -3, -12] він змінюється так: -8 → -8 → -12; результат -12. Для [2, 5] результат 2: цей вхід виявляє помилку з початковим min = 0. Порожній масив дає undefined, а масив з одного числа — це число без порівнянь у циклі. Для непорожнього масиву порівнюємо кожне число після першого рівно один раз; вхід не змінюється.
Вправа 3. Відокрем повернення від виводу
Напиши double(value), яка повертає подвоєне число без друку. Вхід — скінченне число; результат — value * 2 за правилами числових обчислень JavaScript. Функція не змінює зовнішній стан. Збережи результат для 6 у змінній. Окремим рядком надрукуй змінну. Потім поясни, що зміниться, якщо всередині функції замінити return на console.log.
Значення потрібне коду, який викликав double. Який оператор передає результат у місце виклику?
Усередині функції обчисли й поверни добуток. Друк розташуй після виклику, коли результат уже збережений.
</details> <details> <summary>Підказка 3: структура розв’язку</summary>Функція повертає value * 2. Використай її виклик справа від = в оголошенні змінної, а потім передай цю змінну в console.log.
function double(value) {
return value * 2;
}
const doubled = double(6);
console.log(doubled);
Якщо тільки надрукувати добуток усередині й не повернути його, doubled отримає undefined. Видимий рядок 12 не змінює повернуте значення.
Вправа 4. Знайди кількість порівнянь
Скільки разів виконається саме порівняння current > max для масивів довжини 0, 1, 2 і 6? Не рахуй у цій вправі перевірку умови самого циклу. Поясни відповідь через кількість елементів, що залишилися після вибору першого кандидата.
Відповідно 0, 0, 1, 5. Порожній випадок завершується раніше. У непорожньому масиві перший елемент уже обрано кандидатом, а кожен із решти потребує одного такого порівняння. Важливо явно назвати дію, яку рахуємо: перевірки умови циклу — інша категорія дій.
Самоперевірка
- Від якої папки рахується шлях у команді
node examples/00-start/hello-algorithms.mjs? - Чи означає
.mjs, що кожна функція в цьому файлі працює асинхронно? - Чому початкове
max = 0не відповідає контракту? - Чи змінює присвоєння
max = currentелементи масивуvalues? - Чи можна вважати результат
findMax([3, NaN])доказом помилки алгоритму за контрактом цього уроку? - Чому той самий вираз може бути видимим у браузерній консолі й не дати виводу при запуску файлу?
- Від поточної папки процесу термінала; в інструкції це корінь репозиторію.
- Ні. Формат модуля та асинхронність функції — різні властивості.
- Нуль може не належати входу та бути більшим за всі передані від’ємні числа.
- Ні. Ми змінюємо локальну змінну, що містить число, і не присвоюємо значень позиціям масиву.
- Ні:
NaNне є допустимим входом за цим контрактом. Для підтримки такого випадку треба окремо визначити бажану поведінку й реалізувати її або валідацію. - Інтерактивна консоль показує результати виразів. У файлі ми явно друкуємо потрібні значення через
console.log.
Словник уроку
| Термін | Значення в цьому уроці |
|---|---|
| Runtime | Середовище, у якому виконується JavaScript, наприклад Node або браузер |
| Відносний шлях | Шлях, який інтерпретується від поточної папки |
| ECMAScript module | Формат JavaScript-коду з модульним контекстом та підтримкою import/export |
| Аргумент | Конкретне значення, передане під час виклику функції |
| Параметр | Ім’я у визначенні функції, через яке вона отримує аргумент |
| Повернуте значення | Значення, яке отримує код у місці виклику функції |
| Побічний ефект | Зміна або спостережувана дія поза поверненням результату, наприклад друк |
| Чиста функція | Функція з результатом, визначеним входом, без побічних ефектів за обумовлених умов |
Точка зупинки: залиш у своїх нотатках команду запуску або браузерний спосіб, одну трасу на від’ємних числах і відповідь, чому кандидат починається з першого елемента. Далі вхідна діагностика допоможе обрати темп та побачити, що варто повторити.
<!-- COURSE_NAV_START --> <!-- COURSE_NAV_END -->Від читання — до результату.
Зміни код і запусти в браузері. Це відкрите демо: запуск коду не завершує урок автоматично.
Завантажуємо вправи…
ЗНАННЯ СТАЮТЬ НАВИЧКОЮ ЧЕРЕЗ ПРАКТИКУ
Готовий закріпити результат?
Прочитай матеріал і виконай завдання з уроку. Після цього відзнач свій маленький успіх.
Увійти, щоб пройти тести й зберегти прогрес