رخداد onmessage

تعریف و استفاده

رخداد onmessage رخ می‌دهد، وقتی که پیامی از طریق منبع رویداد دریافت می‌شود.

عنصر event در رخداد onmessage پشتیبانی از ویژگی‌های زیر را دارد:

  • data - شامل پیام واقعی
  • origin - URL مستند فراخوانی‌کننده‌ی رویداد
  • lastEventId - شناسه‌ی آخرین پیام دیده شده در جریان رویداد

رویدادهای مرتبط:

  • onopen - در هنگام باز شدن اتصال به سرور رخ می‌دهد
  • onerror - در هنگام بروز مشکل رخ می‌دهد

برای اطلاعات بیشتر در مورد سرورهای ارسال‌کننده‌ی رویدادها (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/

آزمایش کنید

زبان برنامه‌نویسی

object.onmessage = function(){myScript};

آزمایش کنید

استفاده از روش addEventListener():

object.addEventListener("message", myScript);

آزمایش کنید

توضیحات:اینترنت اکسپلورر 8 یا نسخه‌های قبلی از آن پشتیبانی نمی‌کند مетод addEventListener()

جزئیات فنی

بولب‌کن: نامعلوم
قابل‌اللغو: نامعلوم
ایونٹ کی نوعیت: ایونٹ

براوزر مدد

ایونٹ کی نوعیت کا شماراگر پہلے پورا مددگار براوزر کی نسلی تعداد میں دیا گیا ہے۔

ایونٹ کروم آئی ای فائرفاکس سافری آپریا
onmessage 9.0 نامعلوم 6.0 5.0 11.0