رویداد onmessage

DOM ایوینٹ Event آوٹھوٹ

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

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

شیء رویداد 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/

آزادانه امتحان کنید

قوانین دستور زبان

اجسام.onmessage = function(){myScript};

آزادانه امتحان کنید

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

اجسام.addEventListener("message", myScript);

آزادانه امتحان کنید

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

جزئیات فنی

بول‌کن: نامعلوم
ممکن‌است: نامعلوم
事件类型： Event

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

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