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

Đang mở
#21,559 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
1/5
Thời gian dự kiến
Dưới một giờ
Mức phù hợp với người mới
55/100
Loại issue
Lỗi
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Ít trao đổi

Hướng nghiên cứu

Bắt đầu trong src/util/states.ts tại blurSeries và so sánh cách truy cập view của nó với cách truy cập có bảo vệ trong toggleSeriesBlurState. Tái hiện chuỗi React re-render và mouseover, sau đó xác minh rằng view của một series đã bị loại bỏ được bỏ qua mà không xảy ra TypeError.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
TypeScript
Star
67.7k
Fork
19.9k
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của apache/echarts

Tất cả issue của apache/echarts

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.