Node Master – Telegram
Node Master
1.03K subscribers
24 photos
2 files
156 links
Group Chat: @nodemastergp
Admin: @napoleon_n1
Download Telegram
Channel created
Channel photo updated
console.log("Welcome To Node Master")
👍6
اگر با Nodejs کار میکنید قطعا اسم Deno رو هم به عنوان یک Runtime رقیب میشناسید.
به تازگی نسخه 1.28 این Runtime منتشر شد.

حالا چنل یوتیوب رسمی Deno در یک لایو استریم قرار هست راجع به ویژگی های جدید این نسخه صحبت کنن

https://www.youtube.com/live/5tUDSrnHFPk?si=xg5BpMhSti4PlbMl
👍1
نسخه LTS جدید برای NodeJs منتشر شد.
بزودی لیستی از ویژگی های این نسخه در اینجا خواهم گذاشت.
اگر هم دوست دارید میتونید خودتون برید بخونید.

https://nodejs.org/en/blog/release/v20.9.0
👍1
یکی از مشکلاتی که Node داشت و Deno سعی بر حل آن بود امنیت اجرای پکیج های 3rd party بود که اگر پکیجی بخواهد کارهایی از قبیل دسترسی به network یا خواندن و نوشتن دیتا روی disk انجام دهد شما باید به عنوان developer تایید کنید و اجازه دسترسی بدهید.
و حالا در Node 20 LTS شاهد این موضوع هستیم که تیم توسعه دهنده این ويژگی رو به صورت آزمایشی در Node پیاده سازی کردند که باعث امیدواری زیادی هست.
// fileread.js
import { readFileSync } from "fs";
const content = readFileSync("myfile.txt");
console.log(content);
حالا شما اگر فایل fileread.js رو اگر با کامند

node fileread.js

به صورت معمول استفاده کنید همه چیز طبق روال قدیم اجرا خواهد شد.
ولی اگر بخواهید از این ویژگی استفاده کنید حتما باید برنامه خود را با flag

--experimental-permission

اجرا کنید.
node --experimental-permission fileread.js
حالا با اجرای fileread با این flag شما با ارور زیر مواجهه خواهید شد که در بخش توضیحات ارور میگه برنامه شما در حال تلاش برای خواندن فایل از روی دیسک است و دسترسی به خواندن فایل از روی سیستم نیاز است.
node --experimental-permission fileread.js                    
node:internal/modules/cjs/loader:178
const result = internalModuleStat(filename);
^

Error: Access to this API has been restricted
at node:internal/main/run_main_module:23:47 {
code: 'ERR_ACCESS_DENIED',
permission: 'FileSystemRead',
resource: '/home/imanhpr/Desktop/sandbox/nod/fileread.js'
}
Node.js v20.9.0

حال برای دادن مجوز های لازم به برنامه میتوانید از این کامند استفاده کنید تا برنامه شما دسترسی به خواندن فایل داشته باشد.
node --experimental-permission --allow-fs-read='*' fileread.js 
این ویژگی امنیت پروژه های شما رو تا حدود زیادی بالاتر میبرد و به پکیج های نصب شده توسط npm اجازه ارسال اطلاعات بدون دسترسی نمیدهد و درصورتی که پکیج مخربی نصب کنید به سرعت متوجه خواهید شد.
👍7
یکی دیگر از قابلیت های بسیار خفن Node 20 LTS که باز هم الهام گرفته از Deno هست، ایجاد Single executable applications هست. یعنی دیگر شما نیازی نیست که حتما node روی سیستم نصب داشته باشید برای اجرای برنامه های nodejs و میتونید با ایجاد یک فایل executable ( به عنوان مثال فایل های .exe در ویندوز ) برنامه خودتون رو به راحتی منتشر کنید.
البته این ویژگی نیز دوباره به صورت Experimental اومده و هنوز خیلی محدودیت هایی دارد ولی خب در آینده یکی به عنوان یک ویژگی خیلی خوب node میشه ازش نام برد. در حال حاظر فقط میتوان به صورت پیشفرض از Std خود node استفاده کرد یعنی دسترسی به پکیج های npm به صورت پیش فرض نداریم ( میتونیم اضافه کنیم و در پست های بعدی آموزشش رو حتما خواهم گذاشت)
اگر خودتون دوست دارید جزیات بیشتر رو ببینید اینجا میتونید برسی کنید.
https://nodejs.org/api/single-executable-applications.html#single-executable-applications
👍4
Node Master
نسخه LTS جدید برای NodeJs منتشر شد. بزودی لیستی از ویژگی های این نسخه در اینجا خواهم گذاشت. اگر هم دوست دارید میتونید خودتون برید بخونید. https://nodejs.org/en/blog/release/v20.9.0
تغییر دیگری که در NodeJs 20 LTS شاهد هستیم Stable شدن Test runner خود Node هست که بنظرم خیلی بهتر از پکیجی مثل Jest هست. البته vitest خیلی قوی عمل کرده من خودم vitest رو داخل چند پروژه استفاده کردم و واقعا قدرتمند بود. این دو پکیج رو در حال حاظر نمیتونم مقایسه کنم ولی در آینده قطعا از Test Runner خود Node در یک پروژه استفاده خواهم کرد.
اگر قصد یادگیری unit test نوشتن دارید پیشنهاد میکنم یا از vitest یا همین پکیج استفاده کنید و سمت jest نرید چون مشکلات خیلی زیادی داره و ممکنه ساعت ها اذیت کنه شما رو مخصوصا با type noscript.
به عنوان مثال فایل main.js
export function sum(input) {
return input + 2;
}

