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

آزمایش کنید

نحوه‌ی نوشتن

object.onmessage = function(){myScript};

آزمایش کنید

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

object.addEventListener("message", myScript);

آزمایش کنید

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

جزئیات فنی

بول‌آپ: پشتیبانی نمی‌شود
قابل‌لغیرفعال‌سازی: پشتیبانی نمی‌شود
نوع رویداد: Event

پشتیبانی مرورگر

اعداد در جدول نشان‌دهنده نسخه اولین مرورگری است که از این رویداد پشتیبانی می‌کند.

رویداد Chrome IE Firefox Safari Opera
onmessage 9.0 پشتیبانی نمی‌شود 6.0 5.0 11.0
رویدادهای DOM مجموعه Event