این پست برای دوستانی هست که این ویدیو آپدیت 20.12 LTS مربوط به #NodeJS رو ندیند.

اگر در برنامه خودتون نیاز دارید که hash یک دیتا رو داشته باشیم فقط یک stream api برای این کار وجود داشت که استفاده از این api برای payload های کوچیک overhead زیادی داره و اما برای فایل های بزرگ واقعا api خوبی هست.

import { createHash } from "node:crypto";
const data = "this is my data";

const sha1 = createHash("SHA1");

const hexDigest = sha1.update(data).digest("hex");

console.log(hexDigest);

اما با این API جدید که در اختیار ما قرار گرفته overhead خیلی کمتری روی runtime داره و برای payload های کوچیک قطعا سریعتر و بهتر هست.

import { hash } from "node:crypto";

const data = "this is my data";
const hexDigest = hash("SHA1", data, "hex");

و این که ظاهرا مشکل type هم که در ویدیو گفته بودم فیکس شده. چون پکیج @types/node از تایم رکورد ویدیو از 20.12.2 به 20.12.5 آپدیت شده.

#Update

واقعا از همه شما دوستان متشکرم بابت حمایتتون و لطف زیادی که به من داشتین.
همزمان چنل تلگرام شدیم ۷۰۰ نفر و یوتیوب هم شدیم ۲۰۰ نفر و این خیلی برای من با ارزشه.
امیدوارم همگی موفق باشید و این که واقعا خیلی خیلی خوشحالم که تونستم مفید باشم.

کوچیک شما ایمان ❤️

راستی رفقای جدید. ما یک گروه برای صحبت کردن درمورد نکات فنی برای کمک به همدیگه داریم. خوشحال میشیم جوین بشید.

https://news.1rj.ru/str/nodemastergp

چند مدتی هست #Deno ورژن 1.42 منتشر شده و در این ورژن jsr.io رو به عنوان repo اصلی برای package های 3rd party خودش قرار داده و این بزرگترین حرکت این آپدیت بوده.
بزودی باهم این ویژگی برسی عمیق میکنیم.
https://deno.com/blog/v1.42
#Update

بلاخره وقت پیدا کردم یکم کتاب بخونم تا با همدیگه دوباره موضوعات عمیق رو برسی کنیم.
همین اول راه این رو پیدا کردم. که توییت کردم.
https://twitter.com/imanhpr_media/status/1778104041865711766?t=uKyyZV5Oo9j6HwO5Q6DWHQ&s=19

جایزه Turing award سال 2023 هم مشخص شد. آقای Avi Wigderson به خاطر سال ها تحقیق درمورد الگوریتم های ایجاد داده های random . این مقاله به نظرم جالب اومد دوست داشتید مطالعه کنید.

شاید براتون عجیب بیاد که به عنوان مثال کد زیر خیلی ساده باشه.

import { randomBytes } from "node:crypto";

const buf = randomBytes(8)

ولی این جایزه که معادل جایزه نوبل هست و مبلغ یک میلیون دلار هم شامل میشه برای پشت پرده این کد به ظاهر ساده هست که دهه ها تلاش شده.
#News
https://www.newscientist.com/article/2425914-mathematician-wins-turing-award-for-harnessing-randomness/

سلام رفقا ارادت. امروز در این ویدیو در ادامه مبحث Serialization and Deserialization قرار شده بود که باهم یک وب سایت داخلی رو چک کنیم. در این ویدیو باهم وب سایت digikala.com رو برسی میکنیم و یک بهینه سازی کوچک انجام میدیم و البته با یک encoding جدید به اسم unicode-escape آشنا میشیم و تاثیرش رو در api response ها به شکل مستقیم میبینیم به طوری که به طرز چشمگیری میتونیم حجم ترافیک مصرفی اینترنت کاربر و کلا ترافیک شبکه رو به طرز خیلی زیادی کاهش بدیم با همین تکنیک ساده!

ممنونم از digikala که فرصت همچین یادگیری و کنجکاوی برای ما فراهم کرد.

https://youtu.be/aPCqfRjf4BM

همونطور که در عکس میبینید #CPP یک زبان Multi-paradigm هست. انجین اصلی #NodeJS و موتور #V8 که کار Parse کردن #JavaScript رو انجام میده در حقیقت یک برنامه پیچیده هستن که با #CPP نوشته شده. حالا این موضوع باعث ایجاد یکی از بزرگترین کنجکاوی ها برای من هست و هنوز جواب دقیق رو نمیدونم و فقط براساس حدس هست.

