Typenoscript теперь и в Node.js?

В свежем выпуске мы затронули нашумевший PR. Что случилось то? А случилось такое, что в Node.js подвезли в экспериментальном режиме загрузчик для ts файлов. Работает он очень просто (правда просто). В ноду вшивается SWC в виде скомпиленного для WASM бинаря. TS файлы прогоняются через SWC и из них отстреливаются типы. Всё. Enum и namespace не работают (о счастье). Никакие транспиляции трансформации не производятся. Просто отстреливаются типы.

Есть ли проблемы? Конечно есть. Например, нужно писать расширение файлов в импортах. Потому что импорт так работает бай дизайн.

Почему это круто и важно? Потому что транспиляция раздражает. Потому что хочется всё иметь из коробки и без настроект. Накидать ts-файлик и запустить.

В общем, неожиданно и очень приятно.

UPD
Почитайте роадмап обязательно (спасибо @kravetsone, что напомнил)

Простой лайфхак как сделать звук на созвоне значительно лучше (причём с обеих сторон), если у вас под рукой только bt-наушники.

Выберите источником звука микрофон ноута и не насилуйте пропускную способность bt-канала.

А вот и продолжение истории поддержки TypeScript в Node.js подоспело. Был добавлен флаг --experimental-transform-types, который добавляет возможность запускать файлы с TypeScript-only (требующем трансформации) синтаксисом (Enum, namespace, module с поддержкой source-map). Однако Node.js всё ещё не читает ваш tsconfig.json.

Из интересного: чтобы импортировать (import, require) файл, вам необходимо будет указать расширение .ts, которое включается в TS-конфиге опцией allowImportingTsExtensions. А ещё появилась целая команда для поддержки TypeScript в Node.js.

Кроме того, импорты типов должны быть помечены как type импорты, как при включенном verbatimModuleSyntax в TS-конфиге, иначе вы получите ошибку в рантайме.

import type { Type1, Type2 } from './module.ts';
import { fn, type FnParams } from './fn.ts';

Также предлагается добавить в feature флаги информацию о возможности импортировать файлы с типами или TypeScript-only синтаксисом.

process.features.typenoscript
//               ^? "strip" | "transform"

Всего 4 дня назад в eslint появилась поддержка `.ts` конфигов благодаря jiti, поэтому нововведения в Node.js по импорту .ts файлов облегчат жизнь всему нашему сообществу.

Очень советую к прочтению этот README и ROADMAP, а ещё спасибо @melikhov_dev за упоминание!

Pull Request

Полтора часа с Кириллом хоронили ноду на бэкенде.

https://youtu.be/98qu3CqRNb8

https://youtu.be/DH9vEW5_PiY

Осень — это время когда проекты оживают. Запуски, презентации, становится снова интересно в индустрии.

Я побежал, у меня сентябрь горит.

HTTP 301/302 vs 307/308

Разницу между этими кодами кажется знают все, кто однажды менял домен в большом популярном сервисе :) Живёте вы годами на одном домене, копите внешние ссылки, прорастают приложения и виджеты. А в один прекрасный день едете на другой домен и вам нужно сохранить всё богатство в рабочем состоянии.

И вот тут появляется вроде бы мелочь (совсем нет) — 307/308 сохраняют оригинальный метод запроса и его body(payload). Ну а 301/302 уходят на новый адрес через GET, теряя всё тело и разрушая все ваши апишки.

Ух, да, как довольно сильный астигматик я не переношу высокий контраст тёмных тем и почти всегда выбираю светлые — на них мои глаза болят меньше. Эстетически мне тоже нравятся тёмные, но они просто не совместимы для меня с долгой работой с текстом.

Продолжаю и буду продолжать настаивать, что тёмная тема не может автоматически рассматриваться как «лучше для глаз, лучше ночью». Если запилили только тёмную, то пилите и светлую, пожалуйста.

Нужен ли режим сепии по умолчанию?

Татьяна Фокина на примерах очень хорошо объясняет, почему тёмной и светлой тем недостаточно для комфортной работы с сайтом.

Часто при разработке темы для сайта тестируют контрастность — и это уже хорошо. Но есть люди с астигматизмом, для которых повышенная контрастность вызывает гало-эффект, то есть буквы и строки начинают двоиться. Эффект сепии как раз убирает излишнюю контрастность, поэтому на тексте проще сфокусироваться.

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

Астигматизм — очень распространённая особенность зрения у взрослых, поэтому, возможно, не помешает в браузерах добавить какую-то дополнительную настройку доступности. Но пока такого нет, есть смысл для заботы о пользователях добавить третью тему. Таня верно в статье замечает, что менеджеры такому «обрадуются», конечно. К тому же кому-то тёмная тема как раз более комфортна для зрения, чем режим сепии. Но задуматься о том, что доступность — это не только про контрастность, важно.

https://a11y-blog.dev/ru/articles/is-sepia-mode-essential/

