حدث onmessage
التعريف والاستخدام
يحدث حدث onmessage عند استقبال رسالة عبر منبع الحدث (EventSource).
يدعم جسم حدث onmessage الخاصيات التالية:
- data - تحتوي على الرسالة الفعلية
- origin - عنوان URL للوثيقة التي يتم إطلاق الحدث منها
- lastEventId - معرف آخر رسالة مرئية في تدفق الأحداث
الأحداث ذات الصلة:
للتعرف على إحداثات إرسال الخادم (Server-Sent Events) بشكل أعمق، يُرجى دراسة دليل تعلم إحداثات إرسال الخادم (Server-Sent Events) في HTML5。
مثال
مثال 1
إنشاء جسم جديد من EventSource و تحديد عنوان URL للصفحة التي يتم إرسال التحديث منها.
سيحدث حدث onmessage في كل مرة يتم فيها استقبال تحديث. عند حدوث حدث onmessage، سيتم وضع البيانات المُستقبلة داخل عنصر <div> الذي يحمل id="myDIV":
var source = new EventSource("demo_sse.php"); source.onmessage = function(event) { document.getElementById("myDIV").innerHTML += event.data + "<br>"; };
مثال 2
الحصول على عنوان URL للوثيقة التي تُطلق فيها حدث onmessage:
var source = new EventSource("demo_sse.php"); source.onmessage = function(event) { document.getElementById("myDIV").innerHTML = event.origin; };
النتيجة ستكون:
https://www.codew3c.com/
النحو
الجسم.onmessage = function(){myScript};
استخدام طريقة addEventListener():
الجسم.addEventListener("message", myScript);
التعليقات:Internet Explorer 8 أو الإصدارات الأقدم لا تدعمها طريقة addEventListener()。
تفاصيل التقنية
التفجير: | لا يدعم |
---|---|
يمكن إلغاء التفعيل: | لا يدعم |
نوع الحدث: | Event |
دعم المتصفح
الرقم في الجدول يوضح إصدار المتصفح الذي يدعم هذا الحدث بشكل كامل.
أحداث | Chrome | IE | Firefox | Safari | Opera |
---|---|---|---|---|---|
onmessage | 9.0 | لا يدعم | 6.0 | 5.0 | 11.0 |