export function minus(input) {
return input - 2;
}
حال تست های مربوط به خودمون رو داخل فایل زیر قرار میدهیم. test/main.spec.js
import assert from "assert";
import { describe, test } from "node:test";
import { sum } from "../main.js";

describe("Check Sum Function.", () => {
test("Sum 2 + 2 = 4", () => {
const result = sum(2);
assert.strictEqual(result, 4);
});
test("Sum 4 + 2 == 6", () => {
const result = sum(4);
assert.strictEqual(result, 3);
});
});
برای اجرای تست ها میتوانید از flag

--test

استفاده کنید.
node --test
در صورتی که میخواهید Test coverage بگیرید میتوانید از flag

--experimental-test-coverage

استفاده کنید
node --test --experimental-test-coverage
کلا میتوان درمورد تست ساعت ها میتوان بدون وقفه صحبت کردن و نوشتن تست خوب از نوشتن اصل برنامه کار سخت تری هست. و اگر قصد مهاجرت دارید یکی از skill هایی که قطعا از شما انتظار میرود توانایی نوشتن تست های خیلی خوب میباشد.
در آینده درمورد نوشتن تست و تکنیک های unit test نوشتن قطعا صحبت خواهیم کرد.
👍3
راستی برای دیدن code snippet ها به شکل مناسب حتما تلگرام خودتون رو آپدیت کنید رفقا.
👍3
Node Master pinned «راستی برای دیدن code snippet ها به شکل مناسب حتما تلگرام خودتون رو آپدیت کنید رفقا.»
#include <iostream>

int main()
{
std::cout << "Let The Performance Begin!\n";
return 0;
}

به عنوان برنامه نویس BackEnd شما صرفا نباید یک framework developer باشید. باید به درجه ای برسید که بیت به بیت دیتایی که دارید کار باهاش انجام میدید رو بشمارید.
برای رسیدن به همچین سطحی که برای بهینه کردن در حد Bit و Byte صرفا فقط کد زدن و یاد گرفتن زبان و فریمورک جدید کافی نیست. باید در مسیری قدم بزاری که این روزا کمتر آدمایی قدم میزارن. یعنی باید با عینک علمی تر و حتی شاید خننده دار باشه ولی فلسفی تر نگاه کرد.

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

کلا ذات هر سیستم نرم افزاری بسیار بسیار شکننده هست. برای این که نرم افزار ما از این شکنندگی خارج شود باید ( تاکید میکنم باید ) این نکات رو بدونیم.

یک نکته ای هم بگم که شما میتونید تا ابد یک framework developer باشید با درامد خیلی عالی در کشور های تاپ دنیا و هیجی از این نکات هم ندونید.

این فقط عطش یادگیری هست که مثل بنزین در این مسیر به شما انرژی میده که رو به جلو قدم بردارید.

یک سری از موضوعاتی که در این مورد ساعت ها خواهیم وقت گذاشت از این قبیل هستند :
- Compile time vs Runtime
- Dynamic typing vs. static typing
- Strong and weak typing
- Runtime errors vs compile time errors
- Compile time and Runtime Polymorphism
همین الان چند بار در این لیست کوتاه که تیتر وار اشاره کردم کلمه Runtime و Compile time چند بار تکرار شد که اهمیت بالای این موضوع رو نشون میده.
وقتی که بتونید کدتون رو با این عینک که چه تاثیری در Runtime یا Compiletime برنامه میتونه داشته باشه فارغ از زبان برنامه نویسی ببینید.
خودتون اون روز متوجه حرف من خواهید شد که چه تاثیری در استایل کد زدن شما خواهد داشت.

