Node.js Recipes

Що таке npm alias?
#npm
npm alias дозволяє встановити інший пакет, але не змінювати звернення до коду. Для цього використовується такий формат <alias>@npm:<name>. Приклади:
npm i @nestjsx/crud@npm:@rewiko/crud
npm i react@npm:@preact/compat react-dom@npm:@preact/compat

Ось посилання на документацію та ще нагадаю про patch-package

📕 The Node.js Handbook
#books
Сьогодні хочу порадити книгу "The Node.js Handbook". Автор Flavio Copes використовує правило "вивчайте 80% теми за 20% часу". Тому його посібники (handbooks) будуть корисні початківцям. Книга була оновлена у липні 2022 року.

📕 The Node.js Handbook
🔗 All Handbooks

Node.js прибирає термін native modules
#nodejs_api
Документація та source code більше не використовує терміни native чи core modules. Натомість повсюдно використовується built-in modules. Нагадаю, що з 16-ї версії такі модулі можна імпортувати з префіксом node:. Наприклад:
const http = require('node:http')
🔗 Pull

🆕 Stackshare опублікував серію з 3-х статей про технічне розростання (Tech Sprawl)
#news
Tech sprawl – термін досить новий. Це тип технологічного боргу, викликаного використанням різних технологій/інструментів/версій, які ваша організація використовує для розв'язання однієї проблеми. Статтю варто додати до закладок, щоб цитувати аргументи на користь консистентності технічного стека.
🔗 stackshare.io
🔗 Перша статья

🆕 Google більше не рекомендує використовувати SPA для Google Search
#news
Google оновив документацію щодо JavaScript-generated content, а це SPA/Ajax/etc. Тепер документація говорить, що це workaround, а не довгостроковий підхід. Використовуйте оновлену документацію як головний аргумент на користь Next.js/JAM stack/etc для SEO.
🔗 Першоджерело

Що почитати у вихідні?

​​Огляд Node.js v18: structuredClone
#nodejs_api

Як ви знаєте об'єкти на відміну від примітивів передаються за посиланням, а не за значенням. Тому потрібно вміти робити копію об'єкта. Раніше для цього використовували spread оператор чи Object.assign. Але це працювало лише для об'єктів з одним рівнем вкладеності.

Сьогодні всі сучасні браузери підтримують structuredClone, який підтримує  deep clone та кругові посилання. Він з'явиться в Node.js 18. Приклад із документації на зображенні.

У Node.js вже зараз його можна використовувати за допомогою Structured clone polyfill.

Які типи додатків JavaScript існують?

Додатки можна розділити по домену (gambling, dating, traveling, etc), по бізнес-моделі (SaaS B2B, B2C mobile). Але я поділюсь своїм баченням типології на основі технології розробки (design, coding, QA, delivery)

Перевірена класика:
- Single Page Application 
- Web API (Rest or GraphQL)
- Server-Side rendering (Next.js)
Часті гості:
- Static rendering (JAM)
- Real-time App with Web Sockets
- Mobile app with React Native
- Web3 App
- Business logic inside No Code/Low Code
- IoT
- Chat Bots (Telegram/Facebook/etc)
- CLI Utils
Екзотика у вигляді розширення:
- Chrome Extension 
- Visual Studio Code Extension
- Docker Extension
- Zoom App
- Jira/Confluence App

Зверніть увагу, що з точки зору процесу розробки SPA на React нічим не відрізняється від SPA на Vue. Чого не скажеш про розширення або Web3 VS IoT. Якщо ви бажаєте розвиватися як інженер, то додати до свого портфоліо новий тип додатка буде найкорисніше.

Чому потрібно використовувати scope у іменах пакетів?
#npm

Вчора я робив ревю Workshop: Integration testing of back-end applications і вкотре дав рекомендацію use naming with scope. Нагадаю, що ім'я може мати scope. Приклад: @nestjs/common.

Ось мої аргументи використовувати scope у всіх ваших пакетах:
1️⃣ вибір вільного та зрозумілого імені значно простіше. Приклад @<project_name>/eslint-config
2️⃣ на рівні коду очевидно які пакети внутрішні.
3️⃣ легко використовувати для потрібного scope окремий npm репозиторій. Детальніше Associating a scope with a registry

Але головний аргумент під час ревю воркшопу був не технічного плану. Порада була: Думай про Open Source як про майбутній бізнес. Колись проєкт може продавати підписку на частину пакетів і scope буде обов'язковий для цього. Приклад https://marmelab.com/ra-enterprise/

Junior: – Why should we throw only new Error?
Senior: – Because the Error stack trace matters

Завтра команда Fwdays проведе благодійний стрім з Анастасією Войтовою "Кібербезпека під час війни". Настя крута. Рік тому я робив з нею Voice chat About Security. Впевнений стрім буде ще крутіше.

🔗 Більше інформації на сторінці заходу
👀 Власне сам стрім на YouTube

👉 3 Rs of Software Architecture
👉 Clean Code for JavaScript
🆕 Clean Code for TypeScript

Ви пам'ятаєте, хто платить за вечірку "Всі бажають Node.js розробників"? Це Google. Компанія інвестує мільйони в Chrome та V8. Сьогодні пропоную переглянути вам два відео:
👀 What are Chrome release channels?
👀 New in Chrome 104