Традиционно вылетаю в родную Уфу на Ufadevconf. Наконец-то нашёл куда пристроить доклад про песочницы на node.js-бэкенде. Везу мерч, подходите с вопросами. Трансляции не будет.

Зато будет трансляция на юбилейном Я.Субботнике по фронтенду 15 декабря (что? да, Субботник будет в воскресенье!). Там и зафиналю тему. Непривычно делать так мало докладов за год, но что-то времени не хватает катастрофически.

Никита Прокопов негодует (как обычно). Обновил npm на минор и вылез ворнинг

(node:45421) ExperimentalWarning: CommonJS module /opt/homebrew/lib/node_modules/npm/node_modules/debug/src/node.js is loading ES Module /opt/homebrew/lib/node_modules/npm/node_modules/supports-color/index.js using require().
Support for loading ES Module in require() is an experimental feature and might change at any time
(Use node --trace-warnings ... to show where the warning was created)

Я мимо пройти не мог и решил разобраться. Первопричина понятна — node 23 включил экспериментальную поддержку синхронного require() для ESM-модулей. Зачем нужен ворнинг? Потому что поддержка неполноценная и если прилетит ESM c top level await то всё полетит к чертям (и это очень опасный момент с которым пока непонятно как жить).

Ладно, ясно-понятно, экспериментальная версия node.js споткнулась. Завтра починят. Вроде бы ничего такого. Получается, Никита не прав, у нас всё относительно хорошо? Ну, не совсем.

Интересен другой момент — почему это случилось на миноре npm и как оно работает в обычной node без реквайра? А разгадка простая:

Во-первых supports-color апнули на мажор. Это модуль от Синдре. Ну вы понимаете. Синдре опять переписал всё на pure ESM

Второй момент, как же оно работает сейчас? А никак не работает. Там внутри в debug/src/node.js — try catch

try {
   require('supports-color')
}  catch (error) {
        // Swallow - we only care if `supports-color` is available; it doesn't have to be.
}

И вот это уже печально. Апнули на сломанную версию, ошибок нет (они заглушены).

https://github.com/npm/cli/issues/7857

Алло, москвичи и рядом! 14 декабря пройдёт ночь опенсорс библиотек, в которой будет участвовать в том числе и моя команда. Событие как минимум необычное.

Сам я туда, к сожалению, не попадаю, так как уже 15 декабря надо быть на Субботнике по фронтенду в Петербурге.

Заметил, что многие пропустили появление satisfies в TS 4.9, а штука-то классная.
Объясняю на пальцах. Иногда нам нужно убедиться, что объект соответствует какому-то типу, но при этом нужно сохранить специфичность типа.

type TestType = {a: number | string; b?: string};

const testObject = {a: 1} as TestType;

testObject.a.toFixed(); // Ошибка: Property 'toFixed' does not exist on type 'string'.

Используем satisfies

type TestType = {a: number | string; b?: string};

const testObject = {a: 1} satisfies TestType;

testObject.a.toFixed();  // Никаких ошибок

testObject.b?.toUpperCase(); // Ошибка: Property 'b' does not exist on type '{ a: number; }'

Вспомнил, что уже несколько дней как пора посмотреть доклад Вадима Макишвили «42».
Посмотрел, он не про 42.

Начинаем через 15 минут https://www.youtube.com/watch?v=P_cOatmYIbU

А вот и доклады с Субботника

https://youtu.be/sW63V-B6HMc

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

Простой совет как драматически улучшить ваши Express-приложения.
Удалите миддлвары — хотелось бы, но не всегда возможно.

Но достаточно запретить передавать req и res дальше контроллера — и вот уже приятнейшие улучшения в нашем коде возникают сами по себе.

Зачем писать итоги года, когда ответ есть на https://git-wrapped.com/

Ладно-ладно, чуть попозже напишу.

Технические итоги года

Мне в Яндексе повезло попасть в команду, которая живёт в Гитхабе. Редкий случай для компании, мы не держим код в огромном общем монорепозитории (но мне иногда хочется переехать в свой маленький). И всё то бесконечное количество работы, сделанное за год — вот оно, на зелёном ковре с серыми клеточками отпусков и выходных. Было много работы, было много кода.

Основным рабочим направлением в этом году стала изоляция пользовательских (чужих) скриптов в node.js и в браузере. Копал весь год, пробовал, собирал знания в доклады. Начал обкатывать тему ещё весной в Алматы, бета-версию прокатил в Уфе и финализировал уже как надо в Петербурге на юбилейном Субботнике. Редкий случай для меня, когда за доклад совершенно не стыдно.

В конце года пошёл закрывать пробелы в знаниях, прохожу на Практикуме курс по веб-пентестингу. Рядом лежит незаконченный курс на инженера облачных сервисов, надо и его добить. На следующий год у нас запланировано много Кубернетиса, фронтенд стал совсем не простым. И кто же его таким сложным сделал, кто, я спрашиваю?

