Error.isError() — realm을 넘나드는 안전한 에러 검사 API

const iframe = document.createElement('iframe');
document.body.appendChild(iframe);
 
const IframeError = iframe.contentWindow.Error;
const err = new IframeError('iframe에서 생성된 에러');
 
console.log(err instanceof Error);        // false — 다른 realm의 Error
console.log(err instanceof IframeError);  // true — 같은 realm이므로 통과
console.log(err.message);                 // "iframe에서 생성된 에러" — 에러 자체는 정상

// realm을 가리지 않는다
const iframe = document.createElement('iframe');
document.body.appendChild(iframe);
 
const err = new iframe.contentWindow.Error('Oops!');
 
console.log(err instanceof Error);  // false
console.log(Error.isError(err));    // true
 
// 기본 동작
console.log(Error.isError(new Error('일반 에러')));              // true
console.log(Error.isError(new TypeError('타입 에러')));          // true
console.log(Error.isError(new RangeError('범위 에러')));         // true
 
// false 케이스
console.log(Error.isError('문자열'));                            // false
console.log(Error.isError({ message: '에러처럼 생긴 객체' }));    // false
console.log(Error.isError(null));                               // false

const fakeError = Object.create(Error.prototype);
fakeError.message = '나는 에러처럼 보인다';
 
console.log(fakeError instanceof Error);  // true — 프로토타입 체인 통과
console.log(Error.isError(fakeError));    // false — 브랜드 없음
 
// 커스텀 에러는 통과한다
class CustomError extends Error {}
const custom = new CustomError('커스텀 에러');
 
console.log(custom instanceof Error);    // true
console.log(Error.isError(custom));      // true

window.addEventListener('unhandledrejection', (event) => {
  const reason = event.reason;
 
  if (Error.isError(reason)) {
    reportError({
      type: reason.name,
      message: reason.message,
      stack: reason.stack,
    });
  } else {
    reportError({
      type: 'UnknownRejection',
      message: String(reason),
    });
  }
});

const worker = new Worker('worker.js');
 
worker.addEventListener('message', (event) => {
  const { error } = event.data;
 
  if (Error.isError(error)) {
    handleError(error);
  }
});

function isError(value) {
  if (typeof Error.isError === 'function') {
    return Error.isError(value);
  }
  return value instanceof Error;
}
 
console.log(isError(new TypeError('bad')));  // true
console.log(isError('not an error'));        // false

const vm = require('vm');
 
const err = vm.runInNewContext('new Error("vm에서 생성된 에러")');
 
console.log(err instanceof Error);  // false — 다른 realm
console.log(Error.isError(err));    // true (Node.js 24.3+)