الان حضور ذهن ندارم ولی از این دسته موضوعات کم نیست و این که باهم عمیق به هرکدوم نگاه میکنیم.

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

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

۱.چیست؟
۲.چرا؟


#TIP
👍8
Node Master
#include <iostream> int main() { std::cout << "Let The Performance Begin!\n"; return 0; } به عنوان برنامه نویس BackEnd شما صرفا نباید یک framework developer باشید. باید به درجه ای برسید که بیت به بیت دیتایی که دارید کار باهاش انجام میدید رو بشمارید.…
کتاب درمورد #Golang میخوندم و این پارگراف یکی از زیباترین متن هایی بود که تا حالا دیدم.
درمورد مفهومی وارد شده از دنیای مسابقات اتومبیل رانی به دنیای نرم افزار به اسم mechanical sympathy صحبت میکنه و میگه راننده ای که دقیق با جزیات میدونه ماشینش چطور کار میکنه میتونه تا آخرین ذره قدرت ماشینش رو بکشه بیرون.
حالا شما کلمه "راننده" رو با "برنامه نویس" و ماشین رو با "زبان برنامه نویسی" یا "Runtime env" یا کلمات دیگ جایگزین کن.

و در اخر هم شخصی به اسم Martin Thompson در سال 2011 این موضوع رو سعی کرد در دنیا برنامه نویسی اجرا کنه.

اگر کجکاوی بیشتر دارید اینجا میتونید سر بزنید.

https://mechanical-sympathy.blogspot.com/
👍7
بزارید با یک خلاصه از Deno شروع کنیم.
کلا Deno هم مثل Node یک Runtime Environment هست که شما کد جاوا اسکریپت مینویسی و با استفاده از API هایی که Deno در دسترس شما قرار میده میتوانید با سیستم عامل ارتباط بگیرید.
مثل ایجاد HTTP Server یا TCP Socket یا خواندن و نوشتن فایل.

از ویژگی های مثبت Deno بخوام بگم موضوعات زیر هست.
- سرعت بالاتری که نسبت به Node داره.
- با استفاده از permission سیستمی که داره امنیت خیلی زیادی به پروژه های شما میده که Node در نسخه 20 LTS سعی کرد این ویژگی رو که از Deno الهام گرفته اجرا کنه
مثال :
شما یک فایل myfile.txt دارید که یک متن داخلش نوشته شده و میخواید از روی دیسک بخونید.
// main.ts
const result = Deno.readTextFileSync("myfile.txt");
console.log(result);
با دستور زیر اگر بخواید برنامه رو run کنید
deno run main.ts
ازتون میپرسه که آیا به برنامه اجازه خوندن فایل روی دیسک با جزیات دقیق میدی یا خیر که با وارد کردن Y همه چی اوکی میشه.
Deno requests read access to "myfile.txt".
├ Requested by `Deno.readFileSync()` API.
├ Run again with --allow-read to bypass this prompt.
└ Allow? [y/n/A] (y = yes, allow; n = no, deny; A = allow all read permissions) > y
حالا شاید این موضوع احمقانه بنظر برسه ولی اگر یک پکیج که یک شخص ناشناس نوشته و شما از npm نصب بکنید اگر بخواد خراب کاری کنه بهتون خبر میده و متوجه میشید و قبلا این موضوع در node خیلی مشکلات امنیتی ایجاد کرده بود.
البته حالا node هم همین ویژگی رو داره اوکی میکنه.
https://news.1rj.ru/str/NodeMaster/7
- موضوع بعدی این که به راحتی #TypeScript رو اجرا میکنه و نیازی به transpile کردن به js برای اجرا نداره و خودش مستقیم ts رو اجرا میکنه. مثل ts-node.
- نکته بعدی این که سعی بر این شده که از Web api های استاندارد برای interface شدن با api های سیستم عامل استفاده بشه که این میتونه مزیت خوبی باشه به این دلیل که اگر web api های js رو بلد باشین اینجا نیازی نیست چیز جدیدی یاد بگیرید.
- موضوع بعدی این که از پکیج های npm هم میتوانید داخل deno استفاده کنید. پکیج های npm که برای node توسعه داده شدند سرعت کمتری نسبت به پکیج های native خود deno دارند و این که مشکلاتی هم از نظر سازاگاری هست. درکل در بهترین حالت این هست که برنامتون کامل از api های deno استفاده کنه.
- به راحتی میتونید از برنامتون خروجی Single executable بگیرید با دستور و روی هر پلتفرمی اجرا کنید.
deno compile main.ts
به عنوان مثال یک http web server در deno
```json

{
"name": "Node Master",
"author": "imanhpr"
}
```

