ما هو SockJS؟

SockJS هي مكتبة JavaScript مفتوحة المصدر توفر واجهة برمجية تشبه WebSocket مع الرجوع الشفاف إلى آليات نقل بديلة عندما يكون WebSocket غير متاح. تم تصميمها للبيئات التي يتم فيها حظر اتصالات WebSocket — على سبيل المثال، بواسطة جدران الحماية الخاصة بالشركات أو المتصفحات القديمة أو موازنات التحميل التي لا تدعم ترقيات الاتصال. تتفاوض SockJS على أفضل نقل متاح تلقائياً، مختارة من بين WebSocket وبث HTTP والاستقصاء الطويل عبر HTTP وعدة آليات أخرى.

تتطلب SockJS مكتبة متوافقة على جانب الخادم (مثل SockJS-Node أو دعم SockJS من Spring) وتستخدم بروتوكول فرعي خاص بها، لذا لا يمكنها الاتصال بنقطة نهاية WebSocket عادية.

وصف الأداة

توفر هذه الأداة عميل SockJS قائم على المتصفح. أدخل عنوان URL لنقطة نهاية خادم SockJS، واتصل، وأنشئ رسائل نصية، وراقب جميع حركة المرور في سجل الرسائل المزود بطابع زمني. يتم عرض اسم النقل النشط (على سبيل المثال، websocket أو xhr-streaming أو xhr-polling) في الوقت الفعلي حتى تتمكن من رؤية آلية الرجوع التي اختارتها المكتبة.

الميزات

  • التفاوض التلقائي للنقل — يتصل بأفضل نقل متاح ويعرض أيها تم تحديده.
  • سجل الرسائل المباشر — يتم التقاط جميع الرسائل الواردة وأحداث الاتصال مع طوابع زمنية للفحص السهل.
  • أوضاع النص و JSON — اكتب الحمولات كنص عادي أو JSON منظم مع تمييز بناء الجملة والتحقق من الصحة.

شرح الخيارات

عنوان URL للخادم — عنوان URL لـ HTTP(S) لنقطة نهاية SockJS (على سبيل المثال، https://example.com/sockjs). لا تضف /websocket أو أي لاحقة نقل؛ تتعامل SockJS مع التفاوض على المسار داخلياً.

النقل — يتم عرضه في منطقة الإخراج بعد فتح الاتصال. تشمل القيم الشائعة websocket (نجحت الترقية المباشرة) و xhr-streaming (البث عبر XHR) و xhr-polling (الاستقصاء الطويل التقليدي). يبقى هذا الحقل فارغاً حتى يتم إنشاء الاتصال.

نوع البيانات — التبديل بين أوضاع إنشاء النص و JSON. يتحقق وضع JSON من صحة الحمولة قبل الإرسال.

التمرير التلقائي — يحافظ على سجل الرسائل مثبتاً على أحدث إدخال.

كيفية العمل

يستخدم العميل مكتبة SockJS JavaScript لفتح اتصال بالخادم المستهدف. تقوم SockJS بطلب معلومات إلى الخادم لاكتشاف النقل المدعوم، ثم تتفاوض على الخيار الأفضل. بمجرد الاتصال، تقوم الأداة بنقل جميع الرسائل الصادرة من خلال طريقة SockJS send وتسجل كل حدث onmessage يتم إرجاعه بواسطة الخادم.

نصائح

  • عادة ما تكشف خوادم SockJS عن نقطة النهاية الخاصة بها في مسار مثل /sockjs أو /ws. تحقق من توثيق الخادم للحصول على عنوان URL الأساسي الصحيح.
  • إذا أظهر النقل xhr-polling بدلاً من websocket، فقد يكون الخادم أو الوكيل يحظر ترقيات WebSocket.
  • SockJS غير متوافقة مع نقاط نهاية WebSocket العادية. استخدم عميل اختبار WebSocket لخوادم WebSocket القياسية.