The Artisan’s Forge: توسعه Node.js با قدرت افزونه های بومی

شما در اوج تسلط بر جاوا اسکریپت هستید. برنامه‌های Node.js شما بهینه‌سازی شده‌اند، معماری‌های شما پایدار هستند و الگوهای async/wait شما شعر هستند. با این حال، گاهی اوقات محدودیتی را احساس می‌کنید – یک زمزمه آرام و پیوسته از موتور V8 که به شما یادآوری می‌کند که با تمام قدرتش، هنوز یک ماشین مجازی است.

وظایفی وجود دارند که در قلمرو متفاوتی زندگی می کنند:

• بارهای کاری محدود به CPU را که حلقه رویداد را مسدود می کنند، حذف کنید.
• پردازش تصویر یا صدا را در زمان واقعی انجام دهید.
• با یک کتابخانه C++ قدیمی که حاوی سس مخفی شرکت شما است، یکپارچه شوید.
• تعامل مستقیم با سخت افزار یا API های سطح سیستم.

وقتی به آن دیوار برخورد می کنید، یک انتخاب دارید. می توانید سعی کنید در جاوا اسکریپت دور آن کار کنید، یا می توانید یک لایه عمیق تر بروید. می توانید وارد شوید جعل و یک Native Addon ایجاد کنید.

این سفر برای افراد ضعیف نیست. این هنر تلفیق قدرت خام و مدیریت نشده C++ با دنیای زیبا و مدیریت شده جاوا اسکریپت است. و ابزار اصلی این کاردستی است N-API.

سندان: درک N-API

در قدیم، نوشتن افزونه بومی هنر شکننده ای بود. کد ++C شما ارتباط نزدیکی با نسخه خاص موتور V8 داشت. یک ارتقای کوچک Node.js می‌تواند افزونه‌ای را که با دقت ساخته شده‌اید، شکسته و باعث کامپایل مجدد دردناک شود.

N-API (Node-API) انتزاعی است که همه چیز را تغییر داد. این یک لایه API قوی و مبتنی بر C است که بین کد C/C++ و موتور V8 قرار دارد. به آن به عنوان یک آداپتور جهانی فکر کنید.

• کد ++C شما ↔ N-API (لایه پایدار) ↔ موتور V8 (متفاوت است)
• یک بار بنویس، هر جا کامپایل کن. افزونه ای که با N-API برای Node.js 14 ساخته شده است، در اکثر موارد بدون کامپایل مجدد بر روی Node.js 22 اجرا می شود.

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

طرح اولیه: اولین افزونه متولد شده شما

بیایید یک مصنوع ساده اما قدرتمند ایجاد کنیم: یک تابع همزمان که nامین عدد فیبوناچی را محاسبه می کند. در جاوا اسکریپت، این یک مسدود کننده حلقه رویداد کلاسیک است. در C++، این یک محاسبه ساده است.

مرحله 1: راه اندازی Forge (زنجیره ابزار)

ابتدا به ابزار مناسب نیاز دارید. این اغلب سخت ترین قسمت است.

# On macOS
xcode-select --install

# On Ubuntu/Debian
sudo apt-get install build-essential

# The key node module: node-gyp. This is your build system.
npm install -g node-gyp

یک پروژه جدید ایجاد کنید و سندان را ترسیم کنید:

my-native-addon/
├── binding.gyp       # The build configuration
├── package.json
├── src/
│   └── fibonacci.cc  # Our C++ masterpiece
└── test.js          # The JavaScript that will call our addon

مرحله 2: طلسم ساخت (binding.gyp)

این فایل می گوید node-gyp چگونه افزونه خود را کامپایل کنیم

{
  "targets": [
    {
      "target_name": "fibonacci",
      "sources": [ "src/fibonacci.cc" ],
      "include_dirs": [ "\"require('node-addon-api').include\")" ],
      "dependencies": [ "\"require('node-addon-api').gyp\")" ],
      "cflags!": [ "-fno-exceptions" ],
      "cflags_cc!": [ "-fno-exceptions" ],
      "defines": [ "NAPI_DISABLE_CPP_EXCEPTIONS" ],
    }
  ]
}

استفاده می کنیم node-addon-api یک بسته بندی C++ که رابط ارگونومیک تری را برای N-API مبتنی بر C فراهم می کند.

مرحله 3: خود اثر هنری (src/fibonacci.cc)

اینجاست که جادو اتفاق می افتد. ما کدی می نویسیم که در دو جهان زندگی می کند.

#include  // The central header for node-addon-api

// The pure C++ function - fast, unmanaged, no JavaScript awareness.
int Fibonacci(int n) {
  if (n  2) return n;
  return Fibonacci(n - 1) + Fibonacci(n - 2);
}