Гаджеты года

В конце прошлого года купил стимдек. Железка очень прикольная, но игры опять меня не затянули. Продал. Уж не знаю, хорошо это или плохо, но игры скорее меня утомляют, чем дают удовольствие. Впрочем, Portal 2 был не плох и не забрал много времени.

Весной немного сломался айфон. Телефон уехал на пару месяцев в гарантийный ремонт и пришлось выбирать с чем теперь ходить. Выбрал Pixel 7 и стойко держался. Как только ремонт закончился — тут же перепрыгнул обратно. Причины: ну во-первых Pixel 7 это лопата. Большая и скользкая. А я люблю пользоваться телефонами без чехла (в чехле это какая-то мега-лопата уже). Во-вторых интерфейсы какие-то... ну вот чуть чуть не доделанные. Тут бы шрифт покрупней, тут бы отступы побольше, тут бы анимации плавнее — и другое дело было бы. Кажется, можно сделать ещё один заход, но нужно выбрать что-то поменьше и поприятнее. В том числе тактильно поприятнее (как же хорош простой айфон 15 без чехла: матовая спинка, алюминиевые боковинки).

Оставшись без телефона я тут же лишился и часов. Умные часы мне не нужны, а вот трекать физическую активность я люблю. Пришлось окунуться в мир Garmin и теперь у меня на полочке стоят ряды коробочек с велокомпьютером, нагрудным датчиком и часами. Часами — потому что начал с Vivomove Trend. Красивые, но достаточно бесполезные часы без GPS. Зато со стрелками, которые вечно сбиваются со своих позиций когда трясёшься на велосипеде по гравийным дорогам. Поменял на Forerunner 255 на MIP. Что хочу сказать: заряжать часы не каждый день, а иногда — это свобода почище скайпа. Реально классно. Кнопки на часах это тоже очень здорово. Из минусов — относительно красивые часы Garmin делает только за очень большие деньги, даже думать страшно. Красивые интерфейсы Garmin не делает никогда. Так что хочу посмотреть ещё на Suunto Race S. Финны, не подкачайте.

Купил в этом же году Kindle Scribe на замену вечно разряженному айпаду. Scribe хорош всем, кроме веса. Если вам не нужно читать PDF, то лучше смотреть на версии поменьше. Перо в комплекте прикольное, но с каждым днём я достаю его всё реже. Не стоит того.

Рюкзак года

Достал с антресолей старенький Pacsafe Vibe 40 и так он мне зашёл в поездках! Фактически это чемоданчик на лямках, без кучи карманов, но с очень удобным большим отделением, которое открывается как тот самый чемодан. А большего мне и не нужно.

Что по фитнесу?

Отчаянно борюсь с возрастным замедлением метаболизма. Несмотря на две тренировки в зале в неделю плюс велосипед/сноуборд по выходным, буксую на месте, медленно подползая к психологической отметке в 100 кг. В принципе-то нормально на мои 190 см роста, если бы это были мышцы. Успокаиваю себя, что без спорта было бы хуже. Не затягивайте до 40, с нашей-то сидячей работой и вечными переработками.

Ну вот кажется и всё. За кадром осталось куча важного, про которое вам знать не нужно, да и не место этому в технических итогах.

Всех с наступающим, остаёмся на связи, держимся!

Личные итоги года

В комментах просят не только техническими делиться. Я конечно тот ещё блогер и не думаю, что стоит выносить личное в публичное, но как элемент саморефлексии попробую.

Очень многое изменилось в мой жизни этом году. Тектонические потрясения просто. Меньше котов, больше семьи. Меньше свободного времени, выше цена свободной минуты, что заставляет лучше фокусироваться на важном.

Студия и дом разделились на две не связанные сущности, что наверное даже хорошо. Были бы они ещё бы географически ближе друг к другу.

Было много новых городов, от Гонконга до Гаваны. Но и без дальних поездок старался и стараюсь проводить каждое воскресенье подальше от города. Спонтанно ездил в Выборг микротрипом по утрам, открывал новые веломаршруты мимо Сестрорецких болот. Ночевали в домиках в Ленобласти и Карелии. Катались на моторке по ладожским шхерам и на сапе по Вуоксе, ловили последние летние закаты с островов. Сейчас зима, а значит машину не покидает сноуборд и нужно ещё найти место для горных лыж и может быть даже не для одной пары. Постоянно мысли о машине с большим багажником.

Кстати, о машинах — одно из классных впечатлений этого года это перегон Логана на ручке из Орла в Петербург. Отличная машина оказалась, тем более на палке-то. Балдел всю тысячу километров, в том числе и на пассажирском кресле.

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

Помните, что люди рядом с вами — они важнее всего остального происходящего в мире. И если рядом с вами таких людей нет, то желаю вам найти их в новом году. Я вот нашёл.