BroadcastChannel: messageerror event

Baseline 2022

Newly available

Since March 2022, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

messageerror 이벤트는 역직렬화할 수 없는 메시지가 채널에 도착할 시, BroadcastChannel 객체에서 발생합니다.

구문

addEventListener() 같은 메서드에서 이벤트 이름을 사용하거나, 이벤트 처리기 속성을 설정하세요.

js
addEventListener("messageerror", (event) => { })
onmessageerror = (event) => { }

이벤트 타입

MessageEvent. Event를 상속합니다.

Event MessageEvent

이벤트 속성

아래 나열된 속성 외에도, 부모 인터페이스인 Event의 속성들을 사용할 수 있습니다.

data (en-US) 읽기 전용

메시지 발신기가 보낸 데이터.

origin (en-US) 읽기 전용

메시지 발신기의 출처를 나타내는 문자열.

lastEventId (en-US) 읽기 전용

이벤트의 고유 ID를 나타내는 문자열.

source (en-US) 읽기 전용

WindowProxy, MessagePort (en-US), 또는 ServiceWorker 객체 등 메시지 발신자를 나타내는 메시지 이벤트 소스.

ports (en-US) 읽기 전용

메시지가 전송되는 채널과 연결된 포트를 나타내는 MessagePort (en-US) 객체의 배열(예: 채널 내 메시징, 공유된 맥락에 메시지를 보낼 때 등).

예제

이 코드는 메시지와 에러를 수신하기 위해 addEventListener를 사용합니다.

js
const channel = new BroadcastChannel("example-channel");

channel.addEventListener("message", (event) => {
  received.textContent = event.data;
});

channel.addEventListener("messageerror", (event) => {
  console.error(event);
});

위와 동일하지만, onmessage 와 onmessageerror 이벤트 핸들러 속성을 사용합니다.

js
const channel = new BroadcastChannel("example-channel");

channel.onmessage = (event) => {
  received.textContent = event.data;
};

channel.onmessageerror = (event) => {
  console.log(event);
};

명세서

Specification
HTML Standard
# event-messageerror
HTML Standard
# handler-broadcastchannel-onmessageerror

브라우저 호환성

BCD tables only load in the browser

같이 보기