[Bug] Cannot read properties of undefined (reading 'group') in blurSeries during React re-render

オープン
#21,559 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
1/5
見積もり時間
1時間未満
初心者へのやさしさ
55/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
next.js, react, typescript

調査の方向性

src/util/states.ts の blurSeries から始め、view へのアクセスと toggleSeriesBlurState のガード付きアクセスを比較します。React の再レンダーと mouseover のシーケンスを再現し、破棄された series の view が TypeError なしでスキップされることを確認します。

索引モデルが issue の本文から書いたものです。

説明

en pending
Version

6.0.0

Link to Minimal Reproduction

N/A — race condition during React component re-render

Steps to Reproduce
  1. Render an ECharts chart (Sankey, Bar, Treemap) inside a React component
  2. Use notMerge: true with echarts-for-react
  3. Trigger a data change that causes React to re-render the chart (e.g., toggling filter buttons)
  4. While the chart is re-rendering, move the mouse over the chart area
Current Behavior

Runtime TypeError:

Cannot read properties of undefined (reading 'group')

Stack trace:

blurSeries (echarts/lib/util/states.js:362)
  → var view = api.getViewOfSeriesModel(seriesModel);
  → view.group.traverse(...)  // 💥 view is undefined

handleGlobalMouseOverForHighDown (states.js:499)
Handler.<anonymous> (echarts.js:1549)
Eventful.trigger (zrender/Eventful.js:103)
Handler.dispatchToElement (zrender/Handler.js:148)
Handler.mousemove (zrender/Handler.js:101)
HandlerDomProxy.mousemove (zrender/HandlerProxy.js:90)
HTMLDivElement.<anonymous> (zrender/HandlerProxy.js:209)
Expected Behavior

No crash. The blur effect should be skipped gracefully when the series view has been disposed.

Root Cause

In blurSeries() (src/util/states.ts), api.getViewOfSeriesModel(seriesModel) can return undefined when a series model still exists in the GlobalModel but its view has been disposed during a React re-render cycle (via setOption with notMerge or component unmount). The code unconditionally accesses view.group:

const view = api.getViewOfSeriesModel(seriesModel);
view.group.traverse(function (child) {  // ← crashes if view is undefined

This is the same class of bug as #9402 and #21535 — stale references to disposed series during mouse events.

Suggested Fix

Add a null guard after the view lookup:

const view = api.getViewOfSeriesModel(seriesModel);
if (!view || !view.group) {
    return;
}
view.group.traverse(function (child) {

This follows the same pattern used elsewhere in the codebase (e.g., toggleSeriesBlurState already guards view access).

I will submit a PR with this fix.

Environment
Item Value
OS macOS
Browser Chrome
Framework React 19 + Next.js 16
echarts-for-react 3.0.6
主要言語
TypeScript
スター
67.7k
フォーク
19.9k
PR マージ指標
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

apache/echarts のほかの issue

apache/echarts の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。