```javanoscript
import user from "./user.json" with {type : "json"};

Deno.serve({port : 3005} , (req) => {
return new Response(JSON.stringify(user))
})

```
به این تکه کد شما یک http server برای پروداکشن دارید با پرفرومنس بالا.

از نکات منفی Deno بخوام بگم
- کامینیوتی کوچک
- پکیج های 3rd party کم
- کمبود منابع آموزشی.
در کل Deno برای با تجربه تر ها خوبه و برای تازه کار خوب نیست بازار کارش مشخص نیست و صرفا به عنوان سرگرمی باید بهش نگاه کرد هرچند پتانسیل خوبی داره و اینجا لیست کوچیکی از ویژگی هاش رو گفتم.
باهاش چنتا برنامه سعی میکنیم بنویسم و یکم نگاهی بهش بندازیم.
👍8
مفهوم CPS Style چیست و در NodeJs به چه صورت هست؟
خب دوستان همین الان بگم که خیلی از افرادی که با Node کار کردن تمام مدت از این استایل استفاده کردن حتی بدون این که اسمش رو بدونن.
بزارید با مثال و کد توضیح بدم خیلی راحت متوجه میشید.
function doSomething() {
return "Something important"
}

در این کد خیلی ساده وقتی ما به صورت مستقیم یک مقداری رو مستقیم return میکنیم به این میگن Direct Style یا استایل مستقیم.
حالا بریم سراغ CPS که در زبان های فانکشنال خیلی مرسوم هست و در Node هم این استایل زیاد دیده میشه مخصوصا api های قدیمی Callback base async
function doSomething(done) {
done("Something important");
}

function print(str) {
console.log(str);
}

doSomething(print);

در این برنامه ساده ما یک فاکشن داریم به اسم doSomething که یک فانکشن رو به عنوان رفرنس ورودی میگیره و بعد بجا return کردن خروجی نتیجه رو به عنوان arg با فانکشن done کال میکنه.
فانکشن print هم یک متن ورودی میگیره و صرفا لاگ میکنه
این همون callback عادی خودمون هست ولی خب با عینک علمی تر یک پترنی هست به اسم cps style که گاهی پیش میاد کلی callback تو در تو داشته باشیم.
بد بودن یا خوب بودن این موضوع در اینجا مهم نیست چون بحث سر این زیاده داخل Node.