// The Bridge Function - This is where N-API works its art.
// It translates JavaScript arguments into C++ types, calls the function,
// and translates the C++ result back into a JavaScript value.
Napi::Value CalculateFibonacci(const Napi::CallbackInfo& info) {
  // The Napi::Env is our connection to the JavaScript world.
  Napi::Env env = info.Env();

  // 1. Validate the number of arguments
  if (info.Length()  1) {
    Napi::TypeError::New(env, "Wrong number of arguments")
        .ThrowAsJavaScriptException();
    return env.Null();
  }

  // 2. Validate and convert the first argument to a C++ integer
  if (!info[0].IsNumber()) {
    Napi::TypeError::New(env, "Number expected").ThrowAsJavaScriptException();
    return env.Null();
  }
  int n = info[0].AsNapi::Number>().Int32Value();

  // 3. Call our pure C++ function
  int result = Fibonacci(n);

  // 4. Convert the C++ integer back to a JavaScript Number and return it.
  return Napi::Number::New(env, result);
}

// The Init function - This is the entry point, called when the module is required.
// It defines what we expose to the JavaScript world.
Napi::Object Init(Napi::Env env, Napi::Object exports) {
  // Set the "calculate" property of the `exports` object to our bridge function.
  exports.Set(Napi::String::New(env, "calculate"),
              Napi::Function::New(env, CalculateFibonacci));
  return exports;
}

// This macro declares the entry point for the Node.js module.
NODE_API_MODULE(fibonacci, Init)

این کد یک رقص زیبا است. CalculateFibonacci مفسری است که مقادیر را به دقت در مرز JavaScript/C++ جابجا می کند. این اجبار، پرتاب استثنا، و مدیریت حافظه را کنترل می کند – قهرمانان ناشناخته توسعه پلاگین بومی.

مرحله 4: مصنوع را موج بزنید

اکنون آن را می سازیم و از آن استفاده می کنیم.

node-gyp configure
node-gyp build

این کد C++ شما را در یک کامپایل می کند ./build/Release/fibonacci.node file—یک ماژول باینری که Node.js می تواند require().

// test.js - This is where the magic becomes visible.
const nativeAddon = require('./build/Release/fibonacci.node');

console.log('Starting native calculation...');
console.time('Native');
const resultNative = nativeAddon.calculate(45);
console.timeEnd('Native'); // ~0.5 seconds
console.log(`Result (Native): ${resultNative}`);

console.log('Starting JS calculation...');
console.time('JS');
const resultJS = fibonacciJS(45);
console.timeEnd('JS'); // ~8.5 seconds
console.log(`Result (JS): ${resultJS}`);

// A naive JS implementation for comparison
function fibonacciJS(n) {
  if (n  2) return n;
  return fibonacciJS(n - 1) + fibonacciJS(n - 2);
}

نتیجه غیر قابل انکار است. شما از قدرت محاسباتی خام استفاده کرده اید.

لمس استاد: تکنیک های پیشرفته

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

1. عملیات ناهمزمان: قدرت واقعی از انتقال کار سخت به خارج از چرخه رویداد ناشی می شود. با استفاده از N-API AsyncWorker کلاس، می‌توانید کد ++C خود را در یک رشته جداگانه اجرا کنید و نتیجه را از طریق callback یا Promise به حلقه رویداد JS برگردانید و به عملکرد غیر مسدود کننده دست یابید.

2. کار با اشیا: شما می توانید اشیاء پیچیده جاوا اسکریپت را از C++ ایجاد کنید، آنها را پس دهید و حتی با خواندن و نوشتن ویژگی های آنها، آنها را به عنوان آرگومان دریافت کنید.

3. مدیریت حافظه: N-API ابزارهایی را برای کار با جمع‌آوری زباله جاوا اسکریپت فراهم می‌کند و به شما امکان می‌دهد از نشت حافظه در زمانی که اشیاء C++ به اشیاء JS ارجاع دارند و بالعکس، جلوگیری کنید.

سنگ فیلسوف: چه زمانی باید از آن استفاده کنید؟

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

زمانی که از Native Addon استفاده کنید:

• شما یک گلوگاه تأیید شده با CPU فشرده دارید.
• شما باید با کتابخانه های C/C++/Rust موجود یکپارچه شوید.
• شما با محاسبات سنگین ریاضی، پردازش تصویر یا رمزنگاری سروکار دارید.

زمانی که:

• افزایش عملکرد ناچیز است.
• بار تعمیر و نگهداری (کامپایل برای پلتفرم های مختلف، بخش های اشکال زدایی) بیشتر از مزیت آن است.
• می توانید مشکل را با نخ کارگر یا الگوریتم های بهتر حل کنید.

شاهکار تمام شده

نوشتن Native Addon با N-API بهترین بیان از مجموعه مهارت های یک توسعه دهنده ارشد تمام پشته است. او درک عمیقی از کل پشته نرم افزار، از جاوا اسکریپت سطح بالا گرفته تا فلز را نشان می دهد.

شما دیگر فقط یک مسافر در زمان اجرا Node.js نیستید. شما کمک خلبان شدید و توانایی های او را گسترش دادید. شما وارد فورج شدید، مواد خام سیستم را مدیریت کردید و با ابزار جدیدی ظهور کردید که بهره وری را به میل شما تغییر می دهد.

این فقط کدنویسی نیست. این صنعت در بالاترین درجه است. حالا برو آن گلوگاه را پیدا کن و راه حلت را بساز.