اگر یکم با زبان هایی مثل #C و #CPP کار کرده باشید مخصوصا C قشنگ با استایل procedural و imperative آشنا میشید. حالا اگر به #NodeJS نگاه کنیم که یک سیستم Event-Driven هست سوال برای ما ایجاد میکنه که چطور این تغییر و شیفت در نوع پارادایم ایجاد شده؟
بزارید ساده تر بگم یعنی چطور با استفاده از یک سیستم procedural یا imperative یا OOP یک سیستم Event-Driven طراحی میکنیم؟ به نظر من قطعا اینجا به نوعی با Observer pattern طرف هستیم ( که ظاهرا میشه همون Event-loop در js )

یک مثال ساده تر در توسعه #FrontEnd میبینیم. که از #JavaScript که imperative هست به سیستمی مثل #React رسیدیم که declarative هست.

درکل این شیفت بین پارادایم ها موضوع جالبی برای مطالعه هست و قسمت سخت سوال پیدا کردن خط مرزی بین اونا هست که چطور انجام میشه.

باتوجه به این که Array هم در #JavaScript یک Object هست کاملا این syntax درسته. یعنی فانکشن ما میتونه با استفاده از this اگر به عنوان یکی از index های array تعریف شده باشه به خود array اورجینال که در حقیقت یک object هست دسترسی داشته باشه.

const myArr = [
  function myfn() {
    console.log(this[1]);
  },
  2,
];
myArr[0]();

این نکات رو بیشتر از زاویه fun fact یا عمیق تر شدن نگاه کنید. هیچ کد پروداکشنی پیدا نمیکنید این استایل کد ببینید.

آپدیت جدید برای MikroORM اومده و ساپورت از Microsoft Sql Server رو اضاف کرده.
https://mikro-orm.io/blog/mikro-orm-6-2-released

اگر با #NodeJS کار میکنید و میخواید performance یک بخش کد رو برسی کنید یک روش خیلی کلاسیک و مرسوم به شکل کد زیر هست. البته این نکته هم بگم که روی مرورگر هم همچین API داریم که میتونه برای بچه های #FrontEnd هم جذاب باشه.

function loop() {
  const startTime = Date.now();
  for (let i = 0; i <= 1e5; ++i) {
    console.log(i);
  }
  const endTime = Date.now();

  console.log("time : ", endTime - startTime);
}

loop();

خب این نکته رو باید در نظر گرفت که متد Date.now برای این کار مناسب نیست.
- میتونه در scale دقت کافی نداشته باشه.
- کلا Date به صورت Non-Monotonic Time که این میتونه دردسر ساز بشه و این هم در scale بیشتر تاثیر داره

حالا تعریف Monotonic Time چیه ؟
به صورت کلی به این معنی هست که میشه این زمان رو دستکاری کرد یعنی زمان رو عقب و جلو برد. یعنی به عنوان مثال در زمانی که مقدار startTime مشخص شد و تا وقتی که endTime برسیم این وسط یکی اگر بیاد ساعت سیستم رو دست بزنه یک ساعت ببره عقب زمان منفی به ما نشون میده و در این حالت اصلا زمان منفی معنی نداره. در کل Date Object تحت تاثیر مستقیم ساعت سیستم عامل هست.
حالا شاید این سناریو یکم دور از ذهن بنظر بیاد ولی در حالتی مثل تغییر ساعتی که هر ۶ ماه یکبار در سال انجام میشه میتونه تاثیر بزاره ولی خب باز هم خیلی ممکنه به چشم نیاد. به این حالت میگن Non-Monotonic. حالا اگر بتونیم یه راهی داشته باشیم که این وابستگی ها رو حذف کنیم و راهی داشته باشیم که وقتی زمان رو اندازه گیری میکنیم نتونیم به عقب برگردیم بهش میگیم Monotonic Time.