خودتون قطعا این مورد رو میدونید ولی من میخواستم شما رو با استایل و پترنش آشنا کنم چون در یکی دو پست آینده چنتا کد میخوام معرفی کنم و این مقدمه اونا هست.
👍8
Node Master
مفهوم CPS Style چیست و در NodeJs به چه صورت هست؟ خب دوستان همین الان بگم که خیلی از افرادی که با Node کار کردن تمام مدت از این استایل استفاده کردن حتی بدون این که اسمش رو بدونن. بزارید با مثال و کد توضیح بدم خیلی راحت متوجه میشید. function doSomething() {…
در حال حاظر NodeJs برای هرکاری 3 API گاهی هم 2 API در دسترس شما قرار میده تا کارتون رو انجام بدید.
به مثال زیر دقت کنید.
import { readFile as readFileCps, readFileSync } from "node:fs";
import { readFile as readFilePromise } from "node:fs/promises";

// Sync api - Direct style.
const syncRead = readFileSync("myfile.txt", "utf-8");
console.log("1.", syncRead);

// Async api - CPS style.
readFileCps("myfile.txt", "utf-8", (err, data) => {
if (err) process.exit(1);
console.log("2.", data);
});

// Async Promise api - looks like sync style - await syntax
const asyncRead = await readFilePromise("myfile.txt", "utf-8");
console.log("3.", asyncRead);

// Async Promise api - looks like CPS style.
readFilePromise("myfile.txt", "utf-8").then((data) => console.log("4.", data));

کلا دقیقا داریم یک کار میکنیم خوندن فایل با استایل های مختلف که خود Node بهمون داده.
اولی به صورت Direct style هست و این عملیات Sync هست و یجاهایی مثلا برای load کردن config فایل کاربرد داره و به هیچ عنوان در http server این رو استفاده نکنید مگر این که دقیق میدونید کجا استفاده کنید.

دومین api که node به ما میده async از طریق cps استایل که node تضمین میکنه به صورت async کد شما اجرا میشه و اصولا async cps syle جز api های قدیمی async در node هستن. قبل از این که promise بیاد همیشه از اینا استفاده میشد.

سومی و چهارمی دقیقا یک شکل هستن اون پشت فقط ظاهرشون فرق میکنه و در خوانایی کد تاثیر داره و گاهی در شرایط خاص فقط از یکیشون میشه استفاده کرد.
هردو جز api های async در node هستن که با promise ها کار میکنند. از وقتی که Promise api ها وارد node شدن CPS style کمرنگ تر شد.

تمام این قصه ها رو گفتم تا برسم به اینجا که.
هنوز هم کد هایی در NodeJs وجود داره که CPS style هستند و معادل Promise API ندارند.
گاهی شما برای کارتون نیاز دارید که این CPS Style ها رو تبدیل کنید به Promise Api و حتی گاهی برعکس.
برای همین میخوام بهتون یک تکنیک نشون بدم با مثال کاربردی که چطور این کار رو انجام بدیم.
در این مدت هم اگر دوست داشتید فکر کنید ببینید خودتون میتونید چیزی پیدا کنید؟
👍5
برای پست های جدید کامنت هم باز شد.
اگر سوالی یا نظری داشتید خوشحال میشم کامنت هاتون رو ببینم.
و این که pv منم هرکی حس کرد کمکی از دست من بر میاد میتونه پیام بده
👍7
لطفا زیر این پست اگر نظری یا سوالی دارید.
کنجکاوی و پیشنهادی دارید.
ایده بهم بدید تا براتون راجع بهش توضیح بدم.
البته ادامه مفاهیم خودمون هم داریم
Node Master
در حال حاظر NodeJs برای هرکاری 3 API گاهی هم 2 API در دسترس شما قرار میده تا کارتون رو انجام بدید. به مثال زیر دقت کنید. import { readFile as readFileCps, readFileSync } from "node:fs"; import { readFile as readFilePromise } from "node:fs/promises"; // Sync…
خب پیرو سوالی که در اینجا گفتم امیدوارم خودتون اگر کنجکاوی کردین به نتیجه رسیده باشید.
در کتاب خانه
node:util
دوتا فانکشن وجود داره به اسم callbackify و promisify که کار این دو فانکشن این هست که CPS style رو تبدیل میکنه به Promise api و برعکس و نحوه کار کرد این دوتا رو الان میبینیم
import { callbackify } from "node:util";

// Promise to CPS
async function myJob() {
return "this is a result";
}

const cpsMyJob = callbackify(myJob);
cpsMyJob((err, result) => console.log("in cps :", result));

در این مثال ما یک فانکشن async داریم که خب همیشه یک Promise به ما میده و مشخصه. حالا جایی نیاز داریم که این رو تبدیل کنیم به CPS Style و با استفاده از فانکشن callbackify میتونیم نسخه CPS رو بسازیم.
توجه کنید که این نسخه طبق قرارداد کد های node اولین پارامتر رو err میزاره و شما باید در کد های پروداکشن این بخش رو حتما هندل کنید.
import { promisify } from "node:util";

// CPS to Promise
function myJobSync(done) {
return done(null, "this is a result");
}

const myJob = promisify(myJobSync);
console.log(await myJob());

و حالا اینجا ما یک فانکشن CPS style داریم که اومدیم اون رو با استفاده از promisify تبدیل کردیم و بعد نتیجه رو await کردیم و خب همه چی درست کار میکنه.

نکته خیلی خیلی مهم :‌ هر فانکشنی که Callback میگیره لزوما Async نیست دوستان. یعنی myJobSync درسته داره callback میگیره ولی عملیات داخلش به صورت sync هست و یعنی ما اگر از direct style استفاده کنیم منطقی تره ولی خب اینجا برا آموزش بود. برای async کردن کلا یک فرایند دیگ طی میشه که بعدا درمورد event loop که خواستیم صحبت کنیم حتما میگیم.

شما حتی میتونید کتاب خونه های استاندارد هم با این کار تبدیل کنید و استفاده اصلی این دوتا دقیقا اونجا هست
import { randomBytes } from "node:crypto";
import { promisify } from "node:util";

const _randomByte = promisify(randomBytes);
console.log(await _randomByte(5));

به عنوان مثال کتاب خونه node:crypto اکثرا api ها از حالت CPS style استفاده میکنن و خیلی نیاز میشه که اون ها رو بخوایم تبدیل کنیم به Promise که بتونیم await کنیم. و شما الان با این تکنیک راحت میتونید این کار انجام بدید.

در پست بعدی یک مثال خیلی کاربردی با هم میبریم جلو که میتونید داخل پروژه هاتون استفاده کنید و تمرین خوبی هم حتی هست برای عمیق تر شدن در NodeJS
👍5