如何通过JavaScript检测YouTube iFrame API嵌入的不可用视频

我完全理解你现在的困扰——跨域安全限制堵死了直接读取iframe内部元素的路，而常规的onError事件又没覆盖所有“Video Unavailable”的场景。这里有几个基于YouTube IFrame API内置能力的解决方案，应该能帮你实现需求：

方案1：通过getVideoData()检查视频元数据 #

YouTube IFrame API提供了getVideoData()方法，能返回当前加载视频的标题、ID、时长等元数据。当视频不可用时，返回的title字段通常会是**"Video Unavailable"**（对应本地化语言的文本，比如中文是“视频不可用”），且duration大概率为0。

具体实现步骤：

1. 在播放器的onReady事件触发后，设置1-2秒的延迟（确保视频状态完全加载）。
2. 调用getVideoData()获取元数据，结合标题和时长判断视频是否可用。
3. 若判定为不可用，直接移除对应的iframe容器。

示例代码：

function onPlayerReady(event) {
  // 延迟执行，避免视频状态未完全更新
  setTimeout(() => {
    const videoData = event.target.getVideoData();
    const playerState = event.target.getPlayerState();
    
    // 双重判断：标题匹配不可用文本，或未初始化状态(-1)且无有效时长
    const isUnavailable = videoData.title.includes("Video Unavailable") || 
                          (playerState === -1 && videoData.duration === 0);
    
    if (isUnavailable) {
      // 移除包含iframe的父容器（根据你的DOM结构调整）
      event.target.getIframe().parentNode.remove();
    }
  }, 1500);
}

方案2：结合onStateChange事件与超时检查 #

有些不可用的视频会一直停留在未初始化状态(-1)，不会触发onError也不会切换到其他播放状态。你可以监听onStateChange事件，设置一个超时阈值，如果超过指定时间播放器仍处于未初始化状态，就判定为不可用。

示例代码：

let stateCheckTimer;

function onPlayerStateChange(event) {
  const player = event.target;
  const currentState = event.data;

  // 当进入未初始化状态时，启动超时检查
  if (currentState === -1) {
    stateCheckTimer = setTimeout(() => {
      const latestState = player.getPlayerState();
      const videoData = player.getVideoData();
      
      // 确认状态仍未更新，且标题匹配不可用文本
      if (latestState === -1 && videoData.title.includes("Video Unavailable")) {
        player.getIframe().parentNode.remove();
      }
    }, 3000); // 3秒超时，可根据实际情况调整
  } else {
    // 状态正常切换，清除超时定时器
    clearTimeout(stateCheckTimer);
  }
}

关键注意事项 #

• 多语言适配：如果你的网站服务多语言用户，需要提前收集对应语言的“视频不可用”文本（比如西班牙语是"Video no disponible"），再做匹配判断。
• API调用时机：必须在onReady事件触发后再调用API方法，否则会返回无效的空数据。
• 性能优化：不要设置过短的延迟或超时时间，避免频繁检查影响页面性能；同时记得及时清除定时器，防止内存泄漏。

这些方法完全基于YouTube IFrame API的公开接口，不会触发跨域限制，能覆盖绝大多数“Video Unavailable”的场景，比如视频被删除、私有、区域限制等。

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