یک مثال واقعی تر رو بخوام بگم این مدل ساعت ها رو مثل یک stopwatch در نظر بگیرید که مثلا از لحظه شروع دویدن یک دونده استارت میخوره و تا خط پایان ادامه داره. ( اینجا به جا دونده شما #NodeJS رو در نظر بگیرید )

حالا بزارید کد بالا رو اصلاح کنیم با یک کد بهتر

import { performance } from "node:perf_hooks";

function loop() {
  const startTime = performance.now();
  for (let i = 0; i <= 1e5; ++i) {
    console.log(i);
  }
  const endTime = performance.now();

  console.log("time : ", endTime - startTime);
}

loop();

نکته ای که دونستنش در این سناریو جالبه این موضوع هست که Date.now در حقیقت شروع زمان ( شروع دویدن ) رو Unix Epoch (January 1, 1970, UTC) در نظر میگیره اما performance.now از لحظه ای که #NodeJS اجرا شده.
موضوع بعدی این هست که Date.now با دقت Milliseconds داره ولی performance.now دقت Sub-milliseconds و با دستکاری ساعت سیستم هم اتفاقی نمیافته چون Monotonic هست.

اگر دوست دارید دقیق بدونید #NodeJS process شما دقیقا در چه زمانی با دقت Sub-millisec اجرا شده میتونید اینطور متوجه بشید.

import { performance } from "node:perf_hooks";

console.log(performance.timeOrigin);

همکاری در پوزیشن توسعه دهنده بک اند
ما یک‌شرکت فناور مستقر در پارک علم و فناوری دانشگاه تهران هستیم. ما به دنبال یک همکار توسعه دهنده در پوزیشن بک اند با استک nest هستیم و توانایی های مورد انتطارمون:
تسلط بر typenoscript و فریمورک nest
توانایی کار با git
توانایی تست نویسی
توانایی داکیومنتیشن
توانایی کار گروهی و حل مساله
Naghshtech@gmail.com
@Ali_ramez

#Work

سلام دوستان ارادت امیدوارم حالتون خوب باشه. نسخه 22 برای #NodeJS منتشر شد و در این ویدیو با هم این آپدیت رو برسی میکنیم.
نکاتی که در این ویدیو خواهید دید.
- برسی drop شدن assert keyword در import assertions
- فلگ بسیار کاربردی --watch از حالت experimental خارج شد.
- استفاده از WebSocket client بدون نیاز به flag
- برای ویژگی جدید node --run
- برسی فانکشن جدید glob در node:fs
- مهمترین آپدیت یعنی قابلیت import کردن پکیج های ESM در CJS به صورت Sync که خیلی کاربردی هست و به کدبیس های Legacy کمک میکنه.
https://youtu.be/1kboVUp0F5w?si=O3RbwypIEZRJuRhE

خواستم تشکر کنم بابت گذاشتن این پست داخل چنلت. ایدی خودت رو پیدا نکردم گفتم اینجا تشکر کنم🧡
https://news.1rj.ru/str/Never_Forget_Semicolon

یکی از نکاتی که به برای بچه های #BackEnd و #FrontEnd به اندازه هم میتونه کاربردی باشه استفاده از static method های Array.from و Array.fromAsync. این نکته هم بگم که Array.fromAsync به تازگی با توجه به آپدیت #V8 در نسخه 22 برای #NodeJS منتشر شده و در نسخه های قبل در دسترس نیست.
حالا کار این متد ها به چه شکل هست با .from شروع میکنیم. شما اگر یک iterable obj داشته باشید شاید بخواید این Object رو تبدیل به Array کنید و معمولا از این تکنیک استفاده میشه.

const arr = [];
for (const v of iterableObj) {
  arr.push(v);
}

این استایل از برنامه نویسی بیشتر به نوعی imperative programming محسوب میشه و در زبان های procedural programming خیلی دیده میشه. با این حال که #JavaScript یک زبان Multi-paradigm هست و این استایل کد زدن مجاز هست ولی خیلی در کامینیوتی مرسوم نیست و کلا بیشتر کد های declarative و ترکیب OOP و Functional استفاده میشه. ( هرچند Functional خالص سخت هست در #JavaScript )
حالا اگر بخوایم کد بالا رو یطوری داشته باشیم که مرسوم تر باشه بین برنامه نویس های #JavaScript، در این سناریو متد های Array.from و Array.fromAsync به کمک ما میاد تا کد ما declarative تر بشه.
حالا برای تبدیل کد بالا کافی هست این کار رو کنید و بووم تمام!

const arr = Array.from(iterable);

اگر بخوام درمورد Array.fromAsync هم بگم این هست که دقیقا به همین شکل کار میکنه و تنها تفاوتش این هست که با async iterable ها و generator ها سازگار هست.

const arr = [];
for await (const v of asyncIterable) {
  arr.push(v);
}

حالا همین رو به این شکل تبدیل میکنیم.

const arr = await Array.fromAsync(asyncIterable);

هنوز یک قسمت جالب از داستان مونده بزارید با مثال بهتون نشون بدم.

Array.fromAsync(
  new Set([Promise.resolve(1), Promise.resolve(2), Promise.resolve(3)]),
).then((array) => console.log(array));
// [1, 2, 3]

اگر اینجا دقت کنید میبینید که میتونه سناریو مناسبی برای استفاده از Promise.all باشه ولی استفاده نشده به نظرتون تفاوت چیه؟
با استفاده از Promise.all تمام Promise ها به صورت همزمان تلاش به resolve شدن دارن یعنی داره concurrent انجام میشه اما در این سناریو بدون بلاک شدن event loop به ترتیب Promise ها resolve میشن.
راستی این ویژگی هم از نسخه 1.38 روی #Deno در دسترس بوده و این برای من خیلی جذابه که تیم #Deno اینقدر خوب دارن عمل میکنن. مدتی هست هر حرکتی در اکوسیستم اتفاق میافته #Deno از پرچم داران در سرعت آپدیت و رو به جلو حرکت کردن هست.
#Tip

من یک نظر دارم که استفاده از switch statement به شدت کد رو کثیف میکنه و هروقت کد #backend یا #frontend میبینم که استفاده شده حس خوبی نمیگیرم.

چندین سال هست که به جرات میتونم بگم شاید ۱۰ بار switch statement استفاده نکردم مگر روی legacy کدی باشم که همچین استایلی کد زده شده باشه.

دوست دارم نظر شما هم بدونم که چه فکر میکنید.

https://x.com/imanhpr_media/status/1785700265280102807?t=kv4Mr2FE8_CIDVl__IqclQ&s=09

سوال مصاحبه درمورد #NestJS
شما وقتی با #NestJS و #TypeScript در حال توسعه #BackEnd هستید خب به صورت روتین از Injectable ها در #NestJS استفاده میکنید.
حالا با فرض این که ما یک EmailService داریم که Injectable هست و میخوایم در سرویس پایین اون رو inject کنیم و استفاده کنیم. به کد پایین دقت کنید.

@Injectable()
class MyService {
  constructor(private readonly emailService : EmailService)
}

اینجا همه چی درست و عادی کار میکنه ولی اگر یکم با دقت بیشتری نگاه کنید این کد خیلی غیر عادی هست. باتوجه به این موضوع که در هنگام transpile شدن کد #TypeScript به #JavaScript تایپ ها حذف میشه.
حالا سوال اینجا هست که #NestJS چطور با استفاده از یک type یعنی EmailService متوجه میشه باید چه سرویسی رو inject کنه؟ در حقیقت اینجا از یک type یک logic داره که در برنامه ما استفاده میشه و برسی این black magic میتونه جذاب باشه.

نظراتتون رو کامنت کنید.

#Tip

یکی دیگ از api های کاربردی node:perf_hooks استفاده از فانکش mark هست. این فانکشن تقریبا کاربردی شبیه به فانکشن .now داره که در پست قبلی مربوط به این موضوع توضیح داده بودم ولی یکم دست ادم رو برای log گرفتن و داشتن metadata های مختلف باز میزاره. به عنوان مثال به این کد دقت کنید.

import { performance } from "perf_hooks";
import { setTimeout } from "timers/promises";

function myLogic() {
  // Complex logic
  return setTimeout(3000, "Hello NodeMaster");
}
const perf1 = performance.mark("start_perf_check");
await myLogic();
const perf2 = performance.mark("end_perf_check");

console.log(perf1);
console.log(perf2);

به عنوان مثال یک فانکشن داریم که داره یک کار خیلی پیچیده انجام میده و این فانکش زمان بر هست استفاد از .now ممکنه جالب نباشه چون در code base های بزرگ trace کردن یکم چالش میشه. این api ها یجورایی پشت پرده ابزار هایی مثل elastic apm یا sentry هستن ولی دونستن این api های خام میتونه بهتون دید خوبی بده هرچند به صورت روزمره استفاده نکنید.

در ادامه با استفاده از فانکشن mark اومدم یدونه مارک مشخص کردم که در نهایت نتیجه یک instance از PerformanceMark هست که همچین خروجی رو هم میبینیم بعد از log ها.

PerformanceMark {
  name: 'start_perf_check',
  entryType: 'mark',
  startTime: 25.279009,
  duration: 0,
  detail: null
}
PerformanceMark {
  name: 'end_perf_check',
  entryType: 'mark',
  startTime: 3027.833827,
  duration: 0,
  detail: null
}

در اینجا ما name رو میبینیم که اسم mark ما هست و نیازی به توضیح نداره. در حقیقت startTime هم دقیقا لحظه ای هست که اون mark رو ما call کردیم. از لحظه اجرا برنامه تا mark اول 25ms طول کشیده و بعد از 3 ثانیه mark دوم کال میشه که در نتیجه startTime دوم رو 3027ms میبینیم. اینجا یک نکته وجود داره که حدود 3ms از 3 ثانیه بیشتر شده که این خودش نشونه اتفاقات دیگ در runtime باشه و البته موضوع مهم تر این که تضمینی وجود نداره که async job شما دقیقا در تایمی که تعریف کردیم resolve بشه.

نکته بعدی این که mark به عنوان arg دوم یک object میگیره که شما میتونید توضیحات بیشتری اضافه کنید و البته مقدار startTime هم دستکاری کنید که پیشنهاد میکنم این کار نکنید مگر دقیقا میدونید دارید چیکار میکنید.

const metaData = { func: myLogic.name };

const perf1 = performance.mark("start_perf_check", {
  detail: metaData,
});
await myLogic();
const perf2 = performance.mark("end_perf_check", { detail: metaData });

حالا شما اگر این کد رو اجرا کنید اینبار detail دیگه null نیست و metaData obj رو ما میبینیم در لاگ.
طبق گفته داکیومنت در هنگام استفاده از mark همیشه و همیشه مقدار duration برابر با صفر هست و در حقیقت PerformanceMark یک subclass از performanceEntry هست که در آینده بیشتر باهاش آشنا خواهیم شد.
نکته بعدی این که مقدار entryType هم همیشه در این سناریو برابر با mark هست.

پست قبل مربوط به این موضوع : https://news.1rj.ru/str/NodeMaster/197

#Tip #NodeJS

خب ظاهرا در جهت ورژن جدید Express 5 حرکت های جدی داره صورت میگره که میتونید در این github issue اون رو پیگیری کنید.
https://github.com/expressjs/discussions/issues/233

#NodeJS

یکی دیگ از API های جالبه 'node:perf_hooks' استفاده از measure فانکشن هست که به ما در نهایت یک PerformanceMeasure obj برمیگردونه. این پست خیلی به پست قبل مرتبط هست پس حتما اول اون رو بخونید.
https://news.1rj.ru/str/NodeMaster/206
به مثال پست قبل اگر دقت کنید ما با استفاده از mark یک سری مارک مشخص میکنیم تا اون لحظه رو به صورت دقیق ثبت کنیم. حالا اگر بخوایم در دقیق ترین حالت ممکن duration رو اندازه گیری کنیم اینجا measure به کمک ما میاد.

import { performance } from "perf_hooks";
import { setTimeout } from "timers/promises";

function myLogic() {
  // Complex logic
  return setTimeout(3000, "Hello NodeMaster");
}
const perf1 = performance.mark("start_perf_check");
await myLogic();
const perf2 = performance.mark("end_perf_check");

const mes = performance.measure(
  "logicDuration",
  "start_perf_check",
  "end_perf_check"
);
console.log(mes);

در اینجا ما به عنوان arg اول یک نام برای measure مشخص میکنیم و در نهایت اسم startMark و endMark رو بهش پاس میدیم و نتیجه به صورت زیر میگیریم.

PerformanceMeasure {
  name: 'logicDuration',
  entryType: 'measure',
  startTime: 21.1939,
  duration: 3004.3700479999998
}

کلاس PerformanceMeasure مثل PerformanceMark پست قبل یک subclass از performanceEntry هست و entryType در این حالت همیشه measure هست.
حالت های دیگ استفاده از این فانکشن بدون endMark هست که در این حالت خود فانکشن مثل endMark عمل میکنه و در صورتی که هیچ mark در نظر نگیریم startTime با مقدار 0 هست و duration لحظه ای رو نشون میده که از شروع برنامه گذشته تا به اون measure رسیده.

#Tip #NodeJS