Skip to content

[BUG] X 时间线上刷视频时反复弹出「视频元素未找到」toast(导航重挂载抢不到 video 元素) #2544

Open

Description

@KouriVar

Before you report

  • I have searched existing issues to avoid duplicates
  • I have tried with the latest available version (or can reproduce on latest)

Current vs. Expected behavior

在 x.com 正常浏览(首页时间线、帖子页)时会反复弹出红色 toast「视频元素未找到」,连刷时间线时几乎每次切换视频都弹一次。

  • 视频字幕的平台设置是「手动开启」,没有点过播放器里的陪读蛙按钮,也没有开「打开视频时自动开启」。
  • 这句文案不是 X 的,来自扩展:src/utils/subtitles/errors.ts 的 VideoNotFoundError(i18n key subtitles.errors.videoNotFound),只有 UniversalAdapter.initializeScheduler() 会抛:
const video = await waitForElement(
  this.config.selectors.video,
  (el) => !!el.closest(this.config.selectors.playerContainer),
)

if (this.isPlayerSuperseded(generation)) return
if (!video) {
  toastManager.add({ type: "error", title: i18n.t("subtitles.errors.videoNotFound") })
  return
}

期望:没主动开启字幕时不该出现这条错误;即使发生导航重挂载的竞态,也应该安静失败(参考 #2407 对 auto-start 的 quiet 处理),而不是每次切换视频都弹一次。

Snapzy_clipboard_D1FE8ABF-62ED-4CA1-B485-F4C8E49F1B15

To Reproduce

用户侧(可以稳定复现):

  1. Chrome(macOS)安装 1.60.1,设置 → 视频字幕 → 开启视频字幕 → X 选「手动开启」(所有平台都是手动,没开自动)
  2. 打开 x.com 首页时间线,向下滚动,鼠标会自然经过时间线里的视频
  3. 「当前视频」每变化一次就可能弹一次红色 toast「视频元素未找到」,连刷时连续弹

我这边用自动化试过、没能稳定复现(脚本用 open shadow root 轮询 toast 文案,如果 toast 真的渲染出来不会漏掉):

  • 时间线慢速/快速滚动,1200x1300 与 1100x820 两种视口
  • 在两个可见视频之间来回移动鼠标(pickActiveCandidate() 会优先 :hover 的视频)
  • 视频帖 → 站内跳到作者主页 / 其它帖子
  • 手动移除 article video 让容器消失(走到 null-container 分支)
  • 新标签直接打开带视频的 status 页再滚动

所以这条 issue 目前是「用户侧反复出现 + 代码路径明确,但开发者侧还没拿到稳定复现步骤」。需要的话我可以配合抓日志或按指定步骤复现。

Which area(s) are affected? (Select all that apply)

Browser Extension

Extension version (if applicable)

1.60.1

Provide environment information

- OS: macOS 27(Apple Silicon,MacBook Pro 14 寸)
- Browser: Chrome 156(Chromium 内核浏览器)
- Extension channel/version: 1.60.1(已是最新,2026-11-18 发布,没有更新可试)
- Website: https://x.com/home 以及单条 status 页面(例如 https://x.com/flarup/status/2123458217724506397),2026-11-20 多次观察到

Additional context

怀疑的竞态(X 平台)

X 的播放器没有稳定选择器,扩展自己盖属性来定位:

  1. ensureXcomOverlayEntryPoint() 给「当前挑中的视频」容器加上 data-read-frog-xcom-player-container="true",同时 clearStamps() 会把这个标记从其它容器上摘掉(platforms/xcom/overlay-entry.ts)。
  2. pickActiveCandidate() 优先返回 [data-testid='videoComponent']:hover 里的视频,所以鼠标在视频之间移动就会换标记;watchXcomPlayer() 是 document 级 MutationObserver(leading edge + 50ms debounce),时间线上任何 DOM 变化都会再调一次 syncEntryPoint()(init-xcom-subtitles.ts)。
  3. 容器变化 → remount() → adapter.notifyNavigation() → 1000ms(NAVIGATION_HANDLER_DELAY)后 handleNavigation() → attachPlayer() → initializeScheduler(),这时才用 [data-read-frog-xcom-player-container="true"] video 去找元素。
  4. 如果这 1 秒里标记被 clearStamps() 挪到别的容器、或者容器被 X 换掉/回收,waitForElement 拿到 null,就弹 videoNotFound。滚动时间线时这个时间窗很容易被踩到,所以表现为「连刷时一直弹」。

attachPlayer() 里已有 isPlayerSuperseded(generation) 的短路,但 playerGeneration 只在 reset/destroy 时递增,标记被挪走不会递增,挡不住这种竞态。

可能的修法(供参考)

  • 导航重挂载路径上把「等不到 video」当作正常情况静默返回(类似 QUIET_AUTO_START_PLATFORMS 的处理,只在用户手动点击/快捷键开启时才弹)。
  • 或者等待期间监听标记:一旦 data-read-frog-xcom-player-container 不再指向同一个容器就提前放弃,不弹 toast。

相关历史修复

#2407(auto-start 在 X 找不到字幕时保持安静)、#2444(X 视频找不到时说 videoNotFound 而不是 no subtitles)——这条错误路径在 1.58 之后对用户更显眼了。

Activity

  1. ananaBMaster commented on Nov 20, 2026

    @ananaBMaster
    Collaborator

    感谢反馈!也谢谢你排查得这么细,代码路径和竞态都分析得很清楚 🙏

    没有手动开启字幕的时候,确实不应该反复弹这个错误。我们已经在按你给的线索看了,有进展会在这里更新。需要抓日志的话再找你~

  2. ananaBMaster commented on Nov 20, 2026

    @ananaBMaster
    Collaborator

    已经复现了,修复在 #2545 👇

    原因:X 上当前跟随的那个视频被滚出页面、页面上又没有别的视频能接上时(鼠标没停在任何视频上,也没有在播放的),我们把它当成了一次「导航」。1 秒后重新挂载播放器,等了 10 秒没等到 video,就弹了「视频元素未找到」,大概在视频离开页面 12 秒后出现。这一步不管平台是不是「手动开启」都会走,所以你没开字幕也会看到。你怀疑的标记被挪走、容器被替换的竞态本身不会触发它,因为等待期间会一直重新查找,新容器也会被标上。这也是自动化脚本没复现出来的原因:移除视频时总还有别的视频能接上。

    现在改成按「离开」处理,旧视频的工作停掉,不再弹错误。Netflix 回到浏览页时也有同样的问题,一起修了。合并后会跟着下个版本发布。

    谢谢你分析得这么细,帮了大忙 🙏 有问题随时找我们~

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions