حول هذه الوثائق
أهلًا بك في وثائق مرجع API الرسمية لـ Node.js!
Node.js هو وقت تشغيل JavaScript مبني على محرك JavaScript V8.
المساهمة
قم بالإبلاغ عن الأخطاء في هذه الوثائق في متتبع المشكلات. راجع دليل المساهمة للحصول على إرشادات حول كيفية تقديم طلبات السحب.
مؤشر الاستقرار
في جميع أنحاء الوثائق، توجد مؤشرات على استقرار القسم. بعض واجهات برمجة التطبيقات مثبتة وموثوق بها لدرجة أنها من غير المرجح أن تتغير على الإطلاق. البعض الآخر جديد تمامًا وتجريبي، أو معروف بأنه خطير.
مؤشرات الاستقرار هي كما يلي:
[مستقر: 0 - مُهمل]
مستقر: 0 الاستقرار: 0 - مُهمل. قد تُصدر الميزة تحذيرات. لا يُضمن التوافق مع الإصدارات السابقة.
[مستقر: 1 - تجريبي]
مستقر: 1 الاستقرار: 1 - تجريبي. لا تخضع الميزة لقواعد إصدار الإصدار الدلالي. قد تحدث تغييرات غير متوافقة مع الإصدارات السابقة أو إزالة في أي إصدار مستقبلي. لا يُوصى باستخدام الميزة في بيئات الإنتاج.
[مستقر: 2 - مستقر]
مستقر: 2 الاستقرار: 2 - مستقر. تعد التوافق مع نظام npm البيئي أولوية عالية.
[مستقر: 3 - تراثي]
مستقر: 3 الاستقرار: 3 - تراثي. على الرغم من أنه من غير المرجح إزالة هذه الميزة ولا تزال مشمولة بضمانات الإصدار الدلالي، إلا أنها لم تعد تُحافظ عليها بنشاط، وهناك بدائل أخرى متاحة.
يتم تمييز الميزات على أنها تراثية بدلاً من أن تكون مهملة إذا لم يسبب استخدامها أي ضرر، وكانت موثوقة على نطاق واسع داخل نظام npm البيئي. من غير المرجح إصلاح الأخطاء الموجودة في الميزات التراثية.
استخدم الحذر عند استخدام الميزات التجريبية، خاصةً عند تأليف المكتبات. قد لا يكون المستخدمون على دراية باستخدام الميزات التجريبية. قد تُفاجئ المستخدمون الأخطاء أو تغييرات السلوك عندما تحدث تعديلات واجهة برمجة التطبيقات التجريبية. لتجنب المفاجآت، قد يحتاج استخدام ميزة تجريبية إلى علم سطر أوامر. قد تُصدر الميزات التجريبية أيضًا تحذيرًا.
نظرة عامة على الاستقرار
| واجهة برمجة التطبيقات | الاستقرار |
|---|---|
| Assert | (2) مستقر |
| خطافات غير متزامنة | (1) تجريبي |
| تتبع السياق غير المتزامن | (2) مستقر |
| عازل | (2) مستقر |
| عملية فرعية | (2) مستقر |
| عناقيد | (2) مستقر |
| وحدة التحكم | (2) مستقر |
| تشفير | (2) مستقر |
| قناة التشخيص | (2) مستقر |
| DNS | (2) مستقر |
| النطاق | (0) مُهمل |
| نظام الملفات | (2) مستقر |
| HTTP | (2) مستقر |
| HTTP/2 | (2) مستقر |
| HTTPS | (2) مستقر |
| المفتش | (2) مستقر |
الوحدات: واجهة برمجة التطبيقات node:module | (1) .2 - إصدار مرشح (نسخة غير متزامنة) الاستقرار: 1.1 - تطوير نشط (نسخة متزامنة) |
| الوحدات: وحدات CommonJS | (2) مستقر |
| الوحدات: TypeScript | (1) .1 - تطوير نشط |
| نظام التشغيل | (2) مستقر |
| مسار | (2) مستقر |
| واجهات برمجة تطبيقات قياس الأداء | (2) مستقر |
| Punycode | (0) مُهمل |
| سلسلة الاستعلام | (2) مستقر |
| قراءة سطر | (2) مستقر |
| REPL | (2) مستقر |
| تطبيقات قابلة للتنفيذ المفردة | (1) .1 - تطوير نشط |
| SQLite | (1) .1 - تطوير نشط. |
| بث | (2) مستقر |
| مشفر السلسلة | (2) مستقر |
| تشغيل الاختبار | (2) مستقر |
| عدادات الوقت | (2) مستقر |
| TLS (SSL) | (2) مستقر |
| أحداث التتبع | (1) تجريبي |
| TTY | (2) مستقر |
| منافذ UDP/datagram | (2) مستقر |
| عنوان URL | (2) مستقر |
| أداة | (2) مستقر |
| VM (تنفيذ جافا سكريبت) | (2) مستقر |
| واجهة برمجة التطبيقات Web Crypto | (2) مستقر |
| واجهة برمجة تطبيقات تيارات الويب | (2) مستقر |
| واجهة نظام WebAssembly (WASI) | (1) تجريبي |
| خيوط عامل | (2) مستقر |
| Zlib | (2) مستقر |
مُخرَج JSON
مُضاف في: v0.6.12
كلّ وثيقة .html لها وثيقة .json مُناظرة. هذا مخصص لبيئات التطوير المتكاملة (IDEs) والأدوات المساعدة الأخرى التي تستهلك الوثائق.
نداءات النظام وصفحات man
ستُوثّق دوال Node.js التي تُغلف نداء نظام ذلك. تربط الوثائق بصفحات man المُناظرة التي تصف كيفية عمل نداء النظام.
لِمعظم نداءات أنظمة يونكس نظائر في ويندوز. ومع ذلك، قد تكون اختلافات السلوك أمرًا لا مفر منه.