حدث onmessage

التعريف والاستخدام

يحدث حدث onmessage عند استقبال رسالة عبر منبع الحدث (EventSource).

يدعم جسم حدث onmessage الخاصيات التالية:

  • data - تحتوي على الرسالة الفعلية
  • origin - عنوان URL للوثيقة التي يتم إطلاق الحدث منها
  • lastEventId - معرف آخر رسالة مرئية في تدفق الأحداث

الأحداث ذات الصلة:

  • onopen - يحدث عند فتح الاتصال بالخادم
  • onerror - يحدث عند ظهور مشكلة

للتعرف على إحداثات إرسال الخادم (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