#worth_seeing

Які питання поставити потенційному тех. ліду?
#list
Сьогодні поділюсь питаннями для інтерв'ю, щоб перевірити вміння пояснювати технічні теми. Ця навичка особливо важлива тех.лідам та архітекторам.

1. Чим SDK відрізняється від API?
2. Де проходить межа між CI та CD?
3. Яку головну проблему вирішують Promise у порівнянні з callback?
4. У чому відмінність HTTP від ​​WebSockets?
5. Як правильно писати міграцію бази даних?
6. Розкажіть, як працюють AWS lambda?
7. Які проблеми вирішують мікросервіси?
8. У якому разі виправдано використовувати мікрофронтенди?
9. Розкажіть, як би виглядала ідеальна піраміда тестування на вашому попередньому проєкту в ідеальних умовах?
10. Що таке semver та як його використовувати?

У ході інтерв'ю важливо перевірити, що кандидат вміє дати як коротку та просту відповідь (але не втративши важливе), так і оперує необхідною технічною глибинною. Для цього я змінюю контекст питання: "поясніть замовнику/Product Owner, а тепер колезі-інженеру".

Які npm пакети варто встановити глобально?
#list #package

Сьогодні розповім, які пакети в мене встановлені глобально. Я їх використовую як CLI утиліти.
- ngrok/localtunnel робить вашу програму доступною в Internet
- jscpd знаходить дублікати коду. Автор Андрій Кучеренко веде @mathrandomcommunity
- cost-of-modules показує розмір пакетів, що використовуються. Дозволяє швидко пояснити, чому в Dockerfile після npm run build необхідно робити npm prune --production.
- sort-package-json сортує package.json до канонічного вигляду
- depcheck знаходить не використовувані або не оголошені в package.json залежності
- browser-run/bcat виводить результат роботу іншої CLI команди у браузер
- license-checker показує які open source ліцензії у пакетів в ваших залежностях

Перевірити ваш список: npm list -g. А що і навіщо використовуєте ви?

Як посадові обов'язки у Software Architect?

Визначення Software Architect відрізняється від проєкт до проєкту. Тому щоб зрозуміти, а що це за посада, краще запитати посадові обов'язки. Наведу своє розуміння.
– збір вимог важливих для архітектури
– розбиття системи на елементи та опис їх взаємодій
– вибір технічного стека
– оцінка необхідних для реалізації ресурсів (фінансові, часові, технічні)
– архітектурний нагляд, тобто регулярний аналіз реалізації архітектури

Після кожного з цих дій має залишатися артефакт. Наприклад, сторінка в Confluence. Як правило архітектурні рішення приймаються не самостійно, а узгоджуються спільно з лід інженерами та/або CTO.

Software Architect є Software Engineer-ом, тому в його обов'язки може входить писати код чи troubleshooting. Приклади інших обов'язків:
– створення Proof of Concept (R&D Engineer)
– узгодження пріоритетів та виділення ресурсів (Engineering Manager)
– налаштування технічних процесів (Tech Lead)
– аналіз та документація вже існуючої системи (Reverse Engineer)
– створення технічного контенту та просування його серед інженерів (DevRel)

Чому NODE_ENV=beta це помилка?
TL;DR; NODE_ENV=production ENV=beta
🇺🇸 English version at dev.to

Нагадую, що третій фактор TwelveFactor App твердить: "Зберігайте конфігурацію в середовищі виконання." Ім'я змінної NODE_ENV каже, що вона визначає Node.js оточення, а не вашої програми.

Приклади, як змінюється поведінка JavaScript екосистеми при NODE_ENV=production
- команда npm install не встановлює devDepencencies
- express.js кешує шаблони та css
- Apollo Server вимикає інтроспекцію схеми

Ви не повинні використовувати NODE_ENV для визначення імені вашого середовища. Але яку змінну використовувати замість NODE_ENV? Відповідь залежить від того, чи будете ви використовувати префікс для змінних, пов’язаних із бізнес-логікою. Такі змінні є feature flags, тобто визначають бізнес-логіку.
Приклад із префіксом FOO:
FOO_ENV=beta
FOO_FEATURE_FLAG=on
Приклад без префікса:
ENV=beta
FEATURE_FLAG=on

Повернемося до NODE_ENV. Зазвичай вона має одне з таких значень:
– development – використовується, якщо не визначено явно. Встановіть це значення під час розробки на вашому комп’ютері.
– test – такі тестові фреймворки, як Jest, автоматично встановлюють це значення.
– production – використовуйте це значення під час виконання коду на сервері

Десятий фактор — Dev/prod parity. Тому треба використання NODE_ENV=production у кожному бізнес-середовищі. Dockerfile є найпростішим місцем для цього. Просто додайте
ENV NODE_ENV=production

За годину розповім про те, як працюють serverless function чим вони відрізняються від containers. Роблю доповідь у рамках @dsc_kpi (Google Developer Student Club KPI), але цікавою вона може бути й Senior рівню. Тільки демо без теорії/слайдів і звичайно на Node.js. До зустрічі!