حول هذه الوثائق
مرحبًا بك في وثائق مرجع API الرسمية لـ Node.js!
Node.js هو وقت تشغيل JavaScript مبني على محرك V8 JavaScript.
المساهمة
أبلغ عن الأخطاء في هذه الوثائق في متتبع المشكلات. راجع دليل المساهمة للحصول على إرشادات حول كيفية إرسال طلبات السحب.
مؤشر الاستقرار
توجد في جميع أنحاء الوثائق مؤشرات على استقرار القسم. بعض واجهات برمجة التطبيقات (APIs) مثبتة للغاية ويعتمد عليها لدرجة أنه من غير المحتمل أن تتغير على الإطلاق. البعض الآخر جديد تمامًا وتجريبي، أو من المعروف أنه خطر.
مؤشرات الاستقرار هي كما يلي:
[مستقر: 0 - مهمل]
مستقر: 0 الاستقرار: 0 - مهمل. قد تُصدر الميزة تحذيرات. التوافق مع الإصدارات السابقة غير مضمون.
[مستقر: 1 - تجريبي]
مستقر: 1 الاستقرار: 1 - تجريبي. لا تخضع الميزة لقواعد الترقيم الدلالي للإصدارات. قد تحدث تغييرات غير متوافقة مع الإصدارات السابقة أو إزالة في أي إصدار مستقبلي. لا يُنصح باستخدام الميزة في بيئات الإنتاج.
[مستقر: 2 - مستقر]
مستقر: 2 الاستقرار: 2 - مستقر. التوافق مع نظام npm البيئي له أولوية قصوى.
[مستقر: 3 - قديم]
مستقر: 3 الاستقرار: 3 - قديم. على الرغم من أنه من غير المحتمل إزالة هذه الميزة ولا تزال مشمولة بضمانات الترقيم الدلالي للإصدارات، إلا أنها لم تعد قيد الصيانة النشطة، وتتوفر بدائل أخرى.
يتم تمييز الميزات على أنها قديمة بدلاً من إهمالها إذا كان استخدامها لا يضر، ويعتمد عليها على نطاق واسع داخل نظام npm البيئي. من غير المحتمل إصلاح الأخطاء الموجودة في الميزات القديمة.
توخ الحذر عند استخدام الميزات التجريبية، خاصة عند تأليف المكتبات. قد لا يكون المستخدمون على دراية باستخدام الميزات التجريبية. قد تفاجئ الأخطاء أو تغييرات السلوك المستخدمين عند حدوث تعديلات على واجهة برمجة التطبيقات (API) التجريبية. لتجنب المفاجآت، قد يحتاج استخدام ميزة تجريبية إلى علامة سطر أوامر. قد تُصدر الميزات التجريبية أيضًا تحذيرًا.
نظرة عامة على الاستقرار
| API | الاستقرار |
|---|---|
| Assert | (2) مستقر |
| Async hooks | (1) تجريبي |
| Asynchronous context tracking | (2) مستقر |
| Buffer | (2) مستقر |
| Child process | (2) مستقر |
| Cluster | (2) مستقر |
| Console | (2) مستقر |
| Crypto | (2) مستقر |
| Diagnostics Channel | (2) مستقر |
| DNS | (2) مستقر |
| Domain | (0) مهمل |
| File system | (2) مستقر |
| HTTP | (2) مستقر |
| HTTP/2 | (2) مستقر |
| HTTPS | (2) مستقر |
| Inspector | (2) مستقر |
Modules: node:module API | (1) .2 - مرشح الإصدار (نسخة غير متزامنة) الاستقرار: 1.1 - تطوير نشط (نسخة متزامنة) |
| Modules: CommonJS modules | (2) مستقر |
| Modules: TypeScript | (1) .1 - تطوير نشط |
| OS | (2) مستقر |
| Path | (2) مستقر |
| Performance measurement APIs | (2) مستقر |
| Punycode | (0) مهمل |
| Query string | (2) مستقر |
| Readline | (2) مستقر |
| REPL | (2) مستقر |
| Single executable applications | (1) .1 - تطوير نشط |
| SQLite | (1) .1 - تطوير نشط. |
| Stream | (2) مستقر |
| String decoder | (2) مستقر |
| Test runner | (2) مستقر |
| Timers | (2) مستقر |
| TLS (SSL) | (2) مستقر |
| Trace events | (1) تجريبي |
| TTY | (2) مستقر |
| UDP/datagram sockets | (2) مستقر |
| URL | (2) مستقر |
| Util | (2) مستقر |
| VM (executing JavaScript) | (2) مستقر |
| Web Crypto API | (2) مستقر |
| Web Streams API | (2) مستقر |
| WebAssembly System Interface (WASI) | (1) تجريبي |
| Worker threads | (2) مستقر |
| Zlib | (2) مستقر |
JSON output
أُضيف في: v0.6.12
كل مستند .html لديه مستند .json مطابق له. هذا مخصص لبيئات التطوير المتكاملة (IDEs) والأدوات المساعدة الأخرى التي تستهلك الوثائق.
استدعاءات النظام وصفحات الدليل (man pages)
ستقوم دوال Node.js التي تغلف استدعاء نظام بتوثيق ذلك. ترتبط الوثائق بصفحات الدليل (man pages) المطابقة التي تصف كيفية عمل استدعاء النظام.
معظم استدعاءات نظام Unix لها نظائر في Windows. ومع ذلك، قد تكون اختلافات السلوك أمرًا لا مفر منه.