WebIDL回调定义中返回类型不匹配是否应抛出错误？

核心规则：WebIDL对回调返回值的宽松处理 #

WebIDL规范中明确了对回调函数返回值的处理策略：除非接口有强制要求，否则浏览器会静默忽略回调返回的不匹配值，不会抛出错误。这是为了保障Web平台的兼容性，避免开发者因无意的返回值导致代码崩溃。

场景1：NavigationInterceptHandler（navigate事件拦截回调） #

对应的IDL定义：

callback NavigationInterceptHandler = Promise<undefined> ();

• 若返回非Promise值：浏览器会自动将其包装为已决议的Promise（等价于Promise.resolve(返回值)），不会报错。
• 若返回Promise但最终结果非undefined：浏览器会静默忽略该结果，不会抛出错误。因为该回调的核心作用是告知浏览器拦截操作的完成状态，只要Promise完成决议，无论结果是什么，浏览器都判定操作已完成，无需校验结果内容。

示例代码（不会报错）：

navigation.addEventListener('navigate', (event) => {
  event.intercept({
    handler(){
      return "非Promise值"; // 会被包装为Promise.resolve("非Promise值")
      // 或 return Promise.resolve("非undefined结果"); // 结果会被忽略
    }
  });
});

场景2：FrameRequestCallback（requestAnimationFrame回调） #

对应的IDL定义：

callback FrameRequestCallback = undefined (DOMHighResTimeStamp time);

该回调的返回值被浏览器完全忽略，无论返回任何值（数字、对象、Promise等），都不会影响requestAnimationFrame的执行逻辑，也不会触发错误。因为这个回调的设计目的仅为在动画帧时机执行逻辑，返回值没有任何语义，规范要求浏览器直接丢弃返回值，不做类型校验。

示例代码（不会报错）：

requestAnimationFrame(function(){
  return 123; // 返回值被完全忽略
});

为什么不触发错误？ #

Web平台的设计原则之一是“容错性优先”，回调函数的返回值通常不属于核心逻辑的必填项，宽松处理返回值可以避免因开发者的小失误导致整个功能崩溃。只有当接口明确要求返回值必须符合特定类型（如某些同步API的返回值）时，才会抛出类型错误，而回调函数普遍采用静默兼容的处理方式。

内容的提问来源于stack exchange，提问作者MaximPro