Repository navigation
Open
Labels
bugSomething isn't workingSomething isn't working
Description
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 keysubtitles.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 处理),而不是每次切换视频都弹一次。
To Reproduce
用户侧(可以稳定复现):
- Chrome(macOS)安装 1.60.1,设置 → 视频字幕 → 开启视频字幕 → X 选「手动开启」(所有平台都是手动,没开自动)
- 打开 x.com 首页时间线,向下滚动,鼠标会自然经过时间线里的视频
- 「当前视频」每变化一次就可能弹一次红色 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 的播放器没有稳定选择器,扩展自己盖属性来定位:
ensureXcomOverlayEntryPoint()给「当前挑中的视频」容器加上data-read-frog-xcom-player-container="true",同时clearStamps()会把这个标记从其它容器上摘掉(platforms/xcom/overlay-entry.ts)。pickActiveCandidate()优先返回[data-testid='videoComponent']:hover里的视频,所以鼠标在视频之间移动就会换标记;watchXcomPlayer()是 document 级 MutationObserver(leading edge + 50ms debounce),时间线上任何 DOM 变化都会再调一次syncEntryPoint()(init-xcom-subtitles.ts)。- 容器变化 →
remount()→adapter.notifyNavigation()→ 1000ms(NAVIGATION_HANDLER_DELAY)后handleNavigation()→attachPlayer()→initializeScheduler(),这时才用[data-read-frog-xcom-player-container="true"] video去找元素。 - 如果这 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 之后对用户更显眼了。
Metadata
Metadata
Assignees
Labels
bugSomething isn't workingSomething isn't working
Activity
ananaBMaster commentedon Nov 20, 2026
感谢反馈!也谢谢你排查得这么细,代码路径和竞态都分析得很清楚 🙏
没有手动开启字幕的时候,确实不应该反复弹这个错误。我们已经在按你给的线索看了,有进展会在这里更新。需要抓日志的话再找你~
ananaBMaster commentedon Nov 20, 2026
已经复现了,修复在 #2545 👇
原因:X 上当前跟随的那个视频被滚出页面、页面上又没有别的视频能接上时(鼠标没停在任何视频上,也没有在播放的),我们把它当成了一次「导航」。1 秒后重新挂载播放器,等了 10 秒没等到 video,就弹了「视频元素未找到」,大概在视频离开页面 12 秒后出现。这一步不管平台是不是「手动开启」都会走,所以你没开字幕也会看到。你怀疑的标记被挪走、容器被替换的竞态本身不会触发它,因为等待期间会一直重新查找,新容器也会被标上。这也是自动化脚本没复现出来的原因:移除视频时总还有别的视频能接上。
现在改成按「离开」处理,旧视频的工作停掉,不再弹错误。Netflix 回到浏览页时也有同样的问题,一起修了。合并后会跟着下个版本发布。
谢谢你分析得这么细,帮了大忙 🙏 有问题